Update the tempfile html page

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@275784 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/CoreTasks/tempfile.html

@@ -18,7 +18,7 @@
           <td valign="bottom">
             <font size="+3" face="arial,helvetica,sanserif"><strong>Tempfile
  Task</strong></font>
-            <br><font face="arial,helvetica,sanserif">This task sets a property to  the name of a temporary file.</font>
+            <br><font face="arial,helvetica,sanserif">This task sets a property to the name of a temporary file.</font>
           </td>
           <td>
             <!-- PROJECT LOGO -->
@@ -46,34 +46,24 @@
       </td></tr>
 
       <tr><td><blockquote>
-        This task sets a property to  the name of a temporary file. 
-  Unlike the Java1.2 method to create a temporary file, this task
-  does work on Java1.1. Also, it does not actually create the
-  temporary file, but it does guarantee that the file did not
-  exist when the task was executed. 
- <p>  
- Examples
- <pre>&lt;tempfile property="temp.file" /&gt;</pre>
- create a temporary file
- <pre>&lt;tempfile property="temp.file" suffix=".xml" /&gt;</pre>
- create a temporary file with the .xml suffix.
- <pre>&lt;tempfile property="temp.file" destDir="build"/&gt;</pre>
- create a temp file in the build subdir
+        This task sets a property to the name of a temporary file. Unlike the Java1.2 method to create a temporary file, this task does work on Java1.1. Also, it does not actually create the temporary file, but it does guarantee that the file did not exist when the task was executed. <p> Examples <pre>&lt;tempfile property="temp.file" /&gt;</pre> create a temporary file <pre>&lt;tempfile property="temp.file" suffix=".xml" /&gt;</pre> create a temporary file with the .xml suffix. <pre>&lt;tempfile property="temp.file" destDir="build"/&gt;</pre> create a temp file in the build subdir
       </blockquote></td></tr>
 
     </table>
     <!-- End Description -->
 
+ <!-- Ignore -->
+
+
+
     <!-- Start Attributes -->
     <table border="0" cellspacing="0" cellpadding="2" width="100%">
       <tr><td>&nbsp;</td></tr>
-
       <tr><td bgcolor="#525D76">
         <font color="#ffffff" face="arial,helvetica.sanserif">
           <a name="attributes">
           <strong>Parameters</strong></a></font>
       </td></tr>
-
       <tr><td><blockquote>
         <table>
           <tr>
@@ -85,46 +75,51 @@
         </td>
         <td bgcolor="#cccccc" valign="top" align="left">
           <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Type</b></font>
+        </td>
+        <td bgcolor="#cccccc" valign="top" align="left">
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>Requirement</b></font>
         </td>
           </tr>
-    <!-- Attribute -->
+    <!-- Attribute Group -->    
+        <!-- Attribute -->
     <tr>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">destDir</font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">property</font>
         </td>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">
-          destination directory. If null, 
-the parent directory is used instead
-        </font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">Sets the property you wish to assign the temporary file to.</font>
         </td>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
+        </td>
+        <td bgcolor="#eeeeee" valign="top" align="left" rowspan="1">
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">Required</font>
         </td>
     </tr>
-    <!-- Attribute -->
+
+    <!-- Attribute Group -->    
+        <!-- Attribute -->
     <tr>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">prefix</font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">destdir</font>
         </td>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">
-          optional prefix string
-        </font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">Sets the destination directory. If not set, the basedir directory is used instead.</font>
         </td>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">File</font>
+        </td>
+        <td bgcolor="#eeeeee" valign="top" align="left" rowspan="3">
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">Optional</font>
         </td>
     </tr>
     <!-- Attribute -->
     <tr>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">property</font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">prefix</font>
         </td>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">
-          The property you wish to assign the temporary file to
-        </font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">Sets the optional prefix string for the temp file.</font>
         </td>
         <td bgcolor="#eeeeee" valign="top" align="left">
           <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
@@ -136,15 +131,14 @@ the parent directory is used instead
           <font color="#000000" size="-1" face="arial,helvetica,sanserif">suffix</font>
         </td>
         <td bgcolor="#eeeeee" valign="top" align="left">
-          <font color="#000000" size="-1" face="arial,helvetica,sanserif">
-          Suffix string for the temp file (optional)
-        </font>
+          <font color="#000000" size="-1" face="arial,helvetica,sanserif">Sets the optional suffix string for the temp file.</font>
         </td>
         <td bgcolor="#eeeeee" valign="top" align="left">
           <font color="#000000" size="-1" face="arial,helvetica,sanserif">String</font>
         </td>
     </tr>
 
+
         </table>
       </blockquote></td></tr>
 

src/main/org/apache/tools/ant/taskdefs/TempFile.java

@@ -104,6 +104,7 @@ public class TempFile extends Task {
      * Sets the property you wish to assign the temporary file to.
      *
      * @param  property  The property to set
+     * @ant.attribute group="required"
      */
     public void setProperty(String property) {
         this.property = property;
@@ -111,8 +112,8 @@ public class TempFile extends Task {
 
 
     /**
-     * Sets the destination directory. If null,
-     * the parent directory is used instead.
+     * Sets the destination directory. If not set,
+     * the basedir directory is used instead.
      *
      * @param  destDir  The new destDir value
      */
@@ -122,7 +123,7 @@ public class TempFile extends Task {
 
 
     /**
-     * Sets the optional prefix string.
+     * Sets the optional prefix string for the temp file.
      *
      * @param  prefix  string to prepend to generated string
      */
@@ -132,7 +133,7 @@ public class TempFile extends Task {
 
 
     /**
-     * Sets the suffix string for the temp file (optional)
+     * Sets the optional suffix string for the temp file.
      *
      * @param  suffix  suffix including any "." , e.g ".xml"
      */