Date: Sun, 16 Nov 2003 13:28:39 -0500 From: Joe Marcus Clarke <marcus@FreeBSD.org> To: Ken Smith <kensmith@cse.Buffalo.EDU> Cc: doc@FreeBSD.org Subject: Re: DocBook help Message-ID: <1069007319.3752.11.camel@shumai.marcuscom.com> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
--=-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 <marcus@freebsd.org> 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1069007319.3752.11.camel>