diff --git a/src/card.rs b/src/card.rs
index ae27de1..942cef5 100644
--- a/src/card.rs
+++ b/src/card.rs
@@ -94,8 +94,9 @@ pub fn all_same_rank(cards: &[PlayingCard]) -> bool {
 }
 
 /** Generate a vector of cards representing the concatenation of
- * `number_of_decks` decks of playing cards put together.  Note that each deck
- * gets two jokers - this is added to the overall vector.
+`number_of_decks` decks of playing cards put together.
+
+Note that each deck gets two jokers - this is added to the overall vector.
  */
 pub fn make_decks(number_of_decks: usize) -> Vec<Card> {
     let number_of_decks: i64 = number_of_decks.try_into().unwrap();
diff --git a/src/modes/mod.rs b/src/modes/mod.rs
index cea40a4..40a2e69 100644
--- a/src/modes/mod.rs
+++ b/src/modes/mod.rs
@@ -16,7 +16,7 @@ mod tests {
     use super::*;
 
     /** Given two hands, assert that their footstool condition is non-reflexive.
-     * Return the results of the two footstool checks (x on y, y on x).
+    Return the results of the two footstool checks (x on y, y on x).
      */
     pub fn test_non_reflexivity<T: Hand + Copy>(
         x: &T,