On Tue, 23 Feb 1999 [EMAIL PROTECTED] wrote:
> > Let me clarify it then, there should be a document describing
> > what has changed between 2.0 and 2.2 and what effect it might
> > have. Expecting users to have studied the RFCs and to then compare
> > the source for 2.0 and 2.2 is not a suitable policy for a stable
> > kernel release!
>
> Mike, certainly, you are right. Only, unfortunately, there exist
> lots of much more improtant things which really require systematic
> documentation. If you would blame on poor documentation of new socket
> options, traffic control, policy routing...
I think user visible changes need to be documented *long* before
we start to worry about documenting new features. Right now the
tools people are long familiar with just won't let them do what
they want any more and there is no explanation why. Ifconfig
claims to support -broadcast, -pointopoint, metric. Route doesn't
display enough of the route attributes to allow people to debug
their suddenly non-working setups. It is a big problem for some.
> What's about documenting this feature, it is from area of FAQ. Until someone
> asked it (you are the first one, though age of this feature is ~2 years),
> it does not take sense to record it, because it is only one small piece
> of information. There are lots of such micro-differences.
A fine approach for development kernels but even-minor kernels
are generally presumed to be for the non-hacker masses and
these days are widely reported by the media as such. Many of
the people having problems don't read the newsgroups never mind
the mainling lists. As far as they are concerned they've followed
the available documentation, updated the packages listed as
needing updating - and their systems break.
We may *know* the new net code is "well cool" but the feedback
I am getting from users is that the 2.2 networking is "well fucked".
Mike
--
A train stops at a train station, a bus stops at a bus station.
On my desk I have a work station...
.----------------------------------------------------------------------.
| Mike Jagdis | Internet: mailto:[EMAIL PROTECTED] |
| Roan Technology Ltd. | |
| 54A Peach Street, Wokingham | Telephone: +44 118 989 0403 |
| RG40 1XG, ENGLAND | Fax: +44 118 989 1195 |
`----------------------------------------------------------------------'
-
To unsubscribe from this list: send the line "unsubscribe linux-net" in
the body of a message to [EMAIL PROTECTED]