[cookbook] move code comments into pod

Author: paultcochrane

categories/cookbook/02numbers/02-01valid-number.pl

@@ -8,23 +8,22 @@
 
 You want to check if a string is a valid number.
 
-  # Most of the time you will not need to do this.  Rather then testing
-  # for a scalar's numerical nature you can ensure that the variable
-  # contains a number by setting its type.  Assigning a number to
-  # that variable will cause it to be coerced into an integer or a
-  # number.
+Most of the time you will not need to do this.  Rather then testing for a
+scalar's numerical nature you can ensure that the variable contains a number
+by setting its type.  Assigning a number to that variable will cause it to
+be coerced into an integer or a number.
 
-  # Ensure that a variable is used to store a real number.
+Ensure that a variable is used to store a real number.
 
   my Num $number;
 
-  # Ensure that a variable is used to store an integer.
+Ensure that a variable is used to store an integer.
 
   my Int $integer;
 
-  # Sometimes you need to validate a string from some source
-  # corresponds to a real or an integer.  In this situation compare
-  # it against the rule for integers or reals.
+Sometimes you need to validate a string from some source corresponds to a
+real or an integer.  In this situation compare it against the rule for
+integers or reals.
 
 =end pod