Date: Wed, 26 Oct 2005 12:10:24 GMT From: Giorgos Keramidas <keramida@freebsd.org> To: freebsd-doc@FreeBSD.org Subject: Re: docs/87351: Jail building instructions don't work as described with default CSH shell Message-ID: <200510261210.j9QCAOu8000903@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/87351; it has been noted by GNATS. From: Giorgos Keramidas <keramida@freebsd.org> To: Tom Rhodes <trhodes@freebsd.org> Cc: Brooks Davis <brooks@one-eyed-alien.net>, bug-followup@freebsd.org Subject: Re: docs/87351: Jail building instructions don't work as described with default CSH shell Date: Wed, 26 Oct 2005 15:05:54 +0300 On 2005-10-25 19:17, Tom Rhodes <trhodes@FreeBSD.org> wrote: >On Mon, 24 Oct 2005 10:40:54 -0700 >Brooks Davis <brooks@one-eyed-alien.net> wrote: >>On Sun, Oct 23, 2005 at 12:10:20AM +0000, Giorgos Keramidas wrote: >>> 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. Alright then. How about this change? % Index: jail.8 % =================================================================== % 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=/here/is/the/jail % cd /usr/src This way the reader knows that this is an sh(1) command script. 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 :-)
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200510261210.j9QCAOu8000903>