gene.heskett at verizon.net
Sun Mar 4 14:15:41 PST 2007
On Sunday 04 March 2007, Daniel Stone wrote:
>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
>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.
That has never worked here. Example:
[root at coyote ~]# man docbook-utils
No manual entry for docbook-utils
So where IS the bridge that will teach the user how to use it?
>So, I don't see any problem at all.
Obviously you are privy to the secret incantations to make it work. I
would like to join that club but my attempts to carve a working key have
so far, been both very frustrating, and an utter failure.
"There are four boxes to be used in defense of liberty:
soap, ballot, jury, and ammo. Please use in that order."
-Ed Howdershelt (Author)
Yahoo.com and AOL/TW attorneys please note, additions to the above
message by Gene Heskett are:
Copyright 2007 by Maurice Eugene Heskett, all rights reserved.
More information about the xorg