jmuehlner commented on code in PR #264:
URL: https://github.com/apache/guacamole-manual/pull/264#discussion_r1809235107
##########
src/configuring-guacamole.md:
##########
@@ -2755,6 +2755,21 @@ supported:
`UPPER`
: Convert the entire value of the token to upper-case.
+`OPTIONAL`
+: Typically when tokens are specified as part of a connection parameter,
+ if the token is undefined, the literal value of the token will be placed
+ in the connection parameter. This modifier marks a token as "optional",
+ which means that an undefined token will not be added as a literal and
+ will simply be skipped as if the token is not entered.
+
+ In some cases this will simply result in a string lacking the information
+ that would otherwise be in the token; however, in other cases this may
+ result in Guacamole generating prompts. For example, if you specify the
+ token `${GUAC_PASSWORD}` for the password field in a connection, but you
+ sign in with an SSO extension such that the user does not have a
+ `${GUAC_PASSWORD}` token, Guacamole may prompt you for the password as
Review Comment:
Wouldn't this be `${GUAC_PASSWORD_OPTIONAL}`?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscr...@guacamole.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
