   @doc """
   Decodes a base 32 encoded string into a binary string.
 
-  Accepts an atom `:upper` (default) for decoding from upper case characters or
-  `:lower` for lower case characters. `:mixed` can be given for mixed case
-  characters.
-
-  Accepts `padding: false` option which will ignore padding from
-  the input string.
-
   An `ArgumentError` exception is raised if the padding is incorrect or
   a non-alphabet character is present in the string.
+
+  ## Options
+
+  The accepted options are:
+
+    * `:case` - specifies the character case to accept when decoding
+    * `:padding` - specifies whether to require padding
+
+  The values for `:case` can be:
+
+    * `:upper` - only allow upper case characters (default)
+    * `:lower` - only allow lower case characters
+    * `:mixed` - allow mixed case characters
+
+  The values for `:padding` can be:
+
+    * `true` - require the input string to be padded to the nearest multiple of 8 (default)
+    * `false` - ignore padding from the input string
 
   ## Examples
 

  @doc """
  Decodes a base 16 encoded string into a binary string.

  Accepts an atom `:upper` (default) for decoding from upper case characters or
  `:lower` for lower case characters. `:mixed` can be given for mixed case
  characters.

  ## Examples


  @doc """
  Encodes a binary string into a base 16 encoded string.

  ## Options

  The accepted options are:

    * `:case` - specifies the character case to use when encoding

  The values for `:case` can be:

    * `:upper` - use upper case characters (default)
    * `:lower` - use lower case characters

  ## Examples

