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

[Eli K. Breen]

>Number:         87351
>Category:       docs
>Synopsis:       Jail building instructions don't work as described with default CSH shell
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 13 00:10:18 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Eli K. Breen
>Release:        FreeBSD 5.4-RELEASE
>Organization:
UNIX|Forge Heavy Industries
>Environment:
FreeBSD cannon.activestate.com 5.4-RELEASE FreeBSD 5.4-RELEASE #0: Tue Aug 16 13:02:01 PDT 2005     root at cannon.activestate.com:/usr/obj/usr/src/sys/LONGSHOT_II  i386
>Description:
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.
>How-To-Repeat:
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#

>Fix:
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.
>Release-Note:
>Audit-Trail:
>Unformatted: