-----Original Message----- From: Alan Cox <[EMAIL PROTECTED]> To: Mark Symonds <[EMAIL PROTECTED]> Cc: [EMAIL PROTECTED] <[EMAIL PROTECTED]> 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 [EMAIL PROTECTED]
