Add a STANDARDS section and mention the relevant section of the standard.

Link to X509_ALGOR_new(3) because one of the functions uses X509_ALGOR.
Delete a sentence about a function we don't have.
Delete another sentence that says nothing new.
Remove some macros that we don't normally use.

1 files changed, 9 insertions, 18 deletions

diff --git a/src/lib/libcrypto/man/X509_PUBKEY_new.3 b/src/lib/libcrypto/man/X509_PUBKEY_new.3
index 7ed923ac21..cd178a1ee0 100644
--- a/src/lib/libcrypto/man/X509_PUBKEY_new.3
+++ b/src/lib/libcrypto/man/X509_PUBKEY_new.3
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: X509_PUBKEY_new.3,v 1.2 2016/12/05 16:38:24 jmc Exp $
+.\"     $OpenBSD: X509_PUBKEY_new.3,v 1.3 2016/12/15 22:24:45 schwarze Exp $
 .\"     OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
 .\"
 .\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
@@ -48,7 +48,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: December 5 2016 $
+.Dd $Mdocdate: December 15 2016 $
 .Dt X509_PUBKEY_NEW 3
 .Os
 .Sh NAME
@@ -133,9 +133,8 @@
 .Sh DESCRIPTION
 The
 .Vt X509_PUBKEY
-structure represents the ASN.1
-.Sy SubjectPublicKeyInfo
-structure defined in RFC 5280 and used in certificates and certificate
+structure represents the ASN.1 SubjectPublicKeyInfo structure defined
+in RFC 5280 section 4.1 and used in certificates and certificate
 requests.
 .Pp
 .Fn X509_PUBKEY_new
@@ -180,9 +179,7 @@ and
 .Fn i2d_PUBKEY
 decode and encode an
 .Vt EVP_PKEY
-structure using
-.Sy SubjectPublicKeyInfo
-format.
+structure using SubjectPublicKeyInfo format.
 They otherwise follow the conventions of other ASN.1 functions such as
 .Xr d2i_X509 3 .
 .Pp
@@ -234,16 +231,6 @@ it can be set to
 .Dv NULL .
 All of the retrieved pointers are internal and must not be freed after
 the call.
-.Pp
-The
-.Vt X509_PUBKEY
-functions can be used to encode and decode public keys in a standard
-format.
-.Pp
-In many cases applications will not call the
-.Vt X509_PUBKEY
-functions directly: they will instead call wrapper functions such as
-.Xr X509_get0_pubkey 3 .
 .Sh RETURN VALUES
 If the allocation fails,
 .Fn X509_PUBKEY_new
@@ -271,4 +258,8 @@ return 1 for success and 0 if an error occurred.
 .Sh SEE ALSO
 .Xr d2i_X509 3 ,
 .Xr ERR_get_error 3 ,
+.Xr X509_ALGOR_new 3 ,
 .Xr X509_get_pubkey 3
+.Sh STANDARDS
+RFC 5280: Internet X.509 Public Key Infrastructure Certificate and
+Certificate Revocation List (CRL) Profile