docs-v4: Intergrity check on condition.adoc - fix syntax, added truth table, wordsmithing

Author: nolade

doc/antora/modules/reference/pages/raddb/mods-config/files/users.adoc

@@ -280,7 +280,7 @@ In general, intermediate relative structural attributes should use `= {}`, as wi
 
 === Item Operators
 
-The list of comparison operators for check items is given in the xref:reference:unlang/condition/cmp.adoc[conditional comparisons] page.  However, the `users` file format does not support casting in a comparison.
+The list of comparison operators for check items is given in the xref:reference:unlang/condition/[conditional comparisons] page.  However, the `users` file format does not support casting in a comparison.
 
 As a special case for compatibility with previous versions, the `users` file also supports two additional comparison operators:
 
@@ -346,5 +346,5 @@ bob	NAS-IP-Address == 192.0.2.1, Password.Cleartext := "hello"
 	Framed-IP-Address := request.Framed-IP-Address
 ----
 
-// Copyright (C) 2023 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
+// Copyright (C) 2026 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
 // This documentation was developed by Network RADIUS SAS.

doc/antora/modules/reference/pages/unlang/condition/and.adoc

@@ -17,5 +17,5 @@ returns `true` is _condition-2_ evaluated and its result returned.
 if (User-Name && EAP-Message) { ...
 ----
 
-// Copyright (C) 2021 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
+// Copyright (C) 2026 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
 // This documentation was developed by Network RADIUS SAS.

doc/antora/modules/reference/pages/unlang/condition/cmp.adoc

@@ -32,8 +32,7 @@ The comparison operators are given below.
 |=====
 
 The comparison operators perform _type-specific_ comparisons.  The
-only exceptions are the xref:unlang/condition/regex.adoc[regular expression] operators,
-which interpret the `lhs` as a printable string, and the `rhs` as a
+only exceptions are the xref:unlang/condition/regex.adoc[regular expression] operators, which interpret the `lhs` as a printable string, and the `rhs` as a
 regular expression.
 
 Comparisons can be done across differing data types.  Comparng a `uint8` value to an `uint16` value will "just work", as the data types will be automatically converted before any comparison is done.
@@ -108,5 +107,5 @@ strings `00` and `0` are different.
 
 The `<cast>` syntax of version 3 is no longer supported.
 
-// Copyright (C) 2021 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
+// Copyright (C) 2026 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
 // This documentation was developed by Network RADIUS SAS.

doc/antora/modules/reference/pages/unlang/condition/index.adoc

@@ -115,5 +115,5 @@ In general, the following rules apply:
 
 * There is no longer a need to use `%{expr:..}` to do math in conditions.  Using the math in-place will work, as with `if (1 + 2 == 3)`.  See xref:unlang/condition/expression.adoc[expressions].
 
-// Copyright (C) 2023 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
+// Copyright (C) 2026 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
 // This documentation was developed by Network RADIUS SAS.

doc/antora/modules/reference/pages/unlang/condition/operands.adoc

@@ -11,8 +11,7 @@ integer
 ----
 
 Any text not matching xref:unlang/attr.adoc[Attribute-Name] or a
-xref:unlang/condition/return_codes.adoc[return code] is interpreted as a value for a
-particular xref:type/index.adoc[data type].
+xref:unlang/condition/return_codes.adoc[return code] is interpreted as a value for a particular xref:type/index.adoc[data type].
 
 Double-quoted strings and back-quoted strings are dynamically expanded
 before the condition is evaluated.  Single-quoted strings are static
@@ -26,12 +25,25 @@ For integer existence checks, `0` is `false`; all other values are `true`.
 For string existence checks, an empty string is `false`.  All other
 strings are `true`.
 
+.Data Types Truthiness
+[options=header, cols=autowidth]
+|===
+| *Type*                | *True When*
+| Bool	                | Value is true
+| String, octets        | Length > 0
+| Group	                | Has at least one element
+| Ipv4addr, ipv6addr	| Not INADDR_ANY (not 0.0.0.0 / ::)
+| Ipv4prefix, ipv6prefix| Not 0.0.0.0/0 or ::/0
+| Integers, float32, float64 | Cast to bool is true (non-zero)
+| Ifid, ethernet	| Cast to bool is true (non-zero)
+|===
+
 All other data types are disallowed in existence checks.
 
 .Examples
 
 `"hello there"` +
 `5`
 
-// Copyright (C) 2021 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
+// Copyright (C) 2026 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
 // This documentation was developed by Network RADIUS SAS.

doc/antora/modules/reference/pages/unlang/condition/or.adoc

@@ -14,8 +14,8 @@ is _condition-2_ evaluated and its result returned.
 .Examples
 [source,unlang]
 ----
-if (User-Name || NAS-IP-Address) { ...
+if (User-Name || NAS-IP-Address) { ... }
 ----
 
-// Copyright (C) 2021 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
+// Copyright (C) 2026 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
 // This documentation was developed by Network RADIUS SAS.

doc/antora/modules/reference/pages/unlang/condition/regex.adoc

@@ -220,6 +220,6 @@ multiple expressions operating on the same subject into a single expression
 using the PCRE alternation '|' operator.
 
 // Licenced under CC-by-NC 4.0.
-// Copyright (C) 2021 Network RADIUS SAS.
+// Copyright (C) 2026 Network RADIUS SAS.
 // Copyright (C) 2019 Arran Cudbard-Bell <a.cudbardb@freeradius.org>
 // This documentation was developed by Network RADIUS SAS.