The following functions/classes/headers/macros/names are deprecated, and will
be removed in a later release. If there is a suggested replacement API, it is
mentioned here.

Deprecated APIs, workarounds, and estimated removal times
----------------------------------------------------
Deprectated: Creating a public or private key object by passing a DataSource&
   to the constructor
Instead use: X509::load_key / PKCS8::load_key
Removed in: 1.3.x
Why: They are redundant and (worse) inflexible - with the load_key functions,
you don't have to assume the key is of a particular type, which is implicit in
using the constructor-based loading.

Algorithms: CS-Cipher, GOST, MISTY1, SHARK, ThreeWay, MD5-MAC, EMAC, SEAL
Instead use: Other (better) algorithms
Why: The reasons for the (possible) removal are varied, and range from patent
problems, algorithm weaknesses, lack of standardization, and, last but not
least, because for most of them probably nobody at all is using them. They will
be removed en-masse in 1.3.0 (and thus will not be available in 1.4.0, the next
stable series). There are a couple that may end up staying, but the majority
will almost certainly be removed. IF YOU ARE USING ONE OF THESE ALGORITHMS, AND
YOU NEED IT TO STAY, YOU HAD BETTER LET ME KNOW AS SOON AS POSSIBLE.
