mirror of
https://github.com/gnustep/libs-base.git
synced 2025-04-22 16:33:29 +00:00
Provide version macros in standalong headers
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@23800 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
Richard Frith-MacDonald
parent
48522ab8cd
commit
c7298649ac
2 changed files with 134 additions and 1 deletions
|
|
@ -75,6 +75,139 @@ NSAutoreleasePool *(X) = [NSAutoreleasePool new]
|
|||
|
||||
#define NSLocalizedStaticString(X, Y) X
|
||||
|
||||
|
||||
/*
|
||||
* Check consistency of definitions for system compatibility.
|
||||
*/
|
||||
#if defined(STRICT_OPENSTEP)
|
||||
#define GS_OPENSTEP_V 010000
|
||||
#define NO_GNUSTEP 1
|
||||
#elif defined(STRICT_MACOS_X)
|
||||
#define GS_OPENSTEP_V 100000
|
||||
#define NO_GNUSTEP 1
|
||||
#else
|
||||
#undef NO_GNUSTEP
|
||||
#endif
|
||||
|
||||
/*
|
||||
* NB. The version values below must be integers ... by convention these are
|
||||
* made up of two digits each for major, minor and subminor version numbers
|
||||
* (ie each is in the range 00 to 99 though a leading zero in the major
|
||||
* number is not permitted).
|
||||
* So for a MacOS-X 10.3.9 release the version number would be 100309
|
||||
*
|
||||
* You may define GS_GNUSTEP_V or GS_OPENSTEP_V to ensure that your
|
||||
* program only 'sees' the specified varsion of the API.
|
||||
*/
|
||||
|
||||
/**
|
||||
* <p>Macro to check a defined GNUstep version number (GS_GNUSTEP_V) against
|
||||
* the supplied arguments. Returns true if no GNUstep version is specified,
|
||||
* or if ADD <= version < REM, where ADD is the version
|
||||
* number at which a feature guarded by the macro was introduced and
|
||||
* REM is the version number at which it was removed.
|
||||
* </p>
|
||||
* <p>The version number arguments are six digit integers where the first
|
||||
* two digits are the major version number, the second two are the minor
|
||||
* version number and the last two are the subminor number (all left padded
|
||||
* with a zero where necessary). However, for convenience you can also
|
||||
* use any of several predefined constants ...
|
||||
* <ref type="macro" id="GS_API_NONE">GS_API_NONE</ref>,
|
||||
* <ref type="macro" id="GS_API_LATEST">GS_API_LATEST</ref>,
|
||||
* <ref type="macro" id="GS_API_OSSPEC">GS_API_OSSPEC</ref>,
|
||||
* <ref type="macro" id="GS_API_OPENSTEP">GS_API_OPENSTEP</ref>,
|
||||
* <ref type="macro" id="GS_API_MACOSX">GS_API_MACOSX</ref>
|
||||
* </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))
|
||||
|
||||
/**
|
||||
* <p>Macro to check a defined OpenStep/OPENSTEP/MacOS-X version against the
|
||||
* supplied arguments. Returns true if no version is specified, or if
|
||||
* ADD <= version < REM, where ADD is the version
|
||||
* number at which a feature guarded by the macro was introduced and
|
||||
* REM is the version number at which it was removed.
|
||||
* </p>
|
||||
* <p>The version number arguments are six digit integers where the first
|
||||
* two digits are the major version number, the second two are the minor
|
||||
* version number and the last two are the subminor number (all left padded
|
||||
* with a zero where necessary). However, for convenience you can also
|
||||
* use any of several predefined constants ...
|
||||
* <ref type="macro" id="GS_API_NONE">GS_API_NONE</ref>,
|
||||
* <ref type="macro" id="GS_API_LATEST">GS_API_LATEST</ref>,
|
||||
* <ref type="macro" id="GS_API_OSSPEC">GS_API_OSSPEC</ref>,
|
||||
* <ref type="macro" id="GS_API_OPENSTEP">GS_API_OPENSTEP</ref>,
|
||||
* <ref type="macro" id="GS_API_MACOSX">GS_API_MACOSX</ref>
|
||||
* </p>
|
||||
* <p>Also see <ref type="macro" id="GS_API_VERSION">GS_API_VERSION</ref>
|
||||
* </p>
|
||||
*/
|
||||
#define OS_API_VERSION(ADD,REM) \
|
||||
(!defined(GS_OPENSTEP_V) || (GS_OPENSTEP_V >= ADD && GS_OPENSTEP_V < REM))
|
||||
|
||||
/**
|
||||
* A constant which is the lowest possible version number (0) so that
|
||||
* when used as the removal version (second argument of the GS_API_VERSION
|
||||
* or OS_API_VERSION macro) represents a feature which is not present in
|
||||
* any version.<br />
|
||||
* eg.<br />
|
||||
* #if <ref type="macro" id="OS_API_VERSION">OS_API_VERSION</ref>
|
||||
* (GS_API_NONE, GS_API_NONE)<br />
|
||||
* denotes code not present in OpenStep/OPENSTEP/MacOS-X
|
||||
*/
|
||||
#define GS_API_NONE 0
|
||||
|
||||
/**
|
||||
* A constant to represent a feature which is still present in the latest
|
||||
* version. This is the highest possible version number.<br />
|
||||
* eg.<br />
|
||||
* #if <ref type="macro" id="OS_API_VERSION">OS_API_VERSION</ref>
|
||||
* (GS_API_MACOSX, GS_API_LATEST)<br />
|
||||
* denotes code present from the initial MacOS-X version onwards.
|
||||
*/
|
||||
#define GS_API_LATEST 999999
|
||||
|
||||
/**
|
||||
* The version number of the initial OpenStep specification.<br />
|
||||
* eg.<br />
|
||||
* #if <ref type="macro" id="OS_API_VERSION">OS_API_VERSION</ref>
|
||||
* (GS_API_OSSPEC, GS_API_LATEST)<br />
|
||||
* denotes code present from the OpenStep specification onwards.
|
||||
*/
|
||||
#define GS_API_OSSPEC 10000
|
||||
|
||||
/**
|
||||
* The version number of the first OPENSTEP implementation.<br />
|
||||
* eg.<br />
|
||||
* #if <ref type="macro" id="OS_API_VERSION">OS_API_VERSION</ref>
|
||||
* (GS_API_OPENSTEP, GS_API_LATEST)<br />
|
||||
* denotes code present from the initial OPENSTEP version onwards.
|
||||
*/
|
||||
#define GS_API_OPENSTEP 40000
|
||||
|
||||
/**
|
||||
* The version number of the first MacOS-X implementation.<br />
|
||||
* eg.<br />
|
||||
* #if <ref type="macro" id="OS_API_VERSION">OS_API_VERSION</ref>
|
||||
* (GS_API_MACOSX, GS_API_LATEST)<br />
|
||||
* denotes code present from the initial MacOS-X version onwards.
|
||||
*/
|
||||
#define GS_API_MACOSX 100000
|
||||
|
||||
#else
|
||||
#include <Foundation/NSObject.h>
|
||||
#endif /* GNUSTEP */
|
||||
|
||||
#endif /* __GNUSTEP_GNUSTEP_H_INCLUDED_ */
|
||||
|
|
|
|||
|
|
@ -37,9 +37,9 @@
|
|||
extern "C" {
|
||||
#endif
|
||||
|
||||
#if GS_API_VERSION(GS_API_NONE,011500)
|
||||
@class NSArray;
|
||||
@class NSString;
|
||||
#if GS_API_VERSION(GS_API_NONE,011500)
|
||||
/**
|
||||
* Try to locate file/directory (aName).(anExtension) in paths.
|
||||
* Will return the first found or nil if nothing is found.
|
||||
|
|
|
|||
Loading…
Reference in a new issue