ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: jakarta-ant/proposal/myrmidon/src/xdocs vfs.xml
Date Sat, 02 Mar 2002 01:32:11 GMT
donaldp     02/03/01 17:32:11

  Added:       proposal/myrmidon/src/xdocs vfs.xml
  Extract the VFS stuff from user.xml
  Revision  Changes    Path
  1.1                  jakarta-ant/proposal/myrmidon/src/xdocs/vfs.xml
  Index: vfs.xml
          <author email="">Adam Murdoch</author>
          <title>VFS User Guide</title>
          <section name="Handling Files">
              <p>Myrmidon includes a Virtual File System (VFS), which allows files from
              different sources to be treated identically.  The VFS currently supports
              the following file types:</p>
                  <tr><th>File System</th><th>Description</th><th>URL
                      <td>Local Files</td>
                      <td>Files on the local file system.</td>
                      <td>Three different formats are currently supported for local
file names:
                              <li><code>file://</code> <i>absolute-file-name</i></li>
                              <li>Absolute file names</li>
                              <li>Relative file names.  These are resolved relative
to the
                              project's base directory.
                      <td>Zip Files</td>
                      <td>The contents of Zip files (and Jar, War, and Ear files).
                      Currently, the VFS supports read-only access to Zip file contents,
                      and only for local Zip files.</td>
                      <td><code>zip://</code> <i>zip-file-path</i>
                      <td>Files on an FTP server.</td>
                      <td><code>ftp://</code> [[<i>password</i><code>:</code>]
<i>username</i><code>@</code>] <i>hostname</i> [<code>:</code><i>port</i>]
                      <td>Files on a CFIS server, such as Samba or Windows shares.</td>
                      <td><code>smb://</code> [[<i>password</i><code>:</code>]
<i>username</i><code>@</code>] <i>hostname</i> [<code>:</code><i>port</i>]
              <p>Here are some example URLs:</p>
                  <li><code>c:\program files\ant\bin</code></li>
                  <li><code>file://C:/program files/ant</code></li>
              <p>Currently, there are only a handful of VFS aware tasks.  This will
              as more tasks are ported to the new API, and data types.</p>
              <subsection name="File Sets">
                  <p>A file set in Myrmidon is more general than Ant 1's concept of
a file set.
                  Firstly, there is more than one type of file set.  Secondly, they are VFS
                  File sets are automatically converted to a <a href="#Paths">path</a>,
and so
                  can be used anywhere that a path can.</p>
                  <p>This is the equivalent of Ant 1's <code>&lt;fileset&gt;</code>
(The name
                  is temporary, it will be changed to <code>&lt;fileset&gt;</code>
once more
                  porting work as been completed).</p>
                  <p>Rather than use a set of include and exclude patterns to choose
the files
                  that make up the file set, <code>&lt;v-fileset&gt;</code>
takes zero or more
                  <a href="#File Selectors">file selectors</a>.  File selectors
can be used to
                  select files based on any attribute of the file, rather than just the name.
                  You can use <code>&lt;name&gt;</code> selectors to achieve
the same result
                  as using includes or excludes.</p>
                  <p>A <code>&lt;v-fileset&gt;</code> element takes
the following attributes:</p>
                          <td>The base directory for the file set.  This can be any
URL that the
                          VFS supports.</td>
                  <p>A <code>&lt;v-fileset&gt;</code> element takes
any number of nested
                  <a href="#File Selectors">file selector</a> elements.  To be
included in the
                  file set, a file must be selected by all the file selectors.  That is, the
                  file selectors are implicitly AND-ed together.  If no file selector is provided,
                  all the files and directories are included in the set.</p>
                  <p>An example:</p>
                  <v-fileset dir="src">
                      <name pattern="org/apache/tools/ant/**"/>
                  <p>This file set takes a set of nested file sets and paths, and flattens
                  into a single directory.  It can be used as a way of converting a path into
                  file set.  It can also be used as a replacement for the <code>flatten</code>
                  attribute for the copy and move tasks.</p>
                  <p>A <code>&lt;flat-fileset&gt;</code> element
takes no attributes, and a set
                  of nested paths or file sets.</p>
                  <p>An example:</p>
  <v-copy todir="dist/lib">
      <v-fileset dir="build/lib">
        <basename pattern="*.jar"/>
      <v-path path="${classpath}"/>
              <subsection name="Paths">
                  <p>Paths are an ordered list of files.</p>
                  <p>This is the equivalent of Ant 1's <code>&lt;path&gt;</code>.</p>
                  <p>A path that applies file selectors to a set of nested file sets
and paths.</p>
              <subsection name="File Selectors">
                  <p>File selectors are used to select files from file sets and paths.</p>
                  <p>Combines zero or more file selectors, using AND. An empty <code>&lt;and&gt;</code>
                  selector accepts all files.</p>
                  <p>Selects files whose base name matches an Ant 1 style pattern, or
a regular
                  <p>Selects files that exist.</p>
                  <p>Selects empty folders, that is, folders that have no children.</p>
                  <p>Selects folders, does not select regular files.</p>
                  <p>Selects regular files, does not select folders.</p>
                  <p>Selects files whose path in a file set matches an Ant 1 style pattern,
                  a regular expression.</p>
                  <p>Selects files that are not selected by a nested file selector.</p>
                  <p>Combines zero or more file selectors, using OR. An empty <code>&lt;or&gt;</code>
                  selector accepts all files.</p>
                  <p>Selects files whose URL matches an Ant 1 style pattern, or a regular

To unsubscribe, e-mail:   <>
For additional commands, e-mail: <>

View raw message