From owner-freebsd-doc Sun Nov 8 04:48:23 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id EAA08977 for freebsd-doc-outgoing; Sun, 8 Nov 1998 04:48:23 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from megaweapon.zigg.com (megaweapon.zigg.com [206.114.60.8]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id EAA08960; Sun, 8 Nov 1998 04:48:19 -0800 (PST) (envelope-from matt@zigg.com) Received: from localhost (matt@localhost) by megaweapon.zigg.com (8.8.8/8.8.8) with SMTP id HAA01787; Sun, 8 Nov 1998 07:52:34 -0500 (EST) (envelope-from matt@zigg.com) Date: Sun, 8 Nov 1998 07:52:34 -0500 (EST) From: Matt Behrens To: doc@FreeBSD.ORG cc: "Jordan K. Hubbard" , Chad David , hackers@FreeBSD.ORG Subject: Re: Documentation (was Re: freebsd-hackers-digest V4 #299) In-Reply-To: <19981107213933.43220@nothing-going-on.org> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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 | 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