indexing the docuentation? hmm...
On Thu, Apr 12, 2001 at 07:41:48PM +0100, Colin Watson wrote:
> For what it's worth, I think the existing man page framework is fine for
> this (but then I would say that). Sure, some man pages are useless, and
> a lot of them are specific to individual programs. A lot of them are
> general introductions to things as well. There's also info and the
> HOWTOs. If you want to put some effort into improving Linux's help
> system, your time would be a lot better spent working on writing code
> thet indexes all of these in a friendly way (there are already GUI
hmm. indexing the existing documentation ...
manpages
info
/usr/share/doc/*...*/*.html
howto's
is anybody pursuing something like this?
> frontends to man, and I'm sure the existing whatis/apropos indices could
> be levered into a nice graphical index) than coming up with yet another
> competing format that divides the effort yet more. Or, if you're no good
> at writing code, then write up your experiences for the rest of us! Good
> coders are often not so good at writing documentation.
there often is a tradeoff between algorithmic skills and
communication skills, yes...
--
americans should never read anything so subversive as what's at
http://www.salon.com/people/col/pagl/2001/03/21/spring/index1.html
will@serensoft.com
http://sourceforge.net/projects/newbiedoc -- we need your brain!
http://www.dontUthink.com/ -- your brain needs us!
Reply to: