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.

Most everything in here is scheduled to be removed during the 1.1.x
versions. Most will probably go out in 1.1.0. If this is an issue, stay
with the 1.0.x releases, which will still be maintained.

Deprecated APIs, workarounds, and estimated removal times
----------------------------------------------------
Deprecated: OpenCL compatibility: opencl.h, OpenCL::, OPENCL_* macros
Instead use: botan.h, Botan::, BOTAN_*
Version for removal: late 1.1.x

Deprecated: BigInt::ten()

Deprecated: Creating a PK_* object by passing a EME*, EMSA*, or KDF*
Instead use: The ones that pass the name for the algorithm in question as
             a string
Notes: You probably weren't using this anyway.

Deprecated: Counter in ofb.h
Instead use: CTR in ctr.h
Notes: ofb.h knows about Counter and CTR, while ctr.h only knows about CTR

Deprecated: Using the three argument form of EMSA4 (to specify a non-default
            seed size)
Instead: Use the single argument (hash function) or two argument (hash + mgf
         name) versions.
Notes: I mostly included support for alternate seed sizes in order to test that
       we could verify messages with different seed sizes. The security of
       EMSA4 is not as good when using a smaller seed. With Botan you can
       verify a message signed with a arbitrarily sized seed, but there is no
       reason to support creating a signature with any seed size other than the
       current default (which is a seed the same length as output of the
       underlying hash function)

Deprecated: Doing a lookup for "HAVAL-n", where n is the bitsize of the desired
            hash (128, 160, 192, 224, 256)
Instead use: "HAVAL(m)" where m is the bytesize of the desired hash
             (16, 20, 24, 28, 32).

Deprecated: Creating a DL_Group, RSA key, or RW key smaller than 512 bits
Instead: Use a sane keysize, obviously
Notes: The only use for anything smaller is for testing. Smaller keys will
       still be accepted as input, I suppose. Currently keys as small as 64
       bits can be generated.

Deprecated:
         Pipe::read(msg, buffer, size)
         Pipe::read(msg, byte_out)
         Pipe::peek(msg, buffer, size)
         Pipe::peek(msg, byte_out)
Instead use:
         Pipe::read(buffer, size, msg)
         Pipe::read(byte_out, msg)
         Pipe::peek(buffer, size, msg)
         Pipe::peek(byte_out, msg)
Notes: Putting the message number last lets us make a default for it. This, in
       turn, makes it possible to merge pairs of functions, like the read()
       function that took a message number and the one that didn't.

       The changes to the peek functions are mostly to make everything
       consitent WRT how the arguments are handled. It also lets us support
       peeking on the default message number, which peek did not support
       before. (Calling peek() with only two arguments will result in peeking
       at the default message).

       The deprecated functions are now all just stubs that reorder their
       arguments and call the correct function.

Deprecated:
         Passing only two arguments (a DL_Group and a secret key) to
         DH_PrivateKey
Instead: Pass all three arguments
