Tweaks to make preprocessor documentation more reliable

gnustep · Oct 30, 2023 · 112c60b · 112c60b
1 parent 8a76128
commit 112c60b
Show file tree

Hide file tree

Showing 4 changed files with 169 additions and 230 deletions.
diff --git a/Headers/Foundation/NSNetServices.h b/Headers/Foundation/NSNetServices.h
@@ -224,18 +224,6 @@ GS_EXPORT NSString * const NSNetServicesErrorDomain;
 @end
 
 /**
- * <unit>
- *   <heading>
- *     NSNetServiceBrowserDelegate protocol description
- *   </heading>
- *   <p>
- *     <!-- Foreword -->
- *   </p>
- *   <unit />
- *   <p>
- *     <!-- Afterword -->
- *   </p>
- * </unit>
  * <p>
  *  This protocol must be adopted by any class wishing to implement
  *  an [NSNetServiceBrowser] delegate.
@@ -336,18 +324,6 @@ GS_EXPORT NSString * const NSNetServicesErrorDomain;
 
 
 /**
- * <unit>
- *   <heading>
- *     NSNetService class description
- *   </heading>
- *   <p>
- *     <!-- Foreword -->
- *   </p>
- *   <unit />
- *   <p>
- *     <!-- Afterword -->
- *   </p>
- * </unit>
  * <p>
  *   [NSNetService] lets you publish a network service in a domain using
  *   multicast DNS. Additionally, it lets you resolve a network service that
@@ -416,18 +392,6 @@ GS_EXPORT_CLASS
 @end
 
 /**
- * <unit>
- *   <heading>
- *     NSNetServiceBrowser class description
- *   </heading>
- *   <p>
- *     <!-- Foreword -->
- *   </p>
- *   <unit />
- *   <p>
- *     <!-- Afterword -->
- *   </p>
- * </unit>
  * <p>
  *   [NSNetServiceBrowser] asynchronously lets you discover network domains
  *   and, additionally, search for a type of network service. It sends its
@@ -473,18 +437,6 @@ GS_EXPORT_CLASS
 @end
 
 /**
- * <unit>
- *   <heading>
- *     NSNetServiceDelegate protocol description
- *   </heading>
- *   <p>
- *     <!-- Foreword -->
- *   </p>
- *   <unit />
- *   <p>
- *     <!-- Afterword -->
- *   </p>
- * </unit>
  * <p>
  *  This protocol must be adopted by any class wishing to implement
  *  an [NSNetService] delegate.

diff --git a/Headers/GNUstepBase/GSVersionMacros.h b/Headers/GNUstepBase/GSVersionMacros.h
@@ -1,4 +1,4 @@
-/* GSVersionMacros.h - macros for managing API versioning and visibility
+/** GSVersionMacros.h - macros for managing API versioning and visibility
    Copyright (C) 2006-2014 Free Software Foundation, Inc.
 
    Written by: Richard Frith-Macdonald <rfm@gnu.org>
@@ -148,18 +148,6 @@
  * four digit values (two digits for the major version, one for the minor,
  * and one for the subminor). 
  * </p>
- * <p>The Apple compatibility version macros are currently:
- * <ref type="macro" id="MAC_OS_X_VERSION_10_0">MAC_OS_X_VERSION_10_0</ref>,
- * <ref type="macro" id="MAC_OS_X_VERSION_10_1">MAC_OS_X_VERSION_10_1</ref>,
- * <ref type="macro" id="MAC_OS_X_VERSION_10_2">MAC_OS_X_VERSION_10_2</ref>,
- * <ref type="macro" id="MAC_OS_X_VERSION_10_3">MAC_OS_X_VERSION_10_3</ref>,
- * <ref type="macro" id="MAC_OS_X_VERSION_10_4">MAC_OS_X_VERSION_10_4</ref>,
- * <ref type="macro" id="MAC_OS_X_VERSION_10_5">MAC_OS_X_VERSION_10_5</ref>,
- * <ref type="macro" id="MAC_OS_X_VERSION_10_6">MAC_OS_X_VERSION_10_6</ref>,
- * <ref type="macro" id="MAC_OS_X_VERSION_10_7">MAC_OS_X_VERSION_10_7</ref>,
- * <ref type="macro" id="MAC_OS_X_VERSION_10_8">MAC_OS_X_VERSION_10_8</ref>
- * <ref type="macro" id="MAC_OS_X_VERSION_10_9">MAC_OS_X_VERSION_10_9</ref>
- * </p>
  */
 #define	OS_API_VERSION(ADD,REM) \
   (!defined(GS_OPENSTEP_V) \

diff --git a/Source/DocMakefile b/Source/DocMakefile
@@ -35,6 +35,7 @@ BaseAdditions_DOC_INSTALL_DIR = Developer
 
 Base_AGSDOC_FILES = \
 ../Documentation/Base.gsdoc \
+../GNUstepBase/GSVersionMacros.h \
 FoundationErrors.h \
 Foundation.h \
 FoundationLegacySwiftCompatibility.h \