From owner-freebsd-doc@FreeBSD.ORG Sun Nov 16 09:37:32 2003 Return-Path: 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 25BA116A4CE; Sun, 16 Nov 2003 09:37:32 -0800 (PST) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1278843F75; Sun, 16 Nov 2003 09:37:31 -0800 (PST) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) hAGHbUus006597; Sun, 16 Nov 2003 12:37:30 -0500 (EST) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id hAGHbUSO006596; Sun, 16 Nov 2003 12:37:30 -0500 (EST) Date: Sun, 16 Nov 2003 12:37:29 -0500 From: Ken Smith To: Joe Marcus Clarke Message-ID: <20031116173729.GC5895@electra.cse.Buffalo.EDU> References: <1068365672.64416.2.camel@shumai.marcuscom.com> <20031109031918.40437858.trhodes@FreeBSD.org> <1068366438.64416.8.camel@shumai.marcuscom.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1068366438.64416.8.camel@shumai.marcuscom.com> User-Agent: Mutt/1.4.1i cc: Tom Rhodes cc: doc@freebsd.org Subject: Re: DocBook help X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 16 Nov 2003 17:37:32 -0000 On Sun, Nov 09, 2003 at 03:27:18AM -0500, Joe Marcus Clarke wrote: > On Sun, 2003-11-09 at 03:19, Tom Rhodes wrote: > > On Sun, 09 Nov 2003 03:14:33 -0500 > > Joe Marcus Clarke wrote: > > > > > O wizards of DocBook park, I need some help. With the help of Kris, > > > I've put together some instructions on how to build packages on the > > > build clusters. I've done my best to mark up the document, but I know I > > > need some help. Anything you guys can do to improve the markup or the > > > readability would be greatly appreciated. Thanks. > > > > Joe, > > > > I only see a pgp sig and the original text in your email, could you > > send the rest? > > Bah, FreeBSD.org is at it again. This is better anyway: > > http://www.marcuscom.com/downloads/cluster_article.sgml > I don't qualify as a docbook wizard yet but I am interested in learning more about the ports system so if the real wizards are busy with other things I'll take a first pass at this. I nabbed it this morning. One of the many valuable lessons I learned was that new documents should start off with lines ending at around column 70. This makes patching them during their lifetime easier, for various reasons related to the translation teams gratuitous line wrapping changes down the road are a problem. I'd like to address that now as well as a few other things but it means the best thing to do would probably be for me to just give you back the whole file when it's done - a patch might wind up being bigger than the file if I go through and wrap all the lines at around 70 colunms now. Is that OK? Once that's done maybe one of the real wizards can take a look at it to pick up anything I might have missed. -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel |