docs/66505: escaping '~' and '$' characters in login.conf setenv or path capabilties doesn't work as documented

[Todd Miller]

>Number:         66505
>Category:       docs
>Synopsis:       escaping '~' and '$' characters in login.conf setenv or path capabilties doesn't work as documented
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon May 10 21:00:32 PDT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Todd Miller
>Release:        4.8 (though -current sources have the same issues)
>Organization:
>Environment:
>Description:
      login.conf(5) states that "Capabilities that set environment variables are scanned for both `~' and `$' characters, which are substituted for a user's home directory and name respectively.  To pass these characters literally into the environment variable, escape the character by preceding it with a backslash '\'.
>How-To-Repeat:
      Try escaping a ~ or $ in a setenv or path capability in login.conf or ~/.login_conf.
>Fix:
      Either remove the support for escaping the characters or document its deficiencies.
>Release-Note:
>Audit-Trail:
>Unformatted: