-

cool-RR · cool-RR · commit be00bb9b40dd · 2014-10-19T21:54:04.000+03:00
diff --git a/source_py3/python_toolbox/math_tools/factorials.py b/source_py3/python_toolbox/math_tools/factorials.py
@@ -113,8 +113,7 @@ def to_factoradic(number, n_digits_pad=0):
     current_number = number
     for i in range(n_digits)[::-1]:
         unit = math.factorial(i)
-        digits[n_digits - i - 1], current_number = \
-                                                   divmod(current_number, unit)
+        digits[n_digits - i - 1], current_number = divmod(current_number, unit)
     result = tuple(digits)
     if (len(result) < n_digits_pad):
         return ((0,) * (n_digits_pad - len(result))) + result
diff --git a/source_py3/python_toolbox/math_tools/misc.py b/source_py3/python_toolbox/math_tools/misc.py
@@ -119,6 +119,12 @@ def restrict_number_to_range(number, low_cutoff=-infinity,
         
         
 def binomial(big, small):
+    '''
+    Get the binomial coefficient (big small).
+    
+    This is used in combinatorical calculations. More information:
+    http://en.wikipedia.org/wiki/Binomial_coefficient
+    '''
     if big == small:
         return 1
     if big < small:
@@ -129,11 +135,17 @@ def binomial(big, small):
 
 
 def product(numbers):
+    '''Get the product of all the numbers in `numbers`.'''
     from python_toolbox import misc_tools
     return misc_tools.general_product(numbers, start=1)
     
     
 def is_integer(x):
+    '''
+    Is `x` an integer?
+    
+    Does return `True` for things like 1.0 and `1+0j`.
+    '''
     try:
         inted_x = int(x)
     except (TypeError, ValueError, OverflowError):
