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

[Tom Rhodes]

On Wed, 26 Oct 2005 12:30:22 GMT
"Simon L. Nielsen" <simon at freebsd.org> wrote:

> The following reply was made to PR docs/87351; it has been noted by GNATS.
> 
> From: "Simon L. Nielsen" <simon at FreeBSD.org>
> To: Giorgos Keramidas <keramida at freebsd.org>
> Cc: freebsd-gnats-submit at FreeBSD.org
> Subject: Re: docs/87351: Jail building instructions don't work as described with default CSH shell
> Date: Wed, 26 Oct 2005 14:22:30 +0200
> 
>  --GRPZ8SYKNexpdSJ7
>  Content-Type: text/plain; charset=us-ascii
>  Content-Disposition: inline
>  Content-Transfer-Encoding: quoted-printable
>  
>  On 2005.10.26 12:10:24 +0000, Giorgos Keramidas wrote:
>  
>  >  Alright then.  How about this change?
>  > =20
>  >  % Index: jail.8
>  >  % =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
>  =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
>  =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
>  >  % RCS file: /home/ncvs/src/usr.sbin/jail/jail.8,v
>  >  % retrieving revision 1.70
>  >  % diff -u -r1.70 jail.8
>  >  % --- jail.8      7 Aug 2005 20:53:29 -0000       1.70
>  >  % +++ jail.8      26 Oct 2005 12:03:42 -0000
>  >  % @@ -110,10 +110,11 @@
>  >  %  man page for further details.
>  >  %  .Sh EXAMPLES
>  >  %  .Ss "Setting up a Jail Directory Tree"
>  >  % -This example shows how to set up a jail directory tree
>  >  % -containing an entire
>  >  % +To set up a jail directory tree containing an entire
>  >  %  .Fx
>  >  % -distribution:
>  >  % +distribution, the following
>  >  % +.Xr sh 1
>  >  % +command script can be used:
>  >  %  .Bd -literal
>  >  %  D=3D/here/is/the/jail
>  >  %  cd /usr/src
>  > =20
>  >  This way the reader knows that this is an sh(1) command script.
>  
>  This looks like a good solution to me (and is similar to what I
>  suggested for the WIP Jail section for the Handbook).
>  
>  >  One may argue that people who are setting up jails are already admins
>  >  who should be able to understand if a script is meant to be run through
>  >  sh(1), csh(1) or even both, but I'll never stop being a fan of a little
>  >  more clarity :-)
>  
>  Well... :-).
>  

Perhaps if we put #!/bin/sh at the top of every full fledged
script, people would know.  :)

Hey, that's a one line change.  :)

-- 
Tom Rhodes