From 69c35f990fdce521795a94aa41627d0b9adb2da3 Mon Sep 17 00:00:00 2001
From: Ryan Dahl <ry@tinyclouds.org>
Date: Tue, 13 Sep 2011 20:02:54 -0700
Subject: [PATCH] Doc fixes

Fixes #1701. Thanks baudehlo.
---
 doc/api/timers.markdown | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/api/timers.markdown b/doc/api/timers.markdown
index de3f6d027be..fe89e5c1281 100644
--- 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.