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>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] 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: > > > > > > > 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. Yeah, that's fine. Thanks! Joe -- Joe Marcus Clarke FreeBSD GNOME Team :: gnome@FreeBSD.org FreeNode / #freebsd-gnome http://www.FreeBSD.org/gnome [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQA/t8HXb2iPiv4Uz4cRArplAJ49S/uuzmV9NhRzZpd7DTbVo5CoowCdHseI oXzHjbzjNKVQAn+EKV+Qur8= =zd0s -----END PGP SIGNATURE-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1069007319.3752.11.camel>