DocBook help

[Joe Marcus Clarke]

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 at 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 at FreeBSD.org
FreeNode / #freebsd-gnome
http://www.FreeBSD.org/gnome
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 187 bytes
Desc: This is a digitally signed message part
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20031116/8d8fc721/attachment.sig>