diff --git a/doc/api.txt b/doc/api.txt
index 8b439cc963..ecc55a9727 100644
--- a/doc/api.txt
+++ b/doc/api.txt
@@ -1432,8 +1432,13 @@ tcp.createServer(function (c) {
 }).listen(5000);
 repl.start("simple tcp server> ");
 ------------------------------------
-
-
+The repl provides access to any variables in the global scope. You can expose a variable 
+to the repl explicitly by assigning it to the +repl.scope+ object:
+------------------------------------
+var count = 5;
+repl.start();
+repl.scope.count = count;
+------------------------------------
 
 == Addons