[ANNOUNCE] xorg-sgml-doctools-1.2

Daniel Stone daniel at fooishbar.org
Sun Mar 4 13:29:13 PST 2007


On Sun, Mar 04, 2007 at 04:15:13PM -0500, Gene Heskett wrote:
> On Sunday 04 March 2007, Daniel Stone wrote:
> >I can see you're not trying to be obnoxious, but are you honestly
> >arguing for manpages instead of DocBook as the raw format, on the
> >grounds of 'hard to remember syntax'?
>
> Yes Daniel.  Any format that takes 3 or more command line arguments, and 
> at least 2 separate incantations of disparate utilities just to do the 
> equ of a 'man name' is going to be extremely counterintuitive.  
> Particularly for a newbie, and I've been running linux since rh5.1 days.

Okay, and you're missing the point.  DocBook is _not_ the final format.
It is used to generate HTML, PDF, roff, etc.  You write documentation in
DocBook, and users type man whatever.

So, I don't see any problem at all.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
URL: <http://lists.x.org/archives/xorg/attachments/20070304/08e248ee/attachment.pgp>


More information about the xorg mailing list