From owner-freebsd-doc@FreeBSD.ORG Sun Nov 16 10:28:44 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 2B99016A4CE; Sun, 16 Nov 2003 10:28:44 -0800 (PST) Received: from ms-smtp-02-eri0.southeast.rr.com (ms-smtp-02-lbl.southeast.rr.com [24.25.9.101]) by mx1.FreeBSD.org (Postfix) with ESMTP id AEDCA43FCB; Sun, 16 Nov 2003 10:28:42 -0800 (PST) (envelope-from marcus@FreeBSD.org) Received: from creme-brulee.marcuscom.com (rdu74-159-108.nc.rr.com [24.74.159.108])hAGISerp002912; Sun, 16 Nov 2003 13:28:40 -0500 (EST) Received: from [192.168.1.4] (shumai.marcuscom.com [192.168.1.4]) hAGIRLHE087605; Sun, 16 Nov 2003 13:27:21 -0500 (EST) (envelope-from marcus@FreeBSD.org) From: Joe Marcus Clarke To: Ken Smith In-Reply-To: <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> <20031116173729.GC5895@electra.cse.Buffalo.EDU> Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-4A+Px/0/EmevDsgZt5SE" Organization: FreeBSD, Inc. Message-Id: <1069007319.3752.11.camel@shumai.marcuscom.com> Mime-Version: 1.0 X-Mailer: Ximian Evolution 1.4.5 Date: Sun, 16 Nov 2003 13:28:39 -0500 X-Spam-Status: No, hits=-4.9 required=5.0 tests=BAYES_00 autolearn=ham version=2.60 X-Spam-Checker-Version: SpamAssassin 2.60 (1.212-2003-09-23-exp) on creme-brulee.marcuscom.com 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 18:28:44 -0000 --=-4A+Px/0/EmevDsgZt5SE Content-Type: text/plain Content-Transfer-Encoding: quoted-printable On Sun, 2003-11-16 at 12:37, Ken Smith wrote: > 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: > > >=20 > > > > 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 k= now I > > > > need some help. Anything you guys can do to improve the markup or = the > > > > readability would be greatly appreciated. Thanks. > > >=20 > > > Joe, > > >=20 > > > I only see a pgp sig and the original text in your email, could you > > > send the rest? > >=20 > > Bah, FreeBSD.org is at it again. This is better anyway: > >=20 > > http://www.marcuscom.com/downloads/cluster_article.sgml > >=20 >=20 > 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. >=20 > 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. >=20 > 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. Yeah, that's fine. Thanks! Joe --=20 Joe Marcus Clarke FreeBSD GNOME Team :: gnome@FreeBSD.org FreeNode / #freebsd-gnome http://www.FreeBSD.org/gnome --=-4A+Px/0/EmevDsgZt5SE Content-Type: application/pgp-signature; name=signature.asc Content-Description: This is a digitally signed message part -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQA/t8HXb2iPiv4Uz4cRArplAJ49S/uuzmV9NhRzZpd7DTbVo5CoowCdHseI oXzHjbzjNKVQAn+EKV+Qur8= =zd0s -----END PGP SIGNATURE----- --=-4A+Px/0/EmevDsgZt5SE--