Add README file for http_server package.

pkg/http_server/README.md

Index: pkg/http_server/README.md
diff --git a/pkg/http_server/README.md b/pkg/http_server/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..2f1925fb1f9392da9d4a6abec248932711d93425
--- /dev/null
+++ b/pkg/http_server/README.md
@@ -0,0 +1,40 @@
+Library of HTTP server classes.
+
+This package contains a set of high-level classes that, together with
+HttpServer, makes is easy to provide content through HTTP servers.
+
+## Virtual Directory
+
+The VirtualDirectory class makes it possible to easy serve static content from the

[Søren Gjesse, 2013/10/21 09:00:05]

Long line.

[Anders Johnsen, 2013/10/21 09:19:48]

Done.

+drive. It supports

[Søren Gjesse, 2013/10/21 09:00:05]

Colon after suports.

[Anders Johnsen, 2013/10/21 09:19:48]

Done.

+
+ *  Range-based request, making it possible to pause/resume downloads and stream
+    videos.
+ *  If-Modified-Since based caching.
+ *  Automatic GZip-compression of content.
+ *  Ability to follow links within, either throughout the system or in a jailed
+    root.
+ *  Optional directory listing.
+
+ The following example shows how to set up a Virtual Directory of a given path
+
+    var virtualDirectory = new VirtualDirectory('/var/www/');
+    virtualDirectory.serve(new HttpServer('0.0.0.0', 8080));
+
+See [VirtualDirectory](http://api.dartlang.org/docs/http_server/VirtualDirectory.html) for more info about how to customize the class.

[Søren Gjesse, 2013/10/21 09:00:05]

Can this line be broken?

[Anders Johnsen, 2013/10/21 09:19:48]

Done.

+
+## Virtual Host
+
+The VirtualHost class makes it possible to serve multiple hosts on the same
+address, by using the `Host` field of the incoming requests. It also provides
+the ability to work on wildcards for sub-domains.
+
+    var virtualHost = new VirtualHost(server);
+    // Filter out on a specific host
+    var stream1 = virtualServer.addHost('static.myserver.com');
+    // Wildcard for any other sub-domains.
+    var stream2 = virtualServer.addHost('*.myserver.com');
+    // Requets not matching any hosts.
+    var stream3 = virtualServer.unhandled;
+
+See [VirtualHost](http://api.dartlang.org/docs/http_server/VirtualHost.html) for more information.