docs/42762: ppp.8 has no description of $env and ~user expansion in ppp.conf
brian at FreeBSD.org
Thu Dec 16 16:00:53 UTC 2004
The following reply was made to PR docs/42762; it has been noted by GNATS.
From: Brian Somers <brian at FreeBSD.org>
To: Peter Pentchev <roam at ringlet.net>
Cc: AIDA Shinra <aida-s at jcom.home.ne.jp>, bug-followup at FreeBSD.org
Subject: Re: docs/42762: ppp.8 has no description of $env and ~user
expansion in ppp.conf
Date: Thu, 16 Dec 2004 15:50:56 +0000
Oops, lost in my inbox :( Sorry.
I guess there are three things to be described here.
$var - as described
~ - as described
~user - the home directory of ``user''.
Please feel free to commit when you can - after adding the last bit...
On Fri, 5 Nov 2004 19:35:07 +0200, Peter Pentchev <roam at ringlet.net> wrote:
> On Sat, Sep 14, 2002 at 11:10:55AM +0900, AIDA Shinra wrote:
> > >Number: 42762
> > >Category: docs
> > >Synopsis: ppp.8 has no description of $env and ~user expansion in ppp.conf
> > >Description:
> > ppp expands $env to corresponding environment variables, and ~user to their
> > home directory name reading any command lines in ppp.conf. However, ppp.8
> > doesn't explain this at all.
> > Without description of this feature, some trouble happens. For example,
> > authkey pa$ssword
> > is transformed info ' authkey pa'(if $ssword is undefined), and authentication
> > 'mysteriously' fails.
> > >How-To-Repeat:
> > >Fix:
> > Add proper description of '$', '~', and '/'.
> Sorry about the long delay; what do you think about the following
> patch, which documents the '$' and '~' characters? Does the '/'
> character have any special meaning?
> Index: src/usr.sbin/ppp/ppp.8.m4
> RCS file: /home/ncvs/src/usr.sbin/ppp/ppp.8.m4,v
> retrieving revision 1.312
> diff -u -r1.312 ppp.8.m4
> --- src/usr.sbin/ppp/ppp.8.m4 29 Jul 2004 05:59:43 -0000 1.312
> +++ src/usr.sbin/ppp/ppp.8.m4 5 Nov 2004 17:27:37 -0000
> @@ -812,6 +812,23 @@
> .Pq Dq \&: .
> A command line must contain a space or tab in the first column.
> +A string starting with the
> +.Dq $
> +character is substituted with the value of the environment variable by
> +the same name.
> +Likewise, a string starting with the
> +.Dq ~
> +character is substituted with the full path to the home directory of
> +the user account by the same name.
> +If you want to include a literal
> +.Dq $
> +.Dq ~
> +character in a command or argument, enclose them in double quotes, e.g.
> +.Bd -literal -offset indent
> +set password "pa$ss~word"
> Peter Pentchev roam at ringlet.net roam at cnsys.bg roam at FreeBSD.org
> PGP key: http://people.FreeBSD.org/~roam/roam.key.asc
> Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553
> This inert sentence is my body, but my soul is alive, dancing in the sparks of your brain.
Brian <brian at Awfulhak.org> <brian@[uk.]FreeBSD.org>
Don't _EVER_ lose your sense of humour !
More information about the freebsd-doc