PR: 3004

Add CMS_RecipientInfo_encrypt: this function encrypts an existing content
encryption key to match the key in the RecipientInfo structure: this is
useful if a new recpient is added to and existing enveloped data structure.

Add documentation.

Two example programs one for command line argument processing and
one for configuration file processing.

Fix some typos and update version number first added: it has now been
backported to OpenSSL 1.0.2.

Not sure why I am getting these now and not before.

podlators 2.5.0 has switched to dying on POD syntax errors. This means
that a bunch of long-standing erroneous POD in the openssl documentation
now leads to fatal errors from pod2man, halting installation.

Unfortunately POD constraints mean that you have to sort numeric lists
in ascending order if they start with 1: you cannot do 1, 0, 2 even if
you want 1 to appear first. I've reshuffled such (alas, I wish there
were a better way but I don't know of one).

Add description of "allocate and encode" operation for ASN1 routines.

Document how versioning will for after the letter release reaches
y.

The version check for DTLS1_VERSION was redundant as
DTLS1_VERSION > TLS1_1_VERSION, however we do need to
check for DTLS1_BAD_VER for compatibility.

PR:2984

(cherry picked from commit cbf9b4aed3e209fe8a39e1d6f55aaf46d1369dc4)

(cherry picked from commit f88dbb8385c199a2a28e9525c6bba3a64bda96af)

It also ensures that valgring is happy.

Revert is appropriate because binary compatibility is not an issue
in 1.1.