[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