-----Original Message-----
From: Alan Cox <alan@lxorguk.ukuu.org.uk>
To: Mark Symonds <mark@symonds.net>
Cc: linux-net@vger.rutgers.edu <linux-net@vger.rutgers.edu>
Date: Monday, February 21, 2000 8:46 AM
Subject: Re: Worthless Without Documentation
>> been getting ridiculous. For example I installed OpenSSL
>> and the docs basically said "read the source". Lame.
>
>rpm --install OpenSSL*
>
>Thats how end users see it.
>
Using debian here so it was apt-get install ssleay. That was the
easy part.
>For the QoS stuff its right now at 'where is the config tool'
>
>Both are extremely complex subsystems. Both need a friendly interface,
>and in the QoS case explaining real QoS assumes a lot of mathematical
>background, so you really dont want to know if it works or how.
>
Agreed. But it is an impossible waste of time to even attempt
using if it doesn't have documentation. I like examples the best.
Also, users should not be expected to read C in order to get
something done. I know that for you it is easy, but for most of us
C is still an encrypted language. The comments aren't enough.
Software without documentation quickly flies into the unuseable
world, and software that is not useable is about as useful as
a hog in a whorehouse. :)
>For simple setups shaper is trivial and works well (someone has it
>doing DS3 now btw by using the rtc)
>
Looks like a great tool but I'm trying to use the new routing stuff
to route packets by source. I would like to have packets from
computer A go through interface one, and packets from computer B
go through interface two etc.
Don't get me wrong, when it comes to the cuff I'm very much there
for open source and free software. I guess I'm not as smart as most
guys on this list but I know that it's the right way. That said, could we
please get a documentation effort underway for 2.4? It is sorely needed
for the userspace. I mailed the list about this but didn't recv a response.
I'm willing to document everything myself and make all of the manpages
if need be. Let's just get it done, I'm sure it would take < week to get
something out there and put into the package if some real effort was
put into it.
-- Mark- To unsubscribe from this list: send the line "unsubscribe linux-net" in the body of a message to majordomo@vger.rutgers.edu
This archive was generated by hypermail 2b29 : Tue Feb 29 2000 - 21:00:27 EST