Re: random thoughts on DEPRECATED and OBSOLETE

[Stefan Richter <stefanr@s5r6.in-berlin.de>]

Robert P. J. Day wrote:
> * deprecated:  while a feature is still supported, its use is
> discouraged because there is a better alternative that you should
> consider migrating to at your convenience.

IOW "discouraged, no {mid,long}-term commitment, alternative available,
supported"

> * obsolete:  while a feature is still in the tree, it is no longer
> supported and no one should need it anymore, and everyone *should* be
> using the better alternative at this point.

IOW "discouraged, no {mid,long}-term commitment, alternative available,
*un*supported"

Note, that's different from http://kerneltrap.org/node/7593 --- the
supported bit is new.  Why would I officially support what I deprecate?

Also, why don't we just adopt what "deprecated" and "obsolete" mean in
real life?  (English dictionaries say, one means "disapproved", the
other means "outdated" or "no longer in use".)  And if you don't find
these meanings applicable, other terms should be chosen whose
established meaning better matches what you want to express.

[...]
> there is an obvious timeline for features:
> 
>   normal -> deprecated -> obsolete

That wasn't clear (to me) from your earlier definitions.

IOW "normal" -> "obsolete and deprecated, phase 1" -> "obsolete and
deprecated, phase 2"  (using the real-life meanings of the terms here)

with the fine distinction that there is still support available in phase
1, however curious that is.

Besides, I find it unfeasible to divide a feature removal process into
two phases.  (I was involved in feature removals before and continue to
be involved in them.)

[...]
> in any event, i don't want to drag this out too much longer.

At least my pestering seems to lead to increasing precision in your
wordings.  And believe me, precision in a feature removal process is
valuable for each party involved.
-- 
Stefan Richter
-=====-=-=== -=-- ===-=
http://arcgraph.de/sr/
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/