From owner-freebsd-doc Mon Aug 2 23:41:10 1999 Delivered-To: freebsd-doc@freebsd.org Received: from allegro.lemis.com (allegro.lemis.com [192.109.197.134]) by hub.freebsd.org (Postfix) with ESMTP id AECE314E9A; Mon, 2 Aug 1999 23:40:52 -0700 (PDT) (envelope-from grog@freebie.lemis.com) Received: from freebie.lemis.com (freebie.lemis.com [192.109.197.137]) by allegro.lemis.com (8.9.1/8.9.0) with ESMTP id QAA28773; Tue, 3 Aug 1999 16:10:21 +0930 (CST) Received: (from grog@localhost) by freebie.lemis.com (8.9.3/8.9.0) id QAA64455; Tue, 3 Aug 1999 16:10:20 +0930 (CST) Date: Tue, 3 Aug 1999 16:10:20 +0930 From: Greg Lehey To: Jeroen Ruigrok/Asmodai Cc: Tim Vanderhoek , Mike Pritchard , Bruce Evans , rnordier@nordier.com, doc@freebsd.org, nik@freebsd.org Subject: Re: cvs commit: src/sbin/disklabel disklabel.8 Message-ID: <19990803161020.Z62948@freebie.lemis.com> References: <199908010038.KAA16506@godzilla.zeta.org.au> <199908011141.GAA02125@mpp.pro-ns.net> <19990803113759.J62948@freebie.lemis.com> <19990802225533.A19050@mad> <19990803083741.B58351@daemon.ninth-circle.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990803083741.B58351@daemon.ninth-circle.org>; from Jeroen Ruigrok/Asmodai on Tue, Aug 03, 1999 at 08:37:41AM +0200 WWW-Home-Page: http://www.lemis.com/~grog X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-41-739-7062 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tuesday, 3 August 1999 at 8:37:41 +0200, Jeroen Ruigrok/Asmodai wrote: > [ redirect to doc, add nik to cc: ] > > * Tim Vanderhoek (vanderh@ecf.utoronto.ca) [990803 07:13]: >> On Tue, Aug 03, 1999 at 11:37:59AM +0930, Greg Lehey wrote: >>>> >>>> Arghhhh! Man pages should never use direct *roff command for >>>> formatting. >>> >>> Why not? Because our forefathers did it that way? >> >> Because using strictly mdoc will make it easier to change all the >> manpages to DocBook? > > Now this is interesting. > > The advantage, at least in my perspective, is that mdoc is fast, can be > generated on the fly quickly with *roff and the markup is easy once you > get the hang of it [which is with all ML's]. > > DocBook on the other hand has a lot of dependencies which slow it down > to a degree where I am not sure simple on-the-fly creation will be > wanted. Remember that DocBook is a reference format. You could easily (in theory, anyway; just a SMOP) generate troff out of the docbook, just as you generate TeX and html at the moment. Greg -- See complete headers for address, home page and phone numbers finger grog@lemis.com for PGP public key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message