Doc fixes

Fixes #1701. Thanks baudehlo.
nodejs · Sep 14, 2011 · 69c35f9 · 69c35f9
1 parent dc8f4ee
commit 69c35f9
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/doc/api/timers.markdown b/doc/api/timers.markdown
@@ -6,6 +6,11 @@ To schedule execution of a one-time `callback` after `delay` milliseconds. Retur
 `timeoutId` for possible use with `clearTimeout()`. Optionally you can
 also pass arguments to the callback.
 
+It is important to note that your callback will probably not be called in exactly
+`delay` milliseconds - Node.js makes no guarantees about the exact timing of when
+the callback will fire, nor of the ordering things will fire in. The callback will
+be called as close as possible to the time specified.
+
 ### clearTimeout(timeoutId)
 
 Prevents a timeout from triggering.