Re: [PATCH] Improve Documentation/stable_api_nonsense.txt v2

[Daniel Hazelton <dhazelton@enter.net>]

On Saturday 02 February 2008 19:22:49 Greg KH wrote:
> On Sat, Feb 02, 2008 at 04:44:57PM +0200, Heikki Orsila wrote:
<snip>
> > @@ -145,6 +145,10 @@ as small as possible, and that all potential
> > interfaces are tested as well as they can be (unused interfaces are
> > pretty much impossible to test for validity.)
> >
> > +However, changing an interface can be delicate work and it can take
> > +significant amount of developer effort. Therefore, an interface is
> > +not changed unless the change is regarded as very important by the
> > +developers.
> >
> >  What to do
> >  ----------
>
> I still don't understand why you want to add these sentances.  Why are
> they needed?  Are people thinking that the kernel developers just
> randomly change things just because they are bored and have nothing else
> to do at the moment?  Do people think that our changes are gratuitous?
>
> Even so, I don't think this needs to be added, we have already stated
> many good reasons why changing apis are necessary and good.  Do need to
> add another one?
>
> thanks,
>
> greg k-h

Actually, Greg, a hell of a lot of people that don't track linux kernel 
development do think that way. And there are always going to be people that 
think that way.

As it stands the recommended paragraph does clarify that, while the interfaces 
aren't stable, can and will change as needed, there are some core interfaces 
that *WON'T* change without a very good reason. Having such a public 
statement that anyone can see and people can point to is another weapon to 
help people fight the FUD that exists around Linux.

DRH
(And yes, I do fight anti-linux FUD all the time. My parents have been using 
my laptops and can actually be quoted as saying that the next computer they 
buy will run Linux! My family mostly runs Windows - my brothers because their 
kids would complain about not being able to play their games and my sister 
because her husband is so computer illiterate I'm amazed he actually knows 
how to do a Google search)

-- 
Dialup is like pissing through a pipette. Slow and excruciatingly painful.