Remove ASN1_item_ndef_i2d(3) documentation

This was the last public API explicitly named ndef/NDEF for indefinite
length encoding, so remove that explanation as well.

Remove misinformation, reason had nothing to do with efficiency

"Failure to re-encode on modification is a bug not a feature."

OK jsing@

ASN1_{,const_}check_infinite_end(3) were removed in the last major bump,
so there's no longer a need to document that they are undocumented.

mark ASN1_check_infinite_end() and ASN1_const_check_infinite_end()
as intentionally undocumented

add the missing const qualifiers below EXAMPLES;
from <Malgorzata dot Olszowka at stunnel dot org>
via OpenSSL commit 256989ce in the OpenSSL 1.1.1 branch,
which is still under a free license

document ASN1_item_ndef_i2d(3)

document ASN1_item_pack(3) and ASN1_item_unpack(3)

new manual pages
ASN1_item_digest(3), ASN1_item_sign(3), and ASN1_item_verify(3)

document ASN1_get_object(3)

spelling

found a complete archive of SSLeay-0.4 to SSLeay-0.8.1b tarballs
on the web, so fix up SSLeay HISTORY accordingly

crypto HISTORY up to 1.0.0; researched from OpenSSL git

crypto HISTORY up to 0.9.7; researched from OpenSSL git

asn1.h HISTORY up to SSLeay 0.8.1b; researched from OpenSSL git

Document d2i_ASN1_TYPE(3) and i2d_ASN1_TYPE(3),
both listed in <openssl/asn1.h> and in OpenSSL doc/man3/d2i_X509.pod.
Minor wording improvements while here.

minor fixes;

describe what happens for val_out == NULL and for der_out == NULL

Very carefully tweak OpenSSL doc/man3/d2i_X509.pod and create a new
ASN1_item_d2i(3) manual page from it. Enough text remains to keep
Stephen Henson's Copyright.

The eight functions documented in t

Very carefully tweak OpenSSL doc/man3/d2i_X509.pod and create a new
ASN1_item_d2i(3) manual page from it. Enough text remains to keep
Stephen Henson's Copyright.

The eight functions documented in this new page are listed in
<openssl/asn1.h> and in Symbols.list, so they are public even though
OpenSSL does not document them. They are very important because
hundreds of documented, much-used public interface functions are
trivial wrappers around them, sharing their complicated semantics
and their copious CAVEATS and BUGS.

The plan is for the many pages documenting the wrappers to become
very concise, to focus on the few type-dependent specifics, and to
point to this new page for the details of the semantics, for the
CAVEATS, and for the BUGS.

While here, write a companion page ASN1_item_new(3) from scratch.
The user interface described in that page scares the hell out of
me, and i think people writing code to handle ASN.1 ought to be
aware of that dangerous user interface design, or they will sooner
or later get trapped.

show more ...