From owner-freebsd-doc@FreeBSD.ORG Fri Nov 5 17:40:32 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 2729816A4CE for ; Fri, 5 Nov 2004 17:40:32 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id EFC2343D54 for ; Fri, 5 Nov 2004 17:40:31 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id iA5HeV6N037431 for ; Fri, 5 Nov 2004 17:40:31 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id iA5HeVtH037430; Fri, 5 Nov 2004 17:40:31 GMT (envelope-from gnats) Date: Fri, 5 Nov 2004 17:40:31 GMT Message-Id: <200411051740.iA5HeVtH037430@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Peter Pentchev 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: Peter Pentchev List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 05 Nov 2004 17:40:32 -0000 The following reply was made to PR docs/42762; it has been noted by GNATS. From: Peter Pentchev To: AIDA Shinra Cc: bug-followup@FreeBSD.org, Brian Somers Subject: Re: docs/42762: ppp.8 has no description of $env and ~user expansion in ppp.conf Date: Fri, 5 Nov 2004 19:35:07 +0200 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.