docs/87351: Jail building instructions don't work as described with default CSH shell

[Tom Rhodes]

On Mon, 24 Oct 2005 10:40:54 -0700
Brooks Davis <brooks at one-eyed-alien.net> wrote:

> On Sun, Oct 23, 2005 at 12:10:20AM +0000, Giorgos Keramidas wrote:
> > The following reply was made to PR docs/87351; it has been noted by GNATS.
> > 
> > From: Giorgos Keramidas <keramida at freebsd.org>
> > To: "Eli K. Breen" <bsd at unixforge.net>
> > Cc: freebsd-gnats-submit at freebsd.org
> > Subject: Re: docs/87351: Jail building instructions don't work as described with default CSH shell
> > Date: Sat, 22 Oct 2005 20:32:32 +0300
> > 
> >  On 2005-10-13 00:05, "Eli K. Breen" <bsd at unixforge.net> wrote:
> >  > Building jails does not work as perscribed in the man (8) jail
> >  > docs. The default shell for root on a new and stock FreeBSD box is
> >  > csh, the instruction include the line:
> >  >
> >  > D=/path/to/your/jail
> >  >
> >  > ..which does not work under csh, this returns a Command Not Found error.
> >  
> >  > switch to csh, try to build a jail using the supplied instructions
> >  > from the jail(8) manpage.
> >  
> >  > user at box# csh
> >  > user at box# D=/path/to/your/jail
> >  > D=/path/to/your/jail: Command not found.
> >  > user at box#
> >  
> >  > jail manpage currently reads:
> >  >
> >  >      D=/here/is/the/jail
> >  >      cd /usr/src
> >  >      mkdir -p $D
> >  >      make world DESTDIR=$D
> >  >      cd etc
> >  >      make distribution DESTDIR=$D
> >  >      mount_devfs devfs $D/dev
> >  >      cd $D
> >  >      ln -sf dev/null kernel
> >  >
> >  > ..and should read:
> >  >
> >  >      set D=/here/is/the/jail
> >  >      cd /usr/src
> >  >      mkdir -p $D
> >  >      make world DESTDIR=$D
> >  >      cd etc
> >  >      make distribution DESTDIR=$D
> >  >      mount_devfs devfs $D/dev
> >  >      cd $D
> >  >      ln -sf dev/null kernel
> >  >
> >  > .. or specify that the instructions do not work under csh.
> >  
> >  I'd certainly support adding a note that these commands work fine fror
> >  sh(1) and other Bourne shells.  Then we can probably add another set of
> >  commands for csh, if that seems nice to have.
> 
> Shell examples are traditionally in sh.  I'd really rather not see use
> bloat every instance of them with a csh example.  Users can always type
> "sh".

I'm inclined to agree with Brooks.

-- 
Tom Rhodes