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.

MD5 should use little endian order. Fortunately the only ciphersuite
affected is EXP-RC2-CBC-MD5 (TLS_RSA_EXPORT_WITH_RC2_CBC_40_MD5) which
is a rarely used export grade ciphersuite.
(cherry picked from commit f306b87d766e6ecf30824635c7c395b67cff9dbc)

(cherry picked from commit 529d27ea472fc2c7ba9190a15a58cb84012d4ec6)

Address CBC decrypt timing issues and reenable the AESNI+SHA1 stitch.
(cherry picked from commit 125093b59f3c2a2d33785b5563d929d0472f1721)

Kludge alert. This is arranged by passing padding length in unused
bits of SSL3_RECORD->type, so that orig_len can be reconstructed.
(cherry picked from commit 8bfd4c659f180a6ce34f21c0e62956b362067fba)

(cherry picked from commit 04e45b52ee3be81121359cc1198fd01e38096e9f)

(cherry picked from commit d5371324d978e4096bf99b9d0fe71b2cb65d9dc8)

RISCs are picky and alignment granted by compiler for md_state can be
insufficient for SHA512.
(cherry picked from commit 36260233e7e3396feed884d3f501283e0453c04f)