From 67b3c4b31f10845d0713c3891c77f07f70ffe04c Mon Sep 17 00:00:00 2001
From: apense <apense@users.noreply.github.com>
Date: Wed, 24 Jun 2015 03:33:48 -0400
Subject: [PATCH] Added documentation for mod

Along with a brief example for sign demonstration
---
 lib/pure/math.nim | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/pure/math.nim b/lib/pure/math.nim
index 494dfc4c81..7a88694b5a 100644
--- a/lib/pure/math.nim
+++ b/lib/pure/math.nim
@@ -318,6 +318,12 @@ else:
 {.pop.}
 
 proc `mod`*(x, y: float): float =
+  ## Computes the modulo operation for float operators. Equivalent
+  ## to ``x - y * floor(x/y)``. Note that the remainder will always
+  ## have the same sign as the divisor.
+  ## 
+  ## .. code-block:: nim
+  ##  echo (4.0 mod -3.1) # -2.2
   result = if y == 0.0: x else: x - y * (x/y).floor
 
 proc random*[T](x: Slice[T]): T =