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",