Date: Sun, 8 Nov 1998 07:52:34 -0500 (EST) From: Matt Behrens <matt@zigg.com> To: doc@FreeBSD.ORG Cc: "Jordan K. Hubbard" <jkh@time.cdrom.com>, Chad David <davidc@acns.ab.ca>, hackers@FreeBSD.ORG Subject: Re: Documentation (was Re: freebsd-hackers-digest V4 #299) Message-ID: <Pine.BSF.4.02A.9811080742200.1770-100000@megaweapon.zigg.com> In-Reply-To: <19981107213933.43220@nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, 7 Nov 1998, Nik Clayton wrote: > Absolutely. DocBook is designed for exactly that sort of technical > documentation. In fact, Someone on -doc recently made the suggestion > that we shift the manual pages from *roff format to DocBook. That's > possibly a touch too controversial at the moment, but might not be > beyond the bounds of possiblity for the medium term future. > > In fact, it might be worth doing that within the Doc. Project, treating > them as another translation (similar to the Japanese translation) of > the manual pages? The approach I think that could be taken for the manpages is not necessarily to treat DocBook as a translation but as the _source_ for all the other translations, including the *roff that could still be used (for efficiency's and compatibility's sake) on the actual system. I would require quite a bit of initial investment but would really pay off when our handbook would come attached to and be able to cross-reference within itself to all of our standard manpages. Matt Behrens <matt@zigg.com> | If only I could learn Japanese and get my Servant of Karen Behrens | hands on all 200 Sailor Moon episodes and Engineer, Nameless IRC Network | all the movies, I think my life would I eat Penguins for breakfast. | finally be complete. . . . . . . . . . . To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.4.02A.9811080742200.1770-100000>