Merge OBJ_NAME_do_all*(3) into EVP_CIPHER_do_all(3)

This is the only OBJ_NAME API that will remain after the next major bump.
The API is misnamed and really is about EVP, so move it to an EVP manual

Merge OBJ_NAME_do_all*(3) into EVP_CIPHER_do_all(3)

This is the only OBJ_NAME API that will remain after the next major bump.
The API is misnamed and really is about EVP, so move it to an EVP manual
documenting another API doing essentially the same thing. Remove most cross
references to OBJ_NAME_*.

show more ...

Partial rewrite:
* Integrate the leftovers of the former NOTES section into the main text,
resulting in a more logical order of information.
* Make many descriptions more precise and tweak many wordi

Partial rewrite:
* Integrate the leftovers of the former NOTES section into the main text,
resulting in a more logical order of information.
* Make many descriptions more precise and tweak many wordings.
For example, the description of OBJ_cmp(3) was totally misleading.

Add a CAVEATS section explaining the scary ownership contracts
of the functions returning ASN1_OBJECT pointers.

Move the discussion of NID_undef to the BUGS section because the
statement "objects which are not in the table have the NID value
NID_undef" was misleading in more than one way.

Considering that an API as fundamental as this one contains such a
gigantic amount of quirks and traps and gaps makes me shudder.

show more ...

Remove OBJ_add_sigid and OBJ_sigid_free documentation

These will be made internal and will likely go away. The OBJ_add_sigid.3
manual should probably be renamed; this can be done in a second step.

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

new manual page OBJ_add_sigid(3)

new manual page OBJ_NAME_add(3)

Move OBJ_create(3) into its own manual page
because OBJ_nid2obj(3) is already long and
more functions related to OBJ_create(3) have to be documented.

document i2a_ASN1_OBJECT(3)

Improve pages that briefly mentioned ERR - usually below SEE ALSO -
but failed to provide any real information.
OK tb@ jmc@

Tree structure for manual pages: crypto(3) links to 33 function
group pages, and these link on to all their second-level subpages.
Only a handful of second-level pages have third-level subpages.
So a

Tree structure for manual pages: crypto(3) links to 33 function
group pages, and these link on to all their second-level subpages.
Only a handful of second-level pages have third-level subpages.
So all crypto pages can now be reached from the www.libressl.org
frontpage via at most four clicks, in most cases three clicks.
Also link back from leaf pages to their respective group pages
and add a couple of additional links between related pages.
Triggered by a question from deraadt@.
OK jmc@ tb@

show more ...

In asn1.h rev. 1.46 2018/04/25 11:48:21, tb@ added const qualifiers
to some parameters of some functions. Update the documentation.
Add a few additional missing const qualifiers while here.

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 0.9.4; researched from OpenSSL git

crypto HISTORY up to OpenSSL 0.9.2b; researched from OpenSSL git

objects.h HISTORY up to SSLeay 0.9.0; researched from OpenSSL git

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

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

Describe what ASN1_OBJECT_new(3), ASN1_OBJECT_free(3), OBJ_dup(3),
and OBJ_create(3) really do rather than making broad and incomplete
statements that are only true in some cases.

Improve the one-li

Describe what ASN1_OBJECT_new(3), ASN1_OBJECT_free(3), OBJ_dup(3),
and OBJ_create(3) really do rather than making broad and incomplete
statements that are only true in some cases.

Improve the one-line descriptions.
Some minor wording improvements while here.

There is obviously more work to do in the vicinity...

show more ...

Add Copyright and license.
Document i2t_ASN1_OBJECT(3), from OpenSSL.
Merge more info about what NIDs are from OpenSSL.

various cleanup;

first pass; ok schwarze

convert remaining ASN1 object manuals from pod to mdoc