From owner-freebsd-doc@FreeBSD.ORG Thu Dec 16 16:00:53 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 301F316A4CE for ; Thu, 16 Dec 2004 16:00:53 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E750E43D41 for ; Thu, 16 Dec 2004 16:00:52 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id iBGG0qsE044161 for ; Thu, 16 Dec 2004 16:00:52 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.1/8.13.1/Submit) id iBGG0qJO044160; Thu, 16 Dec 2004 16:00:52 GMT (envelope-from gnats) Date: Thu, 16 Dec 2004 16:00:52 GMT Message-Id: <200412161600.iBGG0qJO044160@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Brian Somers Subject: Re: docs/42762: ppp.8 has no description of $env and ~user expansion in ppp.conf X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Brian Somers List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Dec 2004 16:00:53 -0000 The following reply was made to PR docs/42762; it has been noted by GNATS. From: Brian Somers To: Peter Pentchev Cc: AIDA Shinra , bug-followup@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... Cheers. On Fri, 5 Nov 2004 19:35:07 +0200, Peter Pentchev 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 > [snip] > > >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 \&: . > .It > A command line must contain a space or tab in the first column. > +.It > +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 $ > +or > +.Dq ~ > +character in a command or argument, enclose them in double quotes, e.g. > +.Bd -literal -offset indent > +set password "pa$ss~word" > +.Ed > .El > .Pp > The > > G'luck, > Peter > > -- > Peter Pentchev roam@ringlet.net roam@cnsys.bg roam@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 Don't _EVER_ lose your sense of humour !