Return-Path: 
 <commons-dev-return-71393-apmail-jakarta-commons-dev-archive=jakarta.apache.org@jakarta.apache.org>
Delivered-To: apmail-jakarta-commons-dev-archive@www.apache.org
Received: (qmail 76898 invoked from network); 18 May 2005 19:13:43 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 18 May 2005 19:13:43 -0000
Received: (qmail 51619 invoked by uid 500); 18 May 2005 18:29:27 -0000
Delivered-To: apmail-jakarta-commons-dev-archive@jakarta.apache.org
Received: (qmail 51539 invoked by uid 500); 18 May 2005 18:29:25 -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-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 51395 invoked by uid 500); 18 May 2005 18:29:22 -0000
Received: (qmail 51138 invoked by uid 99); 18 May 2005 18:29:20 -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, 18 May 2005 11:29:18 -0700
Received: (qmail 56982 invoked by uid 65534); 18 May 2005 18:29:10 -0000
Message-ID: <20050518182910.56981.qmail@minotaur.apache.org>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Subject: svn commit: r170789 - in /jakarta/commons/sandbox/vfs/trunk/xdocs:
 download.xml filesystems.xml
Date: Wed, 18 May 2005 18:29:10 -0000
To: commons-cvs@jakarta.apache.org
From: imario@apache.org
X-Mailer: svnmailer-1.0.0-dev
X-Virus-Checked: Checked
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Author: imario
Date: Wed May 18 11:29:09 2005
New Revision: 170789

URL: http://svn.apache.org/viewcvs?rev=3D170789&view=3Drev
Log:
added tar, tbz2, tgz and res documentation
updated dependency ist

Modified:
    jakarta/commons/sandbox/vfs/trunk/xdocs/download.xml
    jakarta/commons/sandbox/vfs/trunk/xdocs/filesystems.xml

Modified: jakarta/commons/sandbox/vfs/trunk/xdocs/download.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/xdocs/=
download.xml?rev=3D170789&r1=3D170788&r2=3D170789&view=3Ddiff
=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/download.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/xdocs/download.xml Wed May 18 11:29:0=
9 2005
@@ -80,6 +80,14 @@
                     </td>
                     <td>SFTP</td>
                 </tr>
+                <tr>
+                    <td>
+                        <a href=3D"http://jakarta.apache.org/commons/sandb=
ox/compress/">Commons Compress</a> Nightly build 20040530<br />
+                        There are no other nigtlies than the one I created=
 for maven, so please download it from the link below until this changes:<b=
r/>
+                        <a href=3D"http://www.ibiblio.org/maven/commons-co=
mpress/jars/commons-compress-20040530.jar">http://www.ibiblio.org/maven/com=
mons-compress/jars/commons-compress-20040530.jar</a>
+                    </td>
+                    <td>tar, bz2</td>
+                </tr>
             </table>
         </section>
         <section name=3D"Building Commons VFS">

Modified: jakarta/commons/sandbox/vfs/trunk/xdocs/filesystems.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/xdocs/=
filesystems.xml?rev=3D170789&r1=3D170788&r2=3D170789&view=3Ddiff
=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/filesystems.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/xdocs/filesystems.xml Wed May 18 11:2=
9:09 2005
@@ -32,11 +32,14 @@
                     <a href=3D"#WebDAV">WebDAV</a>
                 </li>
                 <li>
-                    <a href=3D"#Zip and Jar">Zip and Jar</a>
+                    <a href=3D"#Zip, Jar and Tar">Zip, Jar and Tar (uncomp=
ressed, tgz or tbz2)</a>
                 </li>
                 <li>
                     <a href=3D"#gzip and bzip2">gzip and bzip2</a>
                 </li>
+                <li>
+                    <a href=3D"#res">res</a>
+                </li>
             </ul>
         </section>
=20
@@ -107,9 +110,9 @@
             </ul>
         </section>
=20
-        <section name=3D"Zip and Jar">
+        <section name=3D"Zip, Jar and Tar">
=20
-            <p>Provides read-only access to the contents of Zip and Jar fi=
les.</p>
+            <p>Provides read-only access to the contents of Zip, Jar and T=
ar files.</p>
=20
             <p>
                 <b>URI Format</b>
@@ -117,23 +120,42 @@
=20
             <p>
                 <code>zip://
-                    <i>zip-file-uri</i>[!
+                    <i>arch-file-uri</i>[!
                     <i>absolute-path</i>]
                 </code>
             </p>
             <p>
                 <code>jar://
-                    <i>zip-file-uri</i>[!
+                    <i>arch-file-uri</i>[!
+                    <i>absolute-path</i>]
+                </code>
+            </p>
+            <p>
+                <code>tar://
+                    <i>arch-file-uri</i>[!
+                    <i>absolute-path</i>]
+                </code>
+            </p>
+            <p>
+                <code>tgz://
+                    <i>arch-file-uri</i>[!
+                    <i>absolute-path</i>]
+                </code>
+            </p>
+            <p>
+                <code>tbz2://
+                    <i>arch-file-uri</i>[!
                     <i>absolute-path</i>]
                 </code>
             </p>
=20
             <p>
                 Where
-                <code>zip-file-uri</code> refers to a file of any
+                <code>arch-file-uri</code> refers to a file of any
                 supported type, including other zip files.  Note: if you w=
ould like
                 to use the ! as normal character it must be escaped
-                using <code>%21</code>.
+                using <code>%21</code>.<br />
+                <code>tgz</code> and <code>tbz2</code> are convenience for=
 <code>tar:gz</code> and <code>tar:bz2</code>.
             </p>
=20
             <p>
@@ -152,6 +174,12 @@
                 <li>
                     <code>jar:zip:outer.zip!/nested.jar!/some%21dir</code>
                 </li>
+                <li>
+                    <code>tar:gz:http://anyhost/dir/mytar.tar.gz!/mytar.ta=
r!/path/in/tar/README.txt</code>
+                </li>
+                <li>
+                    <code>tgz:file://anyhost/dir/mytar.tgz!/somepath/somef=
ile</code>
+                </li>
             </ul>
=20
         </section>
@@ -380,6 +408,36 @@
             <ul>
                 <li>
                     <code>tmp://dir/somefile.txt</code>
+                </li>
+            </ul>
+        </section>
+
+        <section name=3D"res">
+
+            <p>
+                This is not really a filesystem, it just tries to lookup a=
 resource using javas <code>ClassLoader.getResource()</code>
+                and creates a VFS url for further processing.
+            </p>
+
+            <p>
+                <b>RES Format</b>
+            </p>
+
+            <p>
+                <code>res://[
+                    <i>path</i>]
+                </code>
+            </p>
+
+            <p>
+                <b>Examples</b>
+            </p>
+
+            <ul>
+                <li>
+                    <code>res:path/in/classpath/image.png</code><br/>
+                    might result in
+                    <code>jar:file://my/path/to/images.jar!/path/in/classp=
ath/image.png</code><br/>
                 </li>
             </ul>
         </section>



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