Re: Deprecate vs. discourage

2010-01-28 Thread Andy Wingo
Hi, On Thu 28 Jan 2010 22:28, Neil Jerram writes: > I favour dropping discouraged and only having deprecated. I'm OK with this as well, FWIW. Andy -- http://wingolog.org/

Re: Deprecate vs. discourage

2010-01-28 Thread Ludovic Courtès
Hi Neil, Neil Jerram writes: > If something like uniform-vector-xxx stops being the recommended > approach, but remains trivial for us to support in the codebase, I think > it is enough `discouragement' just to remove it from the manual. That > will make it less likely to be used in new code.

Re: Deprecate vs. discourage

2010-01-28 Thread Neil Jerram
l...@gnu.org (Ludovic Courtès) writes: > Hi Neil, > > Neil Jerram writes: > >> l...@gnu.org (Ludovic Courtès) writes: >> >>> That’s what had been done for these functions but libguile also supports >>> ‘discouraged’ features. >> >> I never really saw the case for two levels of deprecation >> (i.e

Re: Deprecate vs. discourage

2010-01-28 Thread Ludovic Courtès
Hi Neil, Neil Jerram writes: > l...@gnu.org (Ludovic Courtès) writes: > >> That’s what had been done for these functions but libguile also supports >> ‘discouraged’ features. > > I never really saw the case for two levels of deprecation > (i.e. `discouraged' and `deprecated'). I thought `deprec

Re: Deprecate vs. discourage

2010-01-28 Thread Neil Jerram
Greg Troxel writes: > Given the history of guile, I suspect that in some number of years a > feature that has been discouraged will get moved to deprecated, and then > removed. So the question is really what kind of commitment there is to > API/ABI stability, and I don't think there is much. AP

Re: Deprecate vs. discourage

2010-01-28 Thread Neil Jerram
l...@gnu.org (Ludovic Courtès) writes: > That’s what had been done for these functions but libguile also supports > ‘discouraged’ features. I never really saw the case for two levels of deprecation (i.e. `discouraged' and `deprecated'). I thought `deprecated' on its own was enough. When depreca

Re: Deprecate vs. discourage

2010-01-27 Thread Ludovic Courtès
Hi, Grant Rettke writes: > On Tue, Jan 26, 2010 at 4:15 PM, Ludovic Courtès wrote: >> What do you think? > > You might move said functions to a "deprecated" module. That’s what had been done for these functions but libguile also supports ‘discouraged’ features. Thanks, Ludo’.

Re: Deprecate vs. discourage

2010-01-27 Thread Grant Rettke
On Tue, Jan 26, 2010 at 4:15 PM, Ludovic Courtès wrote: > What do you think? You might move said functions to a "deprecated" module. It is minimal hassle to the user (admittedly more so than what you explained), self-documenting, and ultimately makes it easier for everyone because you could set

Re: Deprecate vs. discourage

2010-01-27 Thread Greg Troxel
l...@gnu.org (Ludovic Courtès) writes: > I think things like ‘uniform-vector-read’ should be discouraged rather > than deprecated, since it matches the definition in ‘discouraged.h’: > >A discouraged feature is one that shouldn't be used in new code >since we have a better alternative now

Re: Deprecate vs. discourage

2010-01-26 Thread Andy Wingo
Hej, On Tue 26 Jan 2010 23:15, l...@gnu.org (Ludovic Courtès) writes: > I think things like ‘uniform-vector-read’ should be discouraged rather > than deprecated, since it matches the definition in ‘discouraged.h’: > >A discouraged feature is one that shouldn't be used in new code >since w