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

From: Daniel Hazelton
Date: Sat Feb 02 2008 - 19:53:11 EST


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.
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/