Date: Wed, 18 Sep 2002 22:27:03 -0500 From: Chris Costello <chris@FreeBSD.org> To: Perforce Change Reviews <perforce@freebsd.org> Subject: Re: PERFORCE change 17681 for review Message-ID: <20020919032702.GA27220@holly.calldei.com> In-Reply-To: <200209182353.g8INrCwv014736@freefall.freebsd.org> References: <200209182353.g8INrCwv014736@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wednesday, September 18, 2002, Chris Costello wrote: > Here are a few points that should be made about this document: > o all relabel entry points are scattered, not under the right heading > o there were a few other grammar errors that have yet to be corrected > o every single entry point requires at least 26 lines of metadata > o Data is formatted in a suboptimal layout due to DocBook limitations > o on the current version, we're looking at hastily-written summaries > o catching-up needs to be done; this document is out of date > o Best thing to do after that is to mostly re-write each description > o over the next few weeks, I'll be carrying out those changes > o over the next few months, I'll decide whether or not I would like to > keep this document in the DocBook format, or possibly move it out As an alternative, I'm thinking about using the traditional ms(7) doc. format and sticking it in /usr/share/doc/papers, or possibly waiting for the DocBook XML bits to get adapted and create a custom stylesheet (.mac -> .docbook) to help clean up the markup, which is really quite messy IMHO. -- Chris Costello <chris@FreeBSD.org> FreeBSD Project http://www.FreeBSD.org/ TrustedBSD Project http://www.TrustedBSD.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe p4-projects" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020919032702.GA27220>