From: Terry Burton Date: Wed, 31 Jul 2019 19:37:24 +0000 (+0100) Subject: docs: Definitions and formatting X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=04e5fc16c1da94ff98cf357681871fa0d304da64;p=thirdparty%2Ffreeradius-server.git docs: Definitions and formatting Provide the permissible assignment operators are link to where they are defined. --- diff --git a/doc/unlang/map.adoc b/doc/unlang/map.adoc index a06ce3807af..ab1d362ee2d 100644 --- a/doc/unlang/map.adoc +++ b/doc/unlang/map.adoc @@ -22,20 +22,17 @@ database query which returns one or more fields. :: The server attribute which is assigned the value taken from the database query. -:: The operator such as `=`, `:=`, etc. - -:: The name of the field from the database. - -For SQL, the field names are usually column names. For LDAP, the -field names are usually LDAP attributes. - -The right hand side of the assignment is a field name, which should -generally be enclosed in single quotes. The single quotes prevent any -additional expansion of the __ value. - -When the right hand side is instead a double-quoted string, that -string is expanded dynamically. The resulting value is then taken as -the field name. +:: The operator such as `=`, `:=`, etc. Any +<> defined for an +link:update.adoc[update] statement is permissible. + +:: The name of the field from the database. For SQL, the field names are +usually column names. For LDAP, the field names are usually LDAP attributes. ++ +The __ value should generally be enclosed in single quotes which +prevents any additional expansion of the value. When the right hand side is +instead a double-quoted string, that string is expanded dynamically. The +resulting value is then taken as the field name. If the `map` fails for any reason, then all of the results are discarded, and the `map` does not affect any server attributes. For