[ANNOUNCE] xorg-sgml-doctools-1.2

[Daniel Stone]

On Sun, Mar 04, 2007 at 02:21:18PM -0500, Gene Heskett wrote:
> And I'll submit again, that the 'docbook' format was a solution looking 
> for a problem, but the docbook promoters have never realized that it IS 
> the problem.  I have all those tools, or did have before I freshly 
> installed FC6 about 4 months ago, configured according to the directions 
> I was able to wheedle from the mailing lists, and frankly no one seemed 
> to know much more than I did about this 'docbook' format of file, or how 
> to actually read it.  I have never been able to type the docbook equ of 
> a 'man someprogram' and get a readable screen out of it, even when trying 
> to give it every argument that made any sense at all on the cli.
> 
> I will stop denegrating this docbook flood of nonsense BS when I can 
> type 'docbook procmailrc' and read it, till then please give us simple, 
> easily read manpages.  Stop hiding the docs for this stuff behind an 
> impenetrable curtain of gobbledygook, far worse that trying to read an 
> html email as plaintext.

DocBook is not a format you read directly.  It can be converted into man
pages, HTML, PDF, whatever.  You can read those manpages, with man.  It
satisfies people looking for online, offline, and dead-tree
documentation.

At this stage, we haven't had any complaints from the people (person)
working on our documentation, so their word is the only thing that
counts.

Cheers,
Daniel
-------------- 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/a33131c4/attachment.pgp>