guile-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Deprecate vs. discourage


From: Ludovic Courtès
Subject: Re: Deprecate vs. discourage
Date: Thu, 28 Jan 2010 23:44:09 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux)

Hi Neil,

Neil Jerram <address@hidden> 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.

Good point.

OTOH, it may not be clear to a newcomer why some functions are available
(and not deprecated) yet undocumented.

Perhaps I should just stop worrying about these two functions.  ;-)

> I think we should use the formal deprecation mechanism for something
> when it becomes a burden (of any kind) for us to continue support that
> thing in the codebase, or when we have a good reason to believe that it
> will become a burden soon.
>
> Does that make sense?

Yes, it does.

Thanks,
Ludo’.





reply via email to

[Prev in Thread] Current Thread [Next in Thread]