Subject: Re: bin/7249 - slow down, take a deep breath...
To: Jim Reid <jim@rfc1035.com>
From: Tom Rushworth <tbr@mannynkapy.net>
List: tech-kern
Date: 07/18/2000 11:06:18
On Tue, Jul 18, 2000 at 11:43:06AM +0100, Jim Reid wrote:
> >>>>> "Mike" == Mike Cheponis <mac@Wireless.Com> writes:
[Many angry words obscuring a few ideas snipped.]

This is starting to get a lot more intense and personal than I
think it warrants.  People are starting to say things like
"you said use X" when Mike said no such thing - his original
post said:
    "stripped down lynx (or other specialized text-based
     browser".
(I'm quoting his _exact_ words here.)  His proposal is not totally
unreasonable - I don't like it, but it is _not_:
    "[An amazingly stupid and badly thought-out idea.]"
Searchable, properly linked documentation can be very useful, and is
a _possible_ solution to the original problem of documenting all
the error codes returned by various syscalls or library routines.

Instead of flaming away at each other, why don't we spend the time
profitably, by looking at the plan9 man2html, and seeing if it
really can solve the "too many error codes to document" problem
without a huge penalty?  That way, folks like me, who want to use
man, and are willing to use "SEE ALSO", can do so, and folks who
prefer to follow links can install the appropriate package (call it
manlynks :) ?), run the converter and live happily ever after.

If it's done with a converter the "links" people can fall back to
"man" when the system is too restricted or broken to support the
text browser.  Who knows, if the package is reliable, I might even
try it and like it :).

-- 
Tom Rushworth