cleaned up the docs for ml-dsa

Author: ounsworth

crypto/mldsa/src/hash_mldsa.rs

@@ -92,6 +92,7 @@ use bouncycastle_rng::HashDRBG_SHA512;
 use bouncycastle_sha2::{SHA256, SHA512};
 
 // Imports needed only for docs
+#[allow(unused_imports)]
 use crate::mldsa::MuBuilder;
 
 const SHA256_OID: &[u8] = &[0x06, 0x09, 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x01];

crypto/mldsa/src/lib.rs

@@ -111,6 +111,7 @@
 #![feature(unsized_const_params)]
 
 // imports needed just for docs
+#[allow(unused_imports)]
 use bouncycastle_core_interface::traits::{KeyMaterial, Signature, PHSignature};
 
 pub mod mldsa; // todo -- pub just to get the docs. Is that right? Or should I suck the docs up here?

crypto/mldsa/src/mldsa.rs

@@ -325,7 +325,9 @@ use bouncycastle_sha3::{SHAKE128, SHAKE256};
 
 
 // imports needed just for docs
+#[allow(unused_imports)]
 use bouncycastle_core_interface::traits::PHSignature;
+#[allow(unused_imports)] 
 use crate::hash_mldsa;
 
 /*** Constants ***/

crypto/mldsa/src/mldsa_keys.rs

@@ -8,7 +8,6 @@ use crate::{ML_DSA_44_NAME, ML_DSA_65_NAME, ML_DSA_87_NAME};
 use crate::mldsa::{MLDSA44_ETA, MLDSA44_PK_LEN, MLDSA44_SK_LEN, MLDSA44_k, MLDSA44_l};
 use crate::mldsa::{MLDSA65_ETA, MLDSA65_PK_LEN, MLDSA65_SK_LEN, MLDSA65_k, MLDSA65_l};
 use crate::mldsa::{MLDSA87_ETA, MLDSA87_PK_LEN, MLDSA87_SK_LEN, MLDSA87_k, MLDSA87_l};
-use crate::mldsa::{POLY_T0PACKED_LEN, POLY_T1PACKED_LEN};
 use crate::mldsa::{POLY_T0PACKED_LEN, POLY_T1PACKED_LEN, SEED_LEN};
 use bouncycastle_core_interface::errors::SignatureError;
 use bouncycastle_core_interface::key_material::KeyMaterialSized;
@@ -17,6 +16,7 @@ use std::fmt;
 use std::fmt::{Display, Formatter};
 
 // imports just for docs
+#[allow(unused_imports)]
 use crate::mldsa::MLDSATrait;