Added httpfs to docs

docs/httpfs.rst

+.. automodule:: fs.httpfs
+	:members:
\ No newline at end of file

docs/index.rst

@@ -38,6 +38,7 @@ Code Documentation
    expose/index.rst
    filelike.rst
    ftpfs.rst
+   httpfs.rst
    memoryfs.rst
    mountfs.rst
    multifs.rst

fs/httpfs.py

@@ -12,10 +12,20 @@ from urllib2 import urlopen, URLError
 
 class HTTPFS(FS):
     
-    """Can barely be called a filesystem, but this enables the opener system
-    to open http files"""
+    """Can barely be called a filesystem, because HTTP servers generally don't support 
+    typical filesystem functionality. This class exists to allow the :doc:`opener` system
+    to read files over HTTP. 
+    
+    If you do need filesystem like functionality over HTTP, see :mod:`fs.contrib.davfs`.
+     
+    """
     
     def __init__(self, url):
+        """
+        
+        :param url: The base URL
+        
+        """
         self.root_url = url
         
     def _make_url(self, path):