Don't use "version" in "OpenSSL Version 1.1.0" etc
authorRich Salz <rsalz@openssl.org>
Sat, 15 Jul 2017 13:39:45 +0000 (09:39 -0400)
committerRich Salz <rsalz@openssl.org>
Sun, 16 Jul 2017 21:28:41 +0000 (17:28 -0400)
Reviewed-by: Paul Dale <paul.dale@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/3938)

23 files changed:
doc/man1/crl.pod
doc/man1/x509.pod
doc/man3/BIO_f_ssl.pod
doc/man3/BIO_get_data.pod
doc/man3/BIO_meth_new.pod
doc/man3/BIO_push.pod
doc/man3/BIO_should_retry.pod
doc/man3/DH_get0_pqg.pod
doc/man3/DH_meth_new.pod
doc/man3/DSA_get0_pqg.pod
doc/man3/DSA_meth_new.pod
doc/man3/EVP_CIPHER_meth_new.pod
doc/man3/EVP_MD_meth_new.pod
doc/man3/HMAC.pod
doc/man3/OBJ_nid2obj.pod
doc/man3/OCSP_response_status.pod
doc/man3/OpenSSL_add_all_algorithms.pod
doc/man3/RAND_load_file.pod
doc/man3/RSA_get0_key.pod
doc/man3/RSA_meth_new.pod
doc/man3/SSL_extension_supported.pod
doc/man3/X509_STORE_get0_param.pod
util/find-doc-nits

index 1f5f4dd27836e2d591dc3b340019ef25fdc7bc63..14150fd943e42c932e4c9e29fca20bf4ed4db1b3 100644 (file)
@@ -76,7 +76,7 @@ a directory by issuer name.
 =item B<-hash_old>
 
 Outputs the "hash" of the CRL issuer name using the older algorithm
-as used by OpenSSL versions before 1.0.0.
+as used by OpenSSL before version 1.0.0.
 
 =item B<-issuer>
 
index b769829b77617f5df61595fe32f7ea4561ccdb86..587c630065af3ca659bc02fe3595a7691b22ca13 100644 (file)
@@ -187,12 +187,12 @@ Synonym for "-subject_hash" for backward compatibility reasons.
 =item B<-subject_hash_old>
 
 Outputs the "hash" of the certificate subject name using the older algorithm
-as used by OpenSSL versions before 1.0.0.
+as used by OpenSSL before version 1.0.0.
 
 =item B<-issuer_hash_old>
 
 Outputs the "hash" of the certificate issuer name using the older algorithm
-as used by OpenSSL versions before 1.0.0.
+as used by OpenSSL before version 1.0.0.
 
 =item B<-subject>
 
index 1da14897f038d62dca11236af062fa30b4069521..571584c148dbed3b2340aa0c1d5d7416423d7398 100644 (file)
@@ -271,9 +271,9 @@ a client and also echoes the request to standard output.
  BIO_flush(sbio);
  BIO_free_all(sbio);
 
-=head1 BUGS
+=head1 HISTORY
 
-In OpenSSL versions before 1.0.0 the BIO_pop() call was handled incorrectly,
+In OpenSSL before 1.0.0 the BIO_pop() call was handled incorrectly,
 the I/O BIO reference count was incorrectly incremented (instead of
 decremented) and dissociated with the SSL BIO even if the SSL BIO was not
 explicitly being popped (e.g. a pop higher up the chain). Applications which
index 14f21fa720e1e236e88b74ba6ede418e7838a06a..c3137c4c55882a0021c5071dac50c16c242a0f7b 100644 (file)
@@ -51,7 +51,7 @@ L<bio>, L<BIO_meth_new>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index 53a68a13e521e1780e825b190e4781de9c799903..00baebf1e2df11120bbdb870669e40b576ad7e18 100644 (file)
@@ -139,7 +139,7 @@ L<bio>, L<BIO_find_type>, L<BIO_ctrl>, L<BIO_read_ex>, L<BIO_new>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index 762027ff6a9858b4770c70de3da6115b4677699f..ce56db9836ff6b2de06143dc8d047658fb27614f 100644 (file)
@@ -75,7 +75,7 @@ L<bio>
 
 =head1 HISTORY
 
-The BIO_set_next() function was added in OpenSSL version 1.1.0.
+The BIO_set_next() function was added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index d145bf4b2603c0b5b68200ba25551646388f7ef4..4d2d599e13ab4e9a06eb9fe4d4f9c5bf665c67dc 100644 (file)
@@ -118,7 +118,7 @@ L<bio>
 =head1 HISTORY
 
 The BIO_get_retry_reason() and BIO_set_retry_reason() functions were added in
-OpenSSL version 1.1.0.
+OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index 5e5d3d318a176a3959a7cd24148ea1f330b1f165..7dd875b64f77600f0ed89ed6e7dda8c7b40f4820 100644 (file)
@@ -98,7 +98,7 @@ L<DH_set_method(3)>, L<DH_size(3)>, L<DH_meth_new(3)>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index 02acb54f27c8b89852a101709c063e72cb918818..5037a9d82bef6612dc391da17367e652ff7a475c 100644 (file)
@@ -153,7 +153,7 @@ L<DH_set_method(3)>, L<DH_size(3)>, L<DH_get0_pqg(3)>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index 3628ccbc1f737786c97387b8bf2c2152a3df2004..58e3ab5b5675b3a48992f44611da8857290d14dc 100644 (file)
@@ -88,7 +88,7 @@ L<DSA_sign(3)>, L<DSA_size(3)>, L<DSA_meth_new(3)>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index cd1735c1a395b6e4f31511926614c5e91d477cf4..782ac0ffde3ddc74ba10d81cc1778f44eae8b109 100644 (file)
@@ -201,7 +201,7 @@ L<DSA_sign(3)>, L<DSA_size(3)>, L<DSA_get0_pqg(3)>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index e1583c5c557d101e3640e4e0e201a188d7a8cbcb..562974d9b4603acbc51c78059d8c76fb5f0e50b7 100644 (file)
@@ -222,7 +222,7 @@ L<EVP_EncryptInit>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index c15a31e7fcb074082f7857bbf0f72e8ebc077ed1..3d60fab7440c183fb9169362018143523f7800c9 100644 (file)
@@ -156,7 +156,7 @@ L<EVP_DigestInit(3)>, L<EVP_SignInit(3)>, L<EVP_VerifyInit(3)>
 =head1 HISTORY
 
 The B<EVP_MD> structure was openly available in OpenSSL before version
-1.1.  The functions described here were added in OpenSSL version 1.1.
+1.1.  The functions described here were added in OpenSSL 1.1.
 
 =head1 COPYRIGHT
 
index 8cc3df9ab7eb201b25ec52e0c7fa223863085d7b..493b9338210f4476907df6e58671981703f7cddb 100644 (file)
@@ -138,15 +138,14 @@ L<SHA1(3)>, L<evp(7)>
 
 =head1 HISTORY
 
-HMAC_CTX_init() was replaced with HMAC_CTX_reset() in OpenSSL versions 1.1.0.
+HMAC_CTX_init() was replaced with HMAC_CTX_reset() in OpenSSL 1.1.0.
 
-HMAC_CTX_cleanup() existed in OpenSSL versions before 1.1.0.
+HMAC_CTX_cleanup() existed in OpenSSL before version 1.1.0.
 
-HMAC_CTX_new(), HMAC_CTX_free() and HMAC_CTX_get_md() are new in OpenSSL version
-1.1.0.
+HMAC_CTX_new(), HMAC_CTX_free() and HMAC_CTX_get_md() are new in OpenSSL 1.1.0.
 
 HMAC_Init_ex(), HMAC_Update() and HMAC_Final() did not return values in
-versions of OpenSSL before 1.0.0.
+OpenSSL before version 1.0.0.
 
 =head1 COPYRIGHT
 
index 5c628f5f912b2b78595ffa6e5a3cbd90567079c0..7b4169b4a26ce9d63caa0e931625eb2ec17b72cc 100644 (file)
@@ -91,9 +91,9 @@ OBJ_length() returns the size of the content octets of B<obj>.
 OBJ_get0_data() returns a pointer to the content octets of B<obj>.
 The returned pointer is an internal pointer which B<must not> be freed.
 
-In OpenSSL versions prior to 1.1.0 OBJ_cleanup() cleaned up OpenSSLs internal
+In OpenSSL before version 1.1.0, OBJ_cleanup() cleaned up the internal
 object table and was called before an application exits if any new objects were
-added using OBJ_create(). This function is deprecated in version 1.1.0 and now
+added using OBJ_create(). This function is deprecated in OpenSSL 1.1.0 and now
 does nothing if called. No explicit de-initialisation is now required. See
 L<OPENSSL_init_crypto(3)> for further information.
 
index 8f330013ebcd4a5df9e08675173192bf6ab7043b..e81b8665d49c6f2e90ee9cd65e30f22aa4b8a4d2 100644 (file)
@@ -86,7 +86,7 @@ L<OCSP_RESPID_free(3)>
 =head1 HISTORY
 
 The OCSP_RESPID_set_by_name(), OCSP_RESPID_set_by_key() and OCSP_RESPID_match()
-functions were added in OpenSSL version 1.1.0a.
+functions were added in OpenSSL 1.1.0a.
 
 =head1 COPYRIGHT
 
index 7c515aa3da447ad38592ddbd7598a66cbb2bfb85..1593e97808fea5c75482743d638320bdf4925681 100644 (file)
@@ -23,8 +23,8 @@ Deprecated:
 
 OpenSSL keeps an internal table of digest algorithms and ciphers. It uses
 this table to lookup ciphers via functions such as EVP_get_cipher_byname(). In
-OpenSSL versions prior to 1.1.0 these functions initialised and de-initialised
-this table. From OpenSSL 1.1.0 they are deprecated. No explicit initialisation
+OpenSSL before version 1.1.0, these functions initialised and de-initialised
+this table. Starting with OpenSSL 1.1.0 they are deprecated. No explicit initialisation
 or de-initialisation is required. See L<OPENSSL_init_crypto(3)> for further
 information.
 
index 0a0c4bca6b6557da5c0b1fd6dda4ee1a14b59995..8907bdc77c8d7af1b563bf2345ffbc301f9fa971 100644 (file)
@@ -68,10 +68,10 @@ L<RAND_bytes(3)>, L<RAND_add(3)>
 
 =head1 HISTORY
 
-A comment in the source since at least OpenSSL version 1.0.2 said that
+A comment in the source since at least OpenSSL 1.0.2 said that
 RAND_load_file() and RAND_write_file() were only intended for regular files,
 and not really device special files such as C</dev/random>.  This was
-poorly enforced before OpenSSL version 1.1.1.
+poorly enforced before OpenSSL 1.1.1.
 
 =head1 COPYRIGHT
 
index 557eb43522076ac23cda6c52da93c222e96253a5..7810ba0e955342ba8504d33df01480213450e271 100644 (file)
@@ -94,7 +94,7 @@ L<RSA_new(3)>, L<RSA_size(3)>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index 5e430d6395e00c7917411827b6f5822b4d17d773..933968a93850bf20f71cf236e4ac369ddc72a72b 100644 (file)
@@ -228,7 +228,7 @@ L<RSA_set_method(3)>, L<RSA_size(3)>, L<RSA_get0_key(3)>
 
 =head1 HISTORY
 
-The functions described here were added in OpenSSL version 1.1.0.
+The functions described here were added in OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index 54a55a73b910ca190801373509e2a10400cf24fc..51ff6beeb51381706669f5a2d2b6114f72c227b8 100644 (file)
@@ -277,7 +277,7 @@ internally by OpenSSL and 0 otherwise.
 
 =head1 HISTORY
 
-The function SSL_CTX_add_custom_ext() was added in OpenSSL version 1.1.1.
+The function SSL_CTX_add_custom_ext() was added in OpenSSL 1.1.1.
 
 =head1 COPYRIGHT
 
index 2144f2b0ae403c4edeec97854fb90b0f2386ab5c..0aed725ad6d28b356e5bedff1c4caeb71339901a 100644 (file)
@@ -43,7 +43,7 @@ L<X509_STORE_new(3)>
 =head1 HISTORY
 
 B<X509_STORE_get0_param> and B<X509_STORE_get0_objects> were added in
-OpenSSL version 1.1.0.
+OpenSSL 1.1.0.
 
 =head1 COPYRIGHT
 
index bdc1ba225b6fc40694a60d46e0d768e3fb32c042..0b8308086433e403c2aae5785d4f7ae59003c084 100755 (executable)
@@ -173,6 +173,8 @@ sub check()
         if $contents =~ /L<([^>]*)\|([^>]*)>/ && $1 eq $2;
     print "$id Bad =over $1\n"
         if $contents =~ /=over([^ ][^24])/;
+    print "$id Possible version style issue\n"
+        if $contents =~ /OpenSSL version [019]/;
 
     if ( $contents !~ /=for comment multiple includes/ ) {
         # Look for multiple consecutive openssl #include lines