Less documentation for deprecated API

[openssl.git] / doc / man3 / OBJ_nid2obj.pod

diff --git a/doc/man3/OBJ_nid2obj.pod b/doc/man3/OBJ_nid2obj.pod
index 3ada6679cf92b7d47e68e1532a562cdaa7a4ebbb..6c1aa1321f47c3c55a01c5a53c52335dbacb00d1 100644 (file)
--- a/doc/man3/OBJ_nid2obj.pod
+++ b/doc/man3/OBJ_nid2obj.pod
@@ -91,11 +91,7 @@ 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.
 
 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
-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
-does nothing if called. No explicit de-initialisation is now required. See
-L<OPENSSL_init_crypto(3)> for further information.
+OBJ_cleanup() releases any resources allocated by creating new objects.

 
 =head1 NOTES
 
 
 =head1 NOTES
 


@@ -137,22 +133,17 @@ The latter cannot be constant because it needs to be freed after use.
 
 Create an object for B<commonName>:
 
 
 Create an object for B<commonName>:
 

- ASN1_OBJECT *o;
- o = OBJ_nid2obj(NID_commonName);
+ ASN1_OBJECT *o = OBJ_nid2obj(NID_commonName);

 
 Check if an object is B<commonName>
 
  if (OBJ_obj2nid(obj) == NID_commonName)
 
 Check if an object is B<commonName>
 
  if (OBJ_obj2nid(obj) == NID_commonName)

-        /* Do something */
+     /* Do something */

 
 Create a new NID and initialize an object from it:
 
 
 Create a new NID and initialize an object from it:
 

- int new_nid;
- ASN1_OBJECT *obj;
-
- new_nid = OBJ_create("1.2.3.4", "NewOID", "New Object Identifier");
-
- obj = OBJ_nid2obj(new_nid);
+ int new_nid = OBJ_create("1.2.3.4", "NewOID", "New Object Identifier");
+ ASN1_OBJECT *obj = OBJ_nid2obj(new_nid);

 
 Create a new object directly:
 
 
 Create a new object directly:
 


@@ -184,7 +175,8 @@ L<ERR_get_error(3)>
 
 =head1 HISTORY
 
 
 =head1 HISTORY
 

-OBJ_cleanup() was deprecated in OpenSSL 1.1.0.
+OBJ_cleanup() was deprecated in OpenSSL 1.1.0 by L<OPENSSL_init_crypto(3)>
+and should not be used.

 
 =head1 COPYRIGHT
 
 
 =head1 COPYRIGHT