From owner-freebsd-doc@FreeBSD.ORG Thu Oct 27 23:29:35 2005 Return-Path: X-Original-To: freebsd-doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 379B716A41F; Thu, 27 Oct 2005 23:29:35 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (ns1.pittgoth.com [216.38.206.188]) by mx1.FreeBSD.org (Postfix) with ESMTP id D578943D46; Thu, 27 Oct 2005 23:29:34 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost (net-ix.gw.ai.net [205.134.160.6] (may be forged)) (authenticated bits=0) by pittgoth.com (8.13.4/8.13.4) with ESMTP id j9RNeAld060013 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 27 Oct 2005 19:40:10 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 27 Oct 2005 19:28:42 -0400 From: Tom Rhodes To: "Simon L. Nielsen" Message-Id: <20051027192842.5b62fa81.trhodes@FreeBSD.org> In-Reply-To: <200510261230.j9QCUMpb001943@freefall.freebsd.org> References: <200510261230.j9QCUMpb001943@freefall.freebsd.org> X-Mailer: Sylpheed version 1.0.5 (GTK+ 1.2.10; i386-portbld-freebsd7.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/87351: Jail building instructions don't work as described with default CSH shell X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 27 Oct 2005 23:29:35 -0000 On Wed, 26 Oct 2005 12:30:22 GMT "Simon L. Nielsen" wrote: > The following reply was made to PR docs/87351; it has been noted by GNATS. > > From: "Simon L. Nielsen" > To: Giorgos Keramidas > Cc: freebsd-gnats-submit@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