This is specified only irregularly, and people who don't know what a
void return type means are beyond help anyway.

This also adds a sentence specifying that X509_free(3) is NULL-safe, now
that we've removed all NULL-checks for it. I should sweep through and
add the sentence the rest of the NULL-safe LibreSSL *_free() functions
soon.

ok?


Index: lib/libc/stdio/fseek.3
===================================================================
RCS file: /cvs/src/lib/libc/stdio/fseek.3,v
retrieving revision 1.16
diff -u -p -r1.16 fseek.3
--- lib/libc/stdio/fseek.3      17 Jul 2013 05:42:11 -0000      1.16
+++ lib/libc/stdio/fseek.3      12 Mar 2016 01:05:07 -0000
@@ -139,9 +139,6 @@ On some systems an
 object may be a complex object
 and these routines may be the only way to portably reposition a text stream.
 .Sh RETURN VALUES
-The
-.Fn rewind
-function returns no value.
 Upon successful completion,
 .Fn fgetpos ,
 .Fn fseek ,
Index: lib/libc/stdlib/hcreate.3
===================================================================
RCS file: /cvs/src/lib/libc/stdlib/hcreate.3,v
retrieving revision 1.6
diff -u -p -r1.6 hcreate.3
--- lib/libc/stdlib/hcreate.3   28 Jul 2010 09:00:20 -0000      1.6
+++ lib/libc/stdlib/hcreate.3   12 Mar 2016 01:05:07 -0000
@@ -159,10 +159,6 @@ Otherwise, a value of 0 is returned and
 .Va errno
 is set to indicate the error.
 .Pp
-The
-.Fn hdestroy
-functions
-returns no value.
 .Pp
 If successful, the
 .Fn hsearch
Index: lib/libc/stdlib/malloc.3
===================================================================
RCS file: /cvs/src/lib/libc/stdlib/malloc.3,v
retrieving revision 1.93
diff -u -p -r1.93 malloc.3
--- lib/libc/stdlib/malloc.3    5 Feb 2016 15:09:09 -0000       1.93
+++ lib/libc/stdlib/malloc.3    12 Mar 2016 01:05:07 -0000
@@ -174,9 +174,6 @@ and set
 to
 .Er ENOMEM .
 .Pp
-The
-.Fn free
-function returns no value.
 .Sh IDIOMS
 Consider
 .Fn calloc
Index: lib/libc/stdlib/qsort.3
===================================================================
RCS file: /cvs/src/lib/libc/stdlib/qsort.3,v
retrieving revision 1.18
diff -u -p -r1.18 qsort.3
--- lib/libc/stdlib/qsort.3     29 Jan 2015 01:46:31 -0000      1.18
+++ lib/libc/stdlib/qsort.3     12 Mar 2016 01:05:07 -0000
@@ -143,9 +143,6 @@ which is faster than
 .Fn heapsort .
 Memory availability and pre-existing order in the data can make this untrue.
 .Sh RETURN VALUES
-The
-.Fn qsort
-function returns no value.
 .Pp
 .Rv -std heapsort mergesort
 .Sh ERRORS
Index: lib/libc/stdlib/tsearch.3
===================================================================
RCS file: /cvs/src/lib/libc/stdlib/tsearch.3,v
retrieving revision 1.19
diff -u -p -r1.19 tsearch.3
--- lib/libc/stdlib/tsearch.3   5 Jun 2013 03:39:23 -0000       1.19
+++ lib/libc/stdlib/tsearch.3   12 Mar 2016 01:05:07 -0000
@@ -112,9 +112,6 @@ is
 .Dv NULL
 or the datum cannot be found.
 .Pp
-The
-.Fn twalk
-function returns no value.
 .Sh SEE ALSO
 .Xr bsearch 3 ,
 .Xr lsearch 3
Index: lib/libcrypto/man/ASN1_OBJECT_new.3
===================================================================
RCS file: /cvs/src/lib/libcrypto/man/ASN1_OBJECT_new.3,v
retrieving revision 1.2
diff -u -p -r1.2 ASN1_OBJECT_new.3
--- lib/libcrypto/man/ASN1_OBJECT_new.3 9 Sep 2015 21:58:20 -0000       1.2
+++ lib/libcrypto/man/ASN1_OBJECT_new.3 12 Mar 2016 01:05:07 -0000
@@ -47,9 +47,6 @@ returns
 and sets an error code that can be obtained by
 .Xr ERR_get_error 3 .
 Otherwise it returns a pointer to the newly allocated structure.
-.Pp
-.Fn ASN1_OBJECT_free
-returns no value.
 .Sh SEE ALSO
 .Xr d2i_ASN1_OBJECT 3 ,
 .Xr ERR_get_error 3 ,
Index: lib/libcrypto/man/BUF_MEM_new.3
===================================================================
RCS file: /cvs/src/lib/libcrypto/man/BUF_MEM_new.3,v
retrieving revision 1.2
diff -u -p -r1.2 BUF_MEM_new.3
--- lib/libcrypto/man/BUF_MEM_new.3     22 Sep 2015 08:08:07 -0000      1.2
+++ lib/libcrypto/man/BUF_MEM_new.3     12 Mar 2016 01:05:07 -0000
@@ -89,9 +89,6 @@ returns the buffer or
 .Dv NULL
 on error.
 .Pp
-.Fn BUF_MEM_free
-returns no value.
-.Pp
 .Fn BUF_MEM_grow
 returns zero on error or the new size (i.e.
 .Fa len Ns ).
Index: lib/libssl/src/doc/crypto/DH_new.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/DH_new.pod,v
retrieving revision 1.3
diff -u -p -r1.3 DH_new.pod
--- lib/libssl/src/doc/crypto/DH_new.pod        4 May 2014 22:26:33 -0000       
1.3
+++ lib/libssl/src/doc/crypto/DH_new.pod        12 Mar 2016 01:05:07 -0000
@@ -25,8 +25,6 @@ If the allocation fails, DH_new() return
 can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>. Otherwise it returns a
 pointer to the newly allocated structure.
 
-DH_free() returns no value.
-
 =head1 SEE ALSO
 
 L<dh(3)|dh(3)>, L<ERR_get_error(3)|ERR_get_error(3)>,
Index: lib/libssl/src/doc/crypto/DH_set_method.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/DH_set_method.pod,v
retrieving revision 1.7
diff -u -p -r1.7 DH_set_method.pod
--- lib/libssl/src/doc/crypto/DH_set_method.pod 11 Nov 2015 22:14:40 -0000      
1.7
+++ lib/libssl/src/doc/crypto/DH_set_method.pod 12 Mar 2016 01:05:07 -0000
@@ -89,8 +89,6 @@ DH_set_default_method() is used.
 DH_OpenSSL() and DH_get_default_method() return pointers to the respective
 B<DH_METHOD>s.
 
-DH_set_default_method() returns no value.
-
 DH_set_method() returns non-zero if the provided B<meth> was successfully set 
as
 the method for B<dh> (including unloading the ENGINE handle if the previous
 method was supplied by an ENGINE).
Index: lib/libssl/src/doc/crypto/DSA_SIG_new.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/DSA_SIG_new.pod,v
retrieving revision 1.3
diff -u -p -r1.3 DSA_SIG_new.pod
--- lib/libssl/src/doc/crypto/DSA_SIG_new.pod   12 May 2003 02:18:39 -0000      
1.3
+++ lib/libssl/src/doc/crypto/DSA_SIG_new.pod   12 Mar 2016 01:05:07 -0000
@@ -26,8 +26,6 @@ error code that can be obtained by
 L<ERR_get_error(3)|ERR_get_error(3)>. Otherwise it returns a pointer
 to the newly allocated structure.
 
-DSA_SIG_free() returns no value.
-
 =head1 SEE ALSO
 
 L<dsa(3)|dsa(3)>, L<ERR_get_error(3)|ERR_get_error(3)>,
Index: lib/libssl/src/doc/crypto/DSA_new.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/DSA_new.pod,v
retrieving revision 1.3
diff -u -p -r1.3 DSA_new.pod
--- lib/libssl/src/doc/crypto/DSA_new.pod       14 Sep 2002 11:18:03 -0000      
1.3
+++ lib/libssl/src/doc/crypto/DSA_new.pod       12 Mar 2016 01:05:07 -0000
@@ -27,8 +27,6 @@ code that can be obtained by
 L<ERR_get_error(3)|ERR_get_error(3)>. Otherwise it returns a pointer
 to the newly allocated structure.
 
-DSA_free() returns no value.
-
 =head1 SEE ALSO
 
 L<dsa(3)|dsa(3)>, L<ERR_get_error(3)|ERR_get_error(3)>,
Index: lib/libssl/src/doc/crypto/DSA_set_method.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/DSA_set_method.pod,v
retrieving revision 1.9
diff -u -p -r1.9 DSA_set_method.pod
--- lib/libssl/src/doc/crypto/DSA_set_method.pod        11 Nov 2015 22:14:40 
-0000      1.9
+++ lib/libssl/src/doc/crypto/DSA_set_method.pod        12 Mar 2016 01:05:07 
-0000
@@ -103,8 +103,6 @@ struct
 DSA_OpenSSL() and DSA_get_default_method() return pointers to the respective
 B<DSA_METHOD>s.
 
-DSA_set_default_method() returns no value.
-
 DSA_set_method() returns non-zero if the provided B<meth> was successfully set
 as the method for B<dsa> (including unloading the ENGINE handle if the previous
 method was supplied by an ENGINE).
Index: lib/libssl/src/doc/crypto/ERR_load_strings.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/ERR_load_strings.pod,v
retrieving revision 1.1
diff -u -p -r1.1 ERR_load_strings.pod
--- lib/libssl/src/doc/crypto/ERR_load_strings.pod      19 Mar 2000 11:12:57 
-0000      1.1
+++ lib/libssl/src/doc/crypto/ERR_load_strings.pod      12 Mar 2016 01:05:07 
-0000
@@ -38,7 +38,7 @@ to user libraries at runtime.
 
 =head1 RETURN VALUE
 
-ERR_load_strings() returns no value. ERR_PACK() return the error code.
+ERR_PACK() return the error code.
 ERR_get_next_error_library() returns a new library number.
 
 =head1 SEE ALSO
Index: lib/libssl/src/doc/crypto/RAND_cleanup.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/RAND_cleanup.pod,v
retrieving revision 1.1
diff -u -p -r1.1 RAND_cleanup.pod
--- lib/libssl/src/doc/crypto/RAND_cleanup.pod  19 Mar 2000 11:12:58 -0000      
1.1
+++ lib/libssl/src/doc/crypto/RAND_cleanup.pod  12 Mar 2016 01:05:07 -0000
@@ -14,10 +14,6 @@ RAND_cleanup - erase the PRNG state
 
 RAND_cleanup() erases the memory used by the PRNG.
 
-=head1 RETURN VALUE
-
-RAND_cleanup() returns no value.
-
 =head1 SEE ALSO
 
 L<rand(3)|rand(3)>
Index: lib/libssl/src/doc/crypto/RSA_blinding_on.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/RSA_blinding_on.pod,v
retrieving revision 1.3
diff -u -p -r1.3 RSA_blinding_on.pod
--- lib/libssl/src/doc/crypto/RSA_blinding_on.pod       9 Jul 2014 17:36:58 
-0000       1.3
+++ lib/libssl/src/doc/crypto/RSA_blinding_on.pod       12 Mar 2016 01:05:07 
-0000
@@ -30,8 +30,6 @@ the blinding factor.
 
 RSA_blinding_on() returns 1 on success, and 0 if an error occurred.
 
-RSA_blinding_off() returns no value.
-
 =head1 SEE ALSO
 
 L<rsa(3)|rsa(3)>, L<rand(3)|rand(3)>
Index: lib/libssl/src/doc/crypto/RSA_new.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/RSA_new.pod,v
retrieving revision 1.4
diff -u -p -r1.4 RSA_new.pod
--- lib/libssl/src/doc/crypto/RSA_new.pod       4 May 2014 22:26:33 -0000       
1.4
+++ lib/libssl/src/doc/crypto/RSA_new.pod       12 Mar 2016 01:05:07 -0000
@@ -26,8 +26,6 @@ If the allocation fails, RSA_new() retur
 can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>. Otherwise it returns a
 pointer to the newly allocated structure.
 
-RSA_free() returns no value.
-
 =head1 SEE ALSO
 
 L<ERR_get_error(3)|ERR_get_error(3)>, L<rsa(3)|rsa(3)>,
Index: lib/libssl/src/doc/crypto/RSA_set_method.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/RSA_set_method.pod,v
retrieving revision 1.9
diff -u -p -r1.9 RSA_set_method.pod
--- lib/libssl/src/doc/crypto/RSA_set_method.pod        11 Nov 2015 22:14:40 
-0000      1.9
+++ lib/libssl/src/doc/crypto/RSA_set_method.pod        12 Mar 2016 01:05:08 
-0000
@@ -142,8 +142,6 @@ the default method is used.
 RSA_PKCS1_SSLeay(), RSA_PKCS1_null_method(), RSA_get_default_method()
 and RSA_get_method() return pointers to the respective RSA_METHODs.
 
-RSA_set_default_method() returns no value.
-
 RSA_set_method() returns a pointer to the old RSA_METHOD implementation
 that was replaced. However, this return value should probably be ignored
 because if it was supplied by an ENGINE, the pointer could be invalidated
Index: lib/libssl/src/doc/crypto/X509_new.pod
===================================================================
RCS file: /cvs/src/lib/libssl/src/doc/crypto/X509_new.pod,v
retrieving revision 1.1.1.2
diff -u -p -r1.1.1.2 X509_new.pod
--- lib/libssl/src/doc/crypto/X509_new.pod      1 Oct 2010 22:54:14 -0000       
1.1.1.2
+++ lib/libssl/src/doc/crypto/X509_new.pod      12 Mar 2016 01:05:08 -0000
@@ -19,14 +19,13 @@ X509 structure, which represents an X509
 X509_new() allocates and initializes a X509 structure.
 
 X509_free() frees up the B<X509> structure B<a>.
+If B<a> is a B<NULL> pointer, no action occurs.
 
 =head1 RETURN VALUES
 
 If the allocation fails, X509_new() returns B<NULL> and sets an error
 code that can be obtained by L<ERR_get_error(3)|ERR_get_error(3)>.
 Otherwise it returns a pointer to the newly allocated structure.
-
-X509_free() returns no value.
 
 =head1 SEE ALSO
 

Reply via email to