GUACAMOLE-524: Added exmaples and links for attribute tokens
diff --git a/src/chapters/configuring.xml b/src/chapters/configuring.xml
index de25f7e..d0548ff 100644
--- a/src/chapters/configuring.xml
+++ b/src/chapters/configuring.xml
@@ -4042,6 +4042,10 @@
modules that implement the feature. There are an arbitrary
number of these tokens. If no attributes are specified
then this token does not exist.</para>
+ <para>For example, if an attribute name is specified as "mail" then a token would
+ be set as ${GUAC_ATTR_MAIL} with the value of "mail" in the authentication
+ module that "mail" is specified in. For a practical example, see
+ <property>ldap-user-attributes</property> in <xref linkend="ldap-auth"/>.</para>
</listitem>
</varlistentry>
</variablelist>
diff --git a/src/chapters/ldap-auth.xml b/src/chapters/ldap-auth.xml
index 58f9dbf..45e728d 100644
--- a/src/chapters/ldap-auth.xml
+++ b/src/chapters/ldap-auth.xml
@@ -368,6 +368,18 @@
If the attribute has multiple values in the LDAP directory then the token
saves the first value of the attribute. Multiple attributes can be
specified here, separated by commas.</para>
+ <para>For example, if <property>ldap-user-attributes</property> is
+ "<systemitem>mail, workstation</systemitem>", then a GUAC_ATTR_MAIL
+ token would be set to the value of the mail attribute in the LDAP directory
+ for the currently logged-in user and a GUAC_ATTR_WORKSTATION token
+ would be set to the value of the workstation attribute similarly,
+ contingent on the fact that the attributes have a value in the LDAP directory.
+ So, the tokens could be used like this:
+ <varname>${GUAC_ATTR_MAIL}</varname> or <varname>${GUAC_ATTR_WORKSTATION}/<varname>.
+ If the value of mail in the LDAP directory is "example@email.com" then
+ ${GUAC_ATTR_MAIL} would have the value "example@email.com".
+ Tokens usage is discussed more in <xref linkend="configuring-guacamole"/> in
+ <xref linkend="parameter-tokens"/>.</para>
</listitem>
</varlistentry>
<varlistentry>