mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-30 03:40:34 +02:00
Code Activity

Updated section about deprecating features.

Browse source
This commit is contained in:
Marius Vollmer 2001-05-02 22:55:33 +00:00
parent 1db8171ab3
commit 21d12a62e1
1 changed files with 19 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

28
HACKING
View file

@ -185,18 +185,28 @@ When deprecating a definition, always follow this procedure:
1. Mark the definition using 1. Mark the definition using
#if (SCM_DEBUG_DEPRECATED == 0) #if (SCM_DEBUG_DEPRECATED == 0)
... ...
#endif #endif
2. Write a comment at the definition explaining how a programmer or, for Scheme code, wrap it using
can manage without the deprecated definition.
3. Add an entry that the definition has been deprecated in NEWS (begin-deprecated
...)
4. At the top of RELEASE, there is a list of releases with reminders 2. Make the deprecated code issue a warning when it is used, by using
about what to do at each release. Add a reminder about the removal of scm_c_issue_deprecation_warning (in C) or issue-deprecation-warning
the deprecated defintion at the appropriate release. (in Scheme).
3. Write a comment at the definition explaining how a programmer can
manage without the deprecated definition.
4. Add an entry that the definition has been deprecated in NEWS and
explain what do do instead.
5. At the top of RELEASE, there is a list of releases with reminders
about what to do at each release. Add a reminder about the removal
of the deprecated defintion at the appropriate release.
- When you make a user-visible change (i.e. one that should be - When you make a user-visible change (i.e. one that should be
documented, and appear in NEWS, put an asterisk in column zero of the documented, and appear in NEWS, put an asterisk in column zero of the