*: fix doc strings

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();

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,