1 files changed, 31 insertions, 0 deletions
diff --git a/tools/addon-sdk-1.7/packages/api-utils/docs/httpd.md b/tools/addon-sdk-1.7/packages/api-utils/docs/httpd.md
new file mode 100644
index 0000000..3f131f9
--- /dev/null
+++ b/tools/addon-sdk-1.7/packages/api-utils/docs/httpd.md
@@ -0,0 +1,31 @@
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+   - License, v. 2.0. If a copy of the MPL was not distributed with this
+   - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
+
+Provides an HTTP server written in JavaScript for the Mozilla platform, which 
+can be used in unit tests.
+
+The most basic usage is:
+
+    var {startServerAsync} = require("httpd");
+    var srv = startServerAsync(port, basePath);
+    require("unload").when(function cleanup() {
+      srv.stop(function() { // you should continue execution from this point.
+      })
+    });
+
+This starts a server in background (assuming you're running this code in an 
+application that has an event loop, such as Firefox). The server listens at 
+http://localhost:port/ and serves files from the specified directory. You 
+can serve static content or use SJS scripts, as described in documentation 
+on developer.mozilla.org.
+
+You can also use `nsHttpServer` to start the server manually:
+
+    var {nsHttpServer} = require("httpd");
+    var srv = new nsHttpServer();
+    // further documentation on developer.mozilla.org
+
+See 
+[HTTP server for unit tests](https://developer.mozilla.org/En/HTTP_server_for_unit_tests)
+for general information.