Return-Path: 
 <commons-dev-return-69706-apmail-jakarta-commons-dev-archive=jakarta.apache.org@jakarta.apache.org>
Delivered-To: apmail-jakarta-commons-dev-archive@www.apache.org
Received: (qmail 912 invoked from network); 30 Mar 2005 23:20:41 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 30 Mar 2005 23:20:41 -0000
Received: (qmail 55592 invoked by uid 500); 30 Mar 2005 23:20:39 -0000
Delivered-To: apmail-jakarta-commons-dev-archive@jakarta.apache.org
Received: (qmail 55252 invoked by uid 500); 30 Mar 2005 23:20:37 -0000
Mailing-List: contact commons-dev-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:commons-dev-unsubscribe@jakarta.apache.org>
List-Subscribe: <mailto:commons-dev-subscribe@jakarta.apache.org>
List-Help: <mailto:commons-dev-help@jakarta.apache.org>
List-Post: <mailto:commons-dev@jakarta.apache.org>
List-Id: "Jakarta Commons Developers List" <commons-dev.jakarta.apache.org>
Reply-To: "Jakarta Commons Developers List" <commons-dev@jakarta.apache.org>
Delivered-To: mailing list commons-dev@jakarta.apache.org
Received: (qmail 55239 invoked by uid 500); 30 Mar 2005 23:20:37 -0000
Received: (qmail 55235 invoked by uid 99); 30 Mar 2005 23:20:37 -0000
X-ASF-Spam-Status: No, hits=-9.8 required=10.0
	tests=ALL_TRUSTED,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received: from minotaur.apache.org (HELO minotaur.apache.org)
 (209.237.227.194)
  by apache.org (qpsmtpd/0.28) with SMTP; Wed, 30 Mar 2005 15:20:37 -0800
Received: (qmail 842 invoked by uid 65534); 30 Mar 2005 23:20:36 -0000
Message-ID: <20050330232036.841.qmail@minotaur.apache.org>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
X-Mailer: svnmailer-1.0.0-dev
Date: Wed, 30 Mar 2005 23:20:36 -0000
Subject: svn commit: r159541 - in jakarta/commons/sandbox/vfs/trunk/xdocs:
 api.xml
 index.xml
To: commons-cvs@jakarta.apache.org
From: imario@apache.org
X-Virus-Checked: Checked
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Author: imario
Date: Wed Mar 30 15:20:34 2005
New Revision: 159541

URL: http://svn.apache.org/viewcvs?view=3Drev&rev=3D159541
Log:
document /META-INF/vfs-providers.xml

Modified:
    jakarta/commons/sandbox/vfs/trunk/xdocs/api.xml
    jakarta/commons/sandbox/vfs/trunk/xdocs/index.xml

Modified: jakarta/commons/sandbox/vfs/trunk/xdocs/api.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/xdocs/=
api.xml?view=3Ddiff&r1=3D159540&r2=3D159541
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
--- jakarta/commons/sandbox/vfs/trunk/xdocs/api.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/xdocs/api.xml Wed Mar 30 15:20:34 2005
@@ -62,24 +62,9 @@
=20
             <subsection name=3D"Cache">
                 <p>
-                    By default every resolved file will be cached in an ma=
p and - unhappily - it will never be released.
-                    This is what
-                    <a href=3D"apidocs/org/apache/commons/vfs/cache/SoftRe=
fFilesCache.html">SoftRefFilesCache</a>
-                    tries to address.
+                    Commons VFS uses a <a href=3D"apidocs/org/apache/commo=
ns/vfs/cache/SoftRefFilesCache.html">SoftRefFilesCache</a> to release memor=
y if a file is no longer used by the application.
                 </p>
                 <p>
-                    Currently you could not use VFS.getManager() to use th=
is sort of cache, instead you have to create
-                    your own FileSytemManager instance.
-                </p>
-                <source><![CDATA[
-private static FileSystemManager manager;
-
-manager =3D new StandardFileSystemManager();
-manager.setFilesCache(new SoftRefFilesCache());
-manager.init();
-                    ]]></source>
-
-                <p>
                     This cache will return the same instance for a file as=
 long as it is "strongly reachable" e.g. you
                     hold a reference to this object. If the FileObject is =
no longer reachable, and the jvm needs some memory,
                     it will be released.
@@ -109,6 +94,15 @@
                 <a href=3D"apidocs/org/apache/commons/vfs/VFS.html#getMana=
ger()">VFS.getManager()</a>
                 method, which returns the default Commons VFS implementati=
on.
             </p>
+            <p>
+                This method will also automatically scan the classpath for=
 a /META-INF/vfs-providers.xml file
+                (also in jar files).
+                If such a file is found Commons VFS uses it in <u>addition=
</u> to the default providers.xml.
+                This allows you to start using a new filesystem by simply =
drop its implementation into the classpath.
+                The configuration file format is described below.<br />
+                <b>Notice:</b> Currently it is not allowed to override a a=
lready configured filesystem. Commons VFS throws
+                an exception if there is already a filesystem for a scheme.
+            </p>
=20
             <p>
                 To configure Commons VFS programatically, you can create an
@@ -178,16 +172,6 @@
                 <code>setConfiguration()</code> method to set the
                 location of the configuration file to use.  The configurat=
ion
                 file format is described below.
-            </p>
-
-            <p>
-                The fourth method is in addition to the default providers.=
xml.
-                This method automatically scans the classpath for a /META-=
INF/vfs-providers.xml file (even if it is within an jar).
-                If such a file is found Commons VFS uses it in addition to=
 the default.
-                This allows you to start using a new filesystem by simply =
drop its implementation into the classpath.
-                The configuration file format is described below.<br />
-                <b>Notice:</b> Currently it is not allowed to override a a=
lready configured filesystem. Commons VFS throws
-                an exception if there is already a filesystem for a scheme=
.=20
             </p>
=20
             <p>

Modified: jakarta/commons/sandbox/vfs/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/xdocs/=
index.xml?view=3Ddiff&r1=3D159540&r2=3D159541
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D
--- jakarta/commons/sandbox/vfs/trunk/xdocs/index.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/xdocs/index.xml Wed Mar 30 15:20:34 2=
005
@@ -47,7 +47,7 @@
         </section>
=20
         <section name=3D"News">
-            <p>2005-03 - imario@apache.org: easier configuration for plugi=
ns</p>
+            <p>2005-03 - imario@apache.org: easier configuration for plugi=
ns - see api section for details</p>
=20
             <p>2005-03 - imario@apache.org: The filename parsing and api h=
as changed.
             <ul>



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org