add sha3 docs

Author: newpavlov

sha3/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sha3"
-version = "0.8.1"
+version = "0.8.2"
 authors = ["RustCrypto Developers"]
 license = "MIT OR Apache-2.0"
 description = "SHA-3 (Keccak) hash function"

sha3/src/lib.rs

@@ -43,6 +43,7 @@
 #![no_std]
 #![doc(html_logo_url =
     "https://raw.githubusercontent.com/RustCrypto/meta/master/logo_small.png")]
+#![deny(missing_docs, warnings)]
 extern crate keccak;
 extern crate block_buffer;
 extern crate byte_tools;
@@ -68,17 +69,28 @@ mod state;
 pub use reader::Sha3XofReader;
 use state::Sha3State;
 
-sha3_impl!(Keccak224, U28, U144, paddings::Keccak, "");
-sha3_impl!(Keccak256, U32, U136, paddings::Keccak, "");
-sha3_impl!(Keccak384, U48, U104, paddings::Keccak, "");
-sha3_impl!(Keccak512, U64, U72, paddings::Keccak, "");
+sha3_impl!(Keccak224, U28, U144, paddings::Keccak,
+    "Keccak-224 hash function.");
+sha3_impl!(Keccak256, U32, U136, paddings::Keccak,
+    "Keccak-256 hash function.");
+sha3_impl!(Keccak384, U48, U104, paddings::Keccak,
+    "Keccak-384 hash function.");
+sha3_impl!(Keccak512, U64, U72, paddings::Keccak,
+    "Keccak-512 hash function.");
 
-sha3_impl!(Keccak256Full, U200, U136, paddings::Keccak, "SHA-3 variant used in CryptoNight.");
+sha3_impl!(Keccak256Full, U200, U136, paddings::Keccak,
+    "SHA-3 variant used in CryptoNight.");
 
-sha3_impl!(Sha3_224, U28, U144, paddings::Sha3, "");
-sha3_impl!(Sha3_256, U32, U136, paddings::Sha3, "");
-sha3_impl!(Sha3_384, U48, U104, paddings::Sha3, "");
-sha3_impl!(Sha3_512, U64, U72, paddings::Sha3, "");
+sha3_impl!(Sha3_224, U28, U144, paddings::Sha3,
+    "SHA-3-224 hash function.");
+sha3_impl!(Sha3_256, U32, U136, paddings::Sha3,
+    "SHA-3-256 hash function.");
+sha3_impl!(Sha3_384, U48, U104, paddings::Sha3,
+    "SHA-3-384 hash function.");
+sha3_impl!(Sha3_512, U64, U72, paddings::Sha3,
+    "SHA-3-512 hash function.");
 
-shake_impl!(Shake128, U168, paddings::Shake, "");
-shake_impl!(Shake256, U136, paddings::Shake, "");
+shake_impl!(Shake128, U168, paddings::Shake,
+    "SHAKE128 extendable output (XOF) hash function");
+shake_impl!(Shake256, U136, paddings::Shake,
+    "SHAKE256 extendable output (XOF) hash function");