Add x509.h to doc.config
There are still a pile of functions left to document, but we're far
enough now that the doc generation is happy to run on this header. Go
ahead and start generating output.
Bug: 426
Change-Id: I4c807d625df3a4a881936e99b5a3fc6559cda6c9
Reviewed-on: https://boringssl-review.googlesource.com/c/boringssl/+/65793
Reviewed-by: Bob Beck <bbe@google.com>
Commit-Queue: David Benjamin <davidben@google.com>
diff --git a/include/openssl/x509.h b/include/openssl/x509.h
index 24179d1..008c0cb 100644
--- a/include/openssl/x509.h
+++ b/include/openssl/x509.h
@@ -102,10 +102,6 @@
//
// In the future, a replacement library will be available. Meanwhile, minimize
// dependencies on this header where possible.
-//
-// TODO(https://crbug.com/boringssl/426): Documentation for this library is
-// still in progress. Some functions have not yet been documented, and some
-// functions have not yet been grouped into sections.
// Certificates.
@@ -4424,7 +4420,10 @@
} /* X509_ALGOR */;
-// Functions below this point have not yet been organized into sections.
+// Underdocumented functions.
+//
+// TODO(https://crbug.com/boringssl/426): Functions below this point have not
+// yet been documented or organized into sections.
// This stuff is certificate "auxiliary info"
// it contains details which are useful in certificate
@@ -4590,7 +4589,6 @@
DEFINE_STACK_OF(X509V3_EXT_METHOD)
-// ext_flags values
#define X509V3_EXT_CTX_DEP 0x2
#define X509V3_EXT_MULTILINE 0x4
@@ -4619,8 +4617,6 @@
// If relativename then this contains the full distribution point name
X509_NAME *dpname;
} DIST_POINT_NAME;
-// All existing reasons
-#define CRLDP_ALL_REASONS 0x807f
struct DIST_POINT_st {
DIST_POINT_NAME *distpoint;
@@ -4877,8 +4873,8 @@
// append if it is not present.
#define X509V3_ADD_REPLACE 2L
-// X509V3_ADD_REPLACE causes the function to replace the existing extension and
-// fail if it is not present.
+// X509V3_ADD_REPLACE_EXISTING causes the function to replace the existing
+// extension and fail if it is not present.
#define X509V3_ADD_REPLACE_EXISTING 3L
// X509V3_ADD_KEEP_EXISTING causes the function to succeed without replacing the
diff --git a/util/doc.config b/util/doc.config
index d2bc500..e36a960 100644
--- a/util/doc.config
+++ b/util/doc.config
@@ -57,7 +57,8 @@
"Name": "Legacy ASN.1 and X.509 implementation (documentation in progress)",
"Headers": [
"include/openssl/asn1.h",
- "include/openssl/conf.h"
+ "include/openssl/conf.h",
+ "include/openssl/x509.h"
]
},{
"Name": "SSL implementation",
