[Top][All Lists]
[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’.