Date: Tue, 3 Aug 1999 16:10:20 +0930 From: Greg Lehey <grog@lemis.com> To: Jeroen Ruigrok/Asmodai <asmodai@wxs.nl> Cc: Tim Vanderhoek <vanderh@ecf.utoronto.ca>, Mike Pritchard <mpp@mpp.pro-ns.net>, Bruce Evans <bde@zeta.org.au>, 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> In-Reply-To: <19990803083741.B58351@daemon.ninth-circle.org>; from Jeroen Ruigrok/Asmodai on Tue, Aug 03, 1999 at 08:37:41AM %2B0200 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990803161020.Z62948>