more docs and clippy

Author: cowlicks

src/fixedwidth.rs

@@ -69,7 +69,7 @@ pub trait FixedWidthEncoding {
 #[derive(Debug)]
 pub struct FixedWidthUint<'a, T: FixedWidthEncoding + ?Sized>(&'a T);
 
-impl<'t, T: FixedWidthEncoding> CompactEncoding<T::Decode> for FixedWidthUint<'t, T> {
+impl<T: FixedWidthEncoding> CompactEncoding<T::Decode> for FixedWidthUint<'_, T> {
     fn encoded_size(&self) -> Result<usize, EncodingError> {
         self.0.fw_encoded_size()
     }

src/lib.rs

@@ -290,12 +290,18 @@ pub trait BoxArrayEncodable: CompactEncoding {
 /// assert_eq!(result, 12);
 /// # Ok::<(), Box<dyn std::error::Error>>(())
 /// ```
+/// If you want to use this within a non-result context you can do
+/// ```
+/// # use crate::compact_encoding::{sum_encoded_size, CompactEncoding, EncodingError};
+/// let bar = 42u64;
+/// let result = (|| { Ok::<usize, EncodingError>(sum_encoded_size!(bar)) })().unwrap();
+/// assert_eq!(result, 1);
+/// ```
 macro_rules! sum_encoded_size {
     ($($val:expr),+) => {{
         let out: usize = [
                 $(
                     $val.encoded_size()?,
-
                 )*
             ].iter().sum();
         out