[RFC] Changes file [was Re: modules directory]

From: Simon Huggins (huggie@earth.li)
Date: Sat Sep 09 2000 - 08:18:35 EST


On Thu, Sep 07, 2000 at 08:46:56AM +1100, Keith Owens wrote:
... and a few more times recent weeks ...

> <rant>
> Why don't you look in linux/Documentation/Changes? That file exist
> precisely to stop repeated questions like this on the linux kernel
> developers list.
> </rant>

Because the file just lists versions you need. It doesn't say "since
version x.y.z you need a newer version".

Why not make it easy on people and have a log something like:

2.4.0-testX-preY
        Requires modutils-x.y.z otherwise you get error messages like
        "blah blah blah"
        Note you should no longer frobnicate the thingummie or bad
        things will happen.
2.3.whatever_it_was
        You need to mount shm on blah.

Now when you tell them to read this file it sticks and *next time* they
look there too.
Why?
Because it's a hell of a lot easier to work out what has changed from
one version to the next.

It also means that people who ran earlier pre versions of 2.4 but didn't
upgrade in the mean time for one reason or another can find out what has
changed between the few versions of this file.

Stuff like the shm stuff and the modutils stuff has generated a fair bit
of traffic. Having a step by step Changelog style file would help
people get it right the first time.

Comments?

-- 
----------(  "Ah, here we are - `How to Raise the Dead.'" -  )----------
----------(                   Bart Simpson                   )----------
Simon ----(                                                  )---- Nomis
                             Htag.pl 0.0.15
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
Please read the FAQ at http://www.tux.org/lkml/



This archive was generated by hypermail 2b29 : Fri Sep 15 2000 - 21:00:12 EST