move contents of readme into library docs

pkg/http_server/lib/http_server.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
+/**
+ * A library for serving HTTP requests and resources.
+ *
+ * ## Installing ##
+ *
+ * Use [pub][] to install this package. Add the following to your
+ * `pubspec.yaml` file.
+ *
+ *     dependencies:
+ *       http_server: any
+ *
+ * Then run `pub install`.
+ *
+ * For more information, see the
+ * [http_server package on pub.dartlang.org][pub].
+ *
+ * ## Basic usage
+ *
+ * Here is a short example of how to serve all files from the current
+ * directory.
+ *
+ *      import 'dart:io';
+ *      import 'dart:async';
+ *      import 'package:http_server/http_server.dart';
+ * 
+ *      void main() {
+ *        var staticFiles = new VirtualDirectory('.')
+ *          ..allowDirectoryListing = true;
+ * 
+ *        runZoned(() {
+ *          HttpServer.bind('0.0.0.0', 7777).then((server) {
+ *            print('Server running');
+ *            server.listen(staticFiles.serveRequest);
+ *          });
+ *        },
+ *        onError: (e, stackTrace) => print('Oh noes! $e $stackTrace'));
+ *     }
+ *
+ * ## Virtual directory
+ * 
+ * The [VirtualDirectory] class makes it easy to serve static content
+ * from the file system. It supports:
+ * 
+ *  *  Range-based requests.
+ *  *  If-Modified-Since based caching.
+ *  *  Automatic GZip-compression of content.
+ *  *  Following symlinks, either throughout the system or inside
+ *     a jailed root.
+ *  *  Directory listing.
+ * 
+ * See [VirtualDirectory] for more information.
+ * 
+ * ## Virtual host
+ * 
+ * The [VirtualHost] class helps to serve multiple hosts on the same
+ * address, by using the `Host` field of the incoming requests. It also
+ * works with 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] for more information.
+ *
+ * [pub]: http://pub.dartlang.org/packages/http_server
+ */
 library http_server;
 
 import 'dart:async';
 import 'dart:convert';
 import 'dart:io';
 
 import 'package:mime/mime.dart';
 import "package:path/path.dart";
 
 part 'src/http_body.dart';
 part 'src/http_body_impl.dart';
 part 'src/http_multipart_form_data.dart';
 part 'src/http_multipart_form_data_impl.dart';
 part 'src/virtual_directory.dart';
 part 'src/virtual_host.dart';