password-hash: add Error::OutputSize

[daxpedda]

See RustCrypto/password-hashes#313.

Sometimes a very specific output size is expected. Any bike-shedding is very welcome.

[tarcieri]

This is back to having three different variants that effectively mean different flavors of the same thing.

What about this instead?

OutputSize { expected: Ordering, size: usize }

[daxpedda]

OutputSize { expected: Ordering, size: usize }

I wasn't sure how you mean that, I kinda turned it around, the usize holds the expected size and the Ordering holds if the actual size is too long, too short, or unequal (doesn't match properly I guess).

Also squashed the commits.

EDIT: I hope the documentation is sufficient and alright.

[tarcieri]

This looks good to me now.

It's a breaking change though, so I might keep this open until we're ready to start working on the next version of password-hash.

[daxpedda]

@tarcieri just saw the new update to 0.5.0-pre.0, are we ready to add this breaking change now?

[tarcieri]

Thanks!