commit fca8c5ddb87bd81798e2a190f6be391e2965fd6d
author Dmitry Baryshkov <dbaryshkov@gmail.com> Wed May 06 19:46:05 2020 +0300
committer Dmitry Baryshkov <dbaryshkov@gmail.com> Wed May 06 19:46:05 2020 +0300
tree e60f1aa417b150ee2cc27407988bd3110acb86a3
parent 78994fa52a018708977d7f77d402f38660525d39

doc/reference: hide deprecated symbols

Put ASN1_DISABLE_DEPRECATED guards around deprecated symbols to stop
gtkdoc-scan from complaining.

Fixes #20

Signed-off-by: Dmitry Baryshkov <dbaryshkov@gmail.com>

doc/reference/Makefile.am

diff --git a/doc/reference/Makefile.am b/doc/reference/Makefile.am
index 9b77ad3..3b65776 100644
--- a/doc/reference/Makefile.am
+++ b/doc/reference/Makefile.am
@@ -49,7 +49,7 @@
 
 # Extra options to supply to gtkdoc-scan.
 # e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
-SCAN_OPTIONS=--ignore-decorators=ASN1_API
+SCAN_OPTIONS=--ignore-decorators=ASN1_API --deprecated-guards="ASN1_DISABLE_DEPRECATED"
 
 # Extra options to supply to gtkdoc-mkdb
 # e.g. MKDB_OPTIONS=--xml-mode --output-format=xml

lib/includes/libtasn1.h.in

diff --git a/lib/includes/libtasn1.h.in b/lib/includes/libtasn1.h.in
index fa10718..66357de 100644
--- a/lib/includes/libtasn1.h.in
+++ b/lib/includes/libtasn1.h.in
@@ -507,11 +507,13 @@
  *
  * Deprecated: 3.0: Use #asn1_node instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define node_asn_struct _Pragma ("GCC warning \"'node_asn_struct' macro is deprecated, use 'asn1_node' instead.\"") asn1_node_st
 #else
 #define node_asn_struct asn1_node_st
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 /**
  * node_asn:
@@ -520,11 +522,13 @@
  *
  * Deprecated: 3.0: Use #asn1_node instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define node_asn _Pragma ("GCC warning \"'node_asn' macro is deprecated, use 'asn1_node' instead.\"") asn1_node_st
 #else
 #define node_asn asn1_node_st
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 /**
  * ASN1_TYPE:
@@ -533,11 +537,13 @@
  *
  * Deprecated: 3.0: Use #asn1_node instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define ASN1_TYPE _Pragma ("GCC warning \"'ASN1_TYPE' macro is deprecated, use 'asn1_node' instead.\"") asn1_node
 #else
 #define ASN1_TYPE asn1_node
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 /**
  * ASN1_TYPE_EMPTY:
@@ -546,11 +552,13 @@
  *
  * Deprecated: 3.0: Use NULL instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define ASN1_TYPE_EMPTY _Pragma ("GCC warning \"'ASN1_TYPE_EMPTY' macro is deprecated, use 'NULL' instead.\"") NULL
 #else
 #define ASN1_TYPE_EMPTY NULL
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 /**
  * static_struct_asn:
@@ -559,11 +567,13 @@
  *
  * Deprecated: 3.0: Use #asn1_static_node instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define static_struct_asn _Pragma ("GCC warning \"'static_struct_asn' macro is deprecated, use 'asn1_static_node_st' instead.\"") asn1_static_node_st
 #else
 #define static_struct_asn asn1_static_node_st
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 /**
  * ASN1_ARRAY_TYPE:
@@ -572,11 +582,13 @@
  *
  * Deprecated: 3.0: Use #asn1_static_node instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define ASN1_ARRAY_TYPE _Pragma ("GCC warning \"'ASN1_ARRAY_TYPE' macro is deprecated, use 'asn1_static_node' instead.\"") asn1_static_node
 #else
 #define ASN1_ARRAY_TYPE asn1_static_node
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 /**
  * asn1_static_node_t:
@@ -585,11 +597,13 @@
  *
  * Deprecated: 3.0: Use #asn1_static_node instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define asn1_static_node_t _Pragma ("GCC warning \"'asn1_static_node_t' macro is deprecated, use 'asn1_static_node' instead.\"") asn1_static_node
 #else
 #define asn1_static_node_t asn1_static_node
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 /**
  * node_data_struct:
@@ -598,11 +612,13 @@
  *
  * Deprecated: 3.0: Use #asn1_data_node_st instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define node_data_struct _Pragma ("GCC warning \"'node_data_struct' macro is deprecated, use 'asn1_data_node_st' instead.\"") asn1_data_node_st
 #else
 #define node_data_struct asn1_data_node_st
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 /**
  * ASN1_DATA_NODE:
@@ -611,11 +627,13 @@
  *
  * Deprecated: 3.0: Use #asn1_data_node_st instead.
  */
+#ifndef ASN1_DISABLE_DEPRECATED
 #if _ASN1_GCC_VERSION >= 30100
 #define ASN1_DATA_NODE _Pragma ("GCC warning \"'asn1_static_node_t' macro is deprecated, use 'asn1_static_node' instead.\"") asn1_data_node_st
 #else
 #define ASN1_DATA_NODE asn1_data_node_st
 #endif
+#endif /* !ASN1_DISABLE_DEPRECATED */
 
 #ifdef __cplusplus
 }