From owner-freebsd-doc@FreeBSD.ORG Sun Feb 22 06:38:51 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4E49A1065672 for ; Sun, 22 Feb 2009 06:38:51 +0000 (UTC) (envelope-from minimarmot@gmail.com) Received: from wf-out-1314.google.com (wf-out-1314.google.com [209.85.200.171]) by mx1.freebsd.org (Postfix) with ESMTP id 22A818FC14 for ; Sun, 22 Feb 2009 06:38:51 +0000 (UTC) (envelope-from minimarmot@gmail.com) Received: by wf-out-1314.google.com with SMTP id 27so1606704wfd.7 for ; Sat, 21 Feb 2009 22:38:50 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :date:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=JFbWWFcGUPafo4AF3ulzWktMCsLcLby1nJpEAxKC/5Q=; b=Vhwsxxpno9vU+78MZm6XvQqkAOUJSRw4MfdtkXIPwfRmbuVg8EpElfaJ38syZUD8n0 EtRBgh6IU+aS7QubshB7ZfaQdOyucUsqVSJwGCt51PgpnjSR4V+NneDjtngfPFiefRyB iK4WOyi5HvUJ1hegkJvwp4+rUMY7hqYSNfUzk= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; b=L+yMerwlrmAkBzcq/abdAL1V1Y4lnM9wqHVAvxcMwMic6uNQ6WSwwy5rcOBg1R16CV JO6MAdviFGXgO1Zry1K26NYd0D3rVeErMZ1ohXXcb0gFA1iM75pBetDeYOpxw66WWabR AZL61P5KJvql+xk7yL0mSWbjkerY6xjA+nWJ0= MIME-Version: 1.0 Received: by 10.143.2.19 with SMTP id e19mr1304259wfi.96.1235283010879; Sat, 21 Feb 2009 22:10:10 -0800 (PST) In-Reply-To: <7731938b0902211810tfa5926dxf064041079fbe90c@mail.gmail.com> References: <7731938b0902211810tfa5926dxf064041079fbe90c@mail.gmail.com> Date: Sun, 22 Feb 2009 01:10:10 -0500 Message-ID: <47d0403c0902212210s634a21c4i913c05bbaaa7e8cb@mail.gmail.com> From: Ben Kaduk To: Peter Maxwell Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org Subject: Re: Omission in FreeBSD Handbook documentation (Jails/Application of) 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: Sun, 22 Feb 2009 06:38:51 -0000 On Sat, Feb 21, 2009 at 9:10 PM, Peter Maxwell wrote: > Hi, > > I've used the very useful guide at > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/jails-application.html > to setup multiple jails on a server, and have just realised there is a > possible ommission (or something that's just been glossed over) in the > guide. > > In section "15.6.1.4 Upgrading", it details how to perform an upgrade > and rebuild world for the jails. Unfortunately, the "skeleton" file > set that was described in "15.6.1.2 Creating the Template" isn't > referenced and the skeleton files remain unchanged (these are the > template files for /etc and such like in the jail, and probably should > be updated). > > Just thought that it should either be detailed, or warned about in the > docs. I don't know how they are edited, but if you wish, I'm willing > to do the amendments. Hi Peter, If you're serious about doing the amendments in the "most proper way", you can check out the FreeBSD Documentation Primer, here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html That will show you how to check out the sources for the FreeBSD documentation, and you can make your changes and see how they look, then submit a patch. Of course, that's a lot of work, and we don't expect that out of everyone! Feel free to just write up some text about how you think it should look, and submit a PR with it --- we can take care of the markup if you're not feeling up to it. Thanks, Ben Kaduk