lib/hcl/utility.rb in zenhob-hcl-0.2.2 vs lib/hcl/utility.rb in zenhob-hcl-0.2.3

@@ -1,17 +1,24 @@
 module HCl
   module Utility
     # Convert from decimal to a string of the form HH:MM.
+    #
+    # @param [#to_f] hours number of hours in decimal
+    # @return [String] of the form "HH:MM"
     def as_hours hours
       minutes = hours.to_f * 60.0
       sprintf "%d:%02d", (minutes / 60).to_i, (minutes % 60).to_i
     end
 
+    # Convert from a time span in hour or decimal format to a float.
+    #
+    # @param [String] time_string either "M:MM" or decimal
+    # @return [#to_f] converted to a floating-point number
     def time2float time_string
       if time_string =~ /:/
         hours, minutes = time_string.split(':')
         hours.to_f + (minutes.to_f / 60.0)
-      elsif time_string =~ /./
+      else
         time_string.to_f
       end
     end
   end
 end