cvs commit: jakarta-ant/src/main/org/apache/tools/ant/types Path.java

[bo...@locus.apache.org]

bodewig     00/08/03 02:00:40

  Modified:    docs     index.html
               src/main/org/apache/tools/ant/types Path.java
  Log:
  Some documentation patches.
  Submitted by:	Barrie Treloar <Ba...@camtech.com.au>,
                  Jesse Glick <Je...@netbeans.com>
  
  Revision  Changes    Path
  1.63      +3 -0      jakarta-ant/docs/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/index.html,v
  retrieving revision 1.62
  retrieving revision 1.63
  diff -u -r1.62 -r1.63
  --- index.html	2000/08/03 08:46:27	1.62
  +++ index.html	2000/08/03 09:00:32	1.63
  @@ -1158,6 +1158,7 @@
   <p>Unzips a zip- or jarfile.</p>
   <p>For JDK 1.1 "last modified time" field is set to current time instead of being 
   carried from zipfile.</p>
  +<p>File permissions will not be restored on extracted files.</a>
   <p>DEPRECATION: the expand task simply points to the unzip task and it's
   there for back compatibility reasons.</p>
   <h3>Parameters</h3>
  @@ -1589,6 +1590,7 @@
   <h3>Description</h3>
   <p>Jars a set of files.</p>
   <p>The <i>basedir</i> attribute is the reference directory from where to jar.</p>
  +<p>Note that file permissions will not be stored in the resulting jarfile.</p>
   <p>It is possible to refine the set of files that are being jarred. This can be
   done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i>
   attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to
  @@ -3164,6 +3166,7 @@
   <h3>Description</h3>
   <p>Creates a zipfile.</p>
   <p>The <i>basedir</i> attribute is the reference directory from where to zip.</p>
  +<p>Note that file permissions will not be stored in the resulting zipfile.</p>
   <p>It is possible to refine the set of files that are being zipped. This can be
   done with the <i>includes</i>, <i>includesfile</i>, <i>excludes</i>, <i>excludesfile</i> and <i>defaultexcludes</i>
   attributes. With the <i>includes</i> or <i>includesfile</i> attribute you specify the files you want to
  
  
  
  1.3       +8 -8      jakarta-ant/src/main/org/apache/tools/ant/types/Path.java
  
  Index: Path.java
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/src/main/org/apache/tools/ant/types/Path.java,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- Path.java	2000/08/02 09:24:23	1.2
  +++ Path.java	2000/08/03 09:00:39	1.3
  @@ -68,18 +68,18 @@
   /**
    * This object represents a path as used by CLASSPATH or PATH
    * environment variable.
  - *
  + * <p>
    * <code>
    * &lt;sometask&gt;<br>
  - * &nbsp;&nbsp;&lt;somepath&gt;
  - * &nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement location="/path/to/file.jar" /&gt;
  - * &nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement path="/path/to/file2.jar:/path/to/class2;/path/to/class3" /&gt;
  - * &nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement location="/path/to/file3.jar" /&gt;
  - * &nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement location="/path/to/file4.jar" /&gt;
  - * &nbsp;&nbsp;&lt;/somepath&gt;
  + * &nbsp;&nbsp;&lt;somepath&gt;<br>
  + * &nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement location="/path/to/file.jar" /&gt;<br>
  + * &nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement path="/path/to/file2.jar:/path/to/class2;/path/to/class3" /&gt;<br>
  + * &nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement location="/path/to/file3.jar" /&gt;<br>
  + * &nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement location="/path/to/file4.jar" /&gt;<br>
  + * &nbsp;&nbsp;&lt;/somepath&gt;<br>
    * &lt;/sometask&gt;<br>
    * </code>
  - *
  + * <p>
    * The object implemention <code>sometask</code> must provide a method called
    * <code>createSomepath</code> which returns an instance of <code>Path</code>.
    * Nested path definitions are handled by the Path object and must be labeled