add docs for latest additions

git-svn-id: http://pyfilesystem.googlecode.com/svn/trunk@395 67cdc799-7952-0410-af00-57a81ceafa0f

12 files changed, 55 insertions, 6 deletions

diff --git a/docs/contrib.rst b/docs/contrib.rst
new file mode 100644
index 0000000..f17e399
--- /dev/null
+++ b/docs/contrib.rst
@@ -0,0 +1,17 @@
+3rd-Party Filesystems
+=====================
+
+This page lists filesystem implementations that have been contributed by
+third parties.  They may be less well tested than those found in the main
+module namespace.
+
+DAV (WebDAV Protocol)
+----------------------------
+An interface to WebDAV file servers. See :mod:`fs.contrib.davfs`
+
+
+BIG (BIG Archive File Format)
+-----------------------------
+A read-only interface to the BIG archive file format used in some EA games titles (e.g. Command & Conquery 4).  See :mod:`fs.contrib.bigfs`
+
+
diff --git a/docs/contrib/bigfs.rst b/docs/contrib/bigfs.rst
new file mode 100644
index 0000000..57e5ab1
--- /dev/null
+++ b/docs/contrib/bigfs.rst
@@ -0,0 +1,2 @@
+.. automodule:: fs.contrib.bigfs
+    :members:
diff --git a/docs/contrib/davfs.rst b/docs/contrib/davfs.rst
new file mode 100644
index 0000000..9d9f5ac
--- /dev/null
+++ b/docs/contrib/davfs.rst
@@ -0,0 +1,2 @@
+.. automodule:: fs.contrib.davfs
+    :members:
diff --git a/docs/contrib/index.rst b/docs/contrib/index.rst
new file mode 100644
index 0000000..ce93302
--- /dev/null
+++ b/docs/contrib/index.rst
@@ -0,0 +1,11 @@
+fs.contrib
+=========
+
+The ``fs.contrib`` module contains a number of filesystem implementations provided by third parties.
+
+.. toctree::
+   :maxdepth: 3
+   
+   davfs.rst
+   bigfs.rst
+
diff --git a/docs/expose.rst b/docs/expose.rst
index 650c457..e4ee403 100644
--- a/docs/expose.rst
+++ b/docs/expose.rst
@@ -8,6 +8,10 @@ FUSE
 ----
 Makes an FS object available to other applications on the system. See :mod:`fs.expose.fuse`.
 
+Dokan
+-----
+Makes an FS object available to other applications on the system. See :mod:`fs.expose.dokan`.
+
 Secure FTP
 ----------
 Makes an FS object available via Secure FTP. See :mod:`fs.expose.sftp`.
diff --git a/docs/expose/dokan.rst b/docs/expose/dokan.rst
new file mode 100644
index 0000000..093f076
--- /dev/null
+++ b/docs/expose/dokan.rst
@@ -0,0 +1,2 @@
+.. automodule:: fs.expose.dokan
+    :members:
diff --git a/docs/expose/index.rst b/docs/expose/index.rst
index 0ddc111..19ee319 100644
--- a/docs/expose/index.rst
+++ b/docs/expose/index.rst
@@ -7,6 +7,7 @@ The ``fs.expose`` module contains a number of options for making an FS implement
    :maxdepth: 3
    
    fuse.rst
+   dokan.rst
    sftp.rst
    xmlrpc.rst
-   django_storage.rst
\ No newline at end of file
+   django_storage.rst
diff --git a/docs/index.rst b/docs/index.rst
index 6969ee4..7dad2e6 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -19,6 +19,7 @@ Guide
    concepts.rst
    interface.rst
    filesystems.rst
+   contrib.rst
    expose.rst
    
 Code Documentation
@@ -45,6 +46,7 @@ Code Documentation
    utils.rst
    wrapfs/index.rst
    zipfs.rst
+   contrib/index.rst
    
 
 Indices and tables
diff --git a/fs/contrib/davfs/__init__.py b/fs/contrib/davfs/__init__.py
index 622e32d..d4c3b46 100644
--- a/fs/contrib/davfs/__init__.py
+++ b/fs/contrib/davfs/__init__.py
@@ -1,8 +1,9 @@
-#  Copyright (c) 2009-2010, Cloud Matrix Pty. Ltd.
-#  All rights reserved; available under the terms of the MIT License.
 """
+fs.contrib.davfs
+================
+
 
-    fs.contrib.davfs:  FS implementation accessing a WebDAV server.
+FS implementation accessing a WebDAV server.
 
 This module provides a relatively-complete WebDAV Level 1 client that exposes
 a WebDAV server as an FS object.  Locks are not currently supported.
@@ -12,6 +13,8 @@ Requires the dexml module:
     http://pypi.python.org/pypi/dexml/
 
 """
+#  Copyright (c) 2009-2010, Cloud Matrix Pty. Ltd.
+#  All rights reserved; available under the terms of the MIT License.
 
 import os
 import httplib
diff --git a/fs/expose/dokan/__init__.py b/fs/expose/dokan/__init__.py
index 118c5dd..59fc9d6 100644
--- a/fs/expose/dokan/__init__.py
+++ b/fs/expose/dokan/__init__.py
@@ -1,6 +1,6 @@
 """
 fs.expose.dokan
-==============
+===============
 
 Expose an FS object to the native filesystem via Dokan.
 
@@ -45,6 +45,8 @@ win32, this should work without further configuration on just about all
 systems with Dokan installed.
 
 """
+#  Copyright (c) 2009-2010, Cloud Matrix Pty. Ltd.
+#  All rights reserved; available under the terms of the MIT License.
 
 import sys
 if sys.platform != "win32":
diff --git a/fs/expose/dokan/libdokan.py b/fs/expose/dokan/libdokan.py
index db1784d..a01cc0e 100644
--- a/fs/expose/dokan/libdokan.py
+++ b/fs/expose/dokan/libdokan.py
@@ -1,3 +1,5 @@
+#  Copyright (c) 2009-2010, Cloud Matrix Pty. Ltd.
+#  All rights reserved; available under the terms of the MIT License.
 """
 
   fs.expose.dokan.libdokan:  low-level ctypes interface to Dokan
diff --git a/fs/osfs/__init__.py b/fs/osfs/__init__.py
index 9540875..f66d39a 100644
--- a/fs/osfs/__init__.py
+++ b/fs/osfs/__init__.py
@@ -137,7 +137,8 @@ class OSFS(OSFSXAttrMixin, OSFSWatchMixin, FS):
         
         """
         path = os.path.normpath(os.path.abspath(path))
-        if not path.startswith(self.root_path + os.path.sep):
+        prefix = os.path.normcase(self.root_path) + os.path.sep
+        if not os.path.normcase(path).startswith(prefix):
             raise ValueError("path not within this FS: %s" % (path,))
         return path[len(self.root_path):]