mirror of
https://github.com/gnustep/libs-base.git
synced 2025-05-30 08:21:25 +00:00
Improve documentation of GS_API_VERSION
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@23234 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
parent
52ec9c92ae
commit
06d6fd8a98
1 changed files with 9 additions and 0 deletions
|
@ -72,6 +72,15 @@
|
|||
* </p>
|
||||
* <p>Also see <ref type="macro" id="OS_API_VERSION">OS_API_VERSION</ref>
|
||||
* </p>
|
||||
* <p>NB. If you are changing the API (eg adding a new feature) you need
|
||||
* to control the visibility io the new header file code using<br />
|
||||
* <code>#if GS_API_VERSION(ADD,GS_API_LATEST)</code><br />
|
||||
* where <code>ADD</code> is the version number of the next minor
|
||||
* release after the most recent one.<br />
|
||||
* As a general principle you should <em>not</em> change the API with
|
||||
* changing subminor version numbers ... as that tends to confuse
|
||||
* people (though Apple has sometimes done it).
|
||||
* </p>
|
||||
*/
|
||||
#define GS_API_VERSION(ADD,REM) \
|
||||
(!defined(GS_GNUSTEP_V) || (GS_GNUSTEP_V >= ADD && GS_GNUSTEP_V < REM))
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue