* Add pointer to "pack"

* Add FAQ on how to get your task listed.

Submitted by:	Cristiano Sadun <cristiano at xtractor dot com>


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

docs/external.html

@@ -1995,6 +1995,77 @@
         </table>
                     </blockquote>
     </td></tr>
+  </table>
+                                  <table border="0" cellspacing="0" cellpadding="2" width="100%">
+    <tr><td bgcolor="#828DA6">
+      <font color="#ffffff" face="arial,helvetica,sanserif">
+        <a name="pack"><strong>pack</strong></a>
+      </font>
+    </td></tr>
+    <tr><td>
+      <blockquote>
+                        <p>pack is a task to build the smallest possible JAR to link
+        and run one or more classes.</p>
+                                  <table>
+              <tr>
+                  <td bgcolor="#039acc" colspan="" rowspan="" 
+      valign="top" align="left">
+    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+          Compatibility:
+        </font>
+  </td>
+                      <td bgcolor="#a0ddf0" colspan="" rowspan="" 
+      valign="top" align="left">
+    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+          Ant 1.5
+        </font>
+  </td>
+      </tr>
+                  <tr>
+                  <td bgcolor="#039acc" colspan="" rowspan="" 
+      valign="top" align="left">
+    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+          URL:
+        </font>
+  </td>
+                      <td bgcolor="#a0ddf0" colspan="" rowspan="" 
+      valign="top" align="left">
+    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+          <a href="http://sadun-util.sourceforge.net/pack.html">http://sadun-util.sourceforge.net/pack.html</a>
+        </font>
+  </td>
+      </tr>
+                  <tr>
+                  <td bgcolor="#039acc" colspan="" rowspan="" 
+      valign="top" align="left">
+    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+          Contact:
+        </font>
+  </td>
+                      <td bgcolor="#a0ddf0" colspan="" rowspan="" 
+      valign="top" align="left">
+    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+          <a href="mailto:cristiano@xtractor.com">Cristiano Sadun</a>
+        </font>
+  </td>
+      </tr>
+                  <tr>
+                  <td bgcolor="#039acc" colspan="" rowspan="" 
+      valign="top" align="left">
+    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+          License:
+        </font>
+  </td>
+                      <td bgcolor="#a0ddf0" colspan="" rowspan="" 
+      valign="top" align="left">
+    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+          GNU Lesser General Public License
+        </font>
+  </td>
+      </tr>
+        </table>
+                    </blockquote>
+    </td></tr>
   </table>
                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">
     <tr><td bgcolor="#828DA6">

docs/faq.html

@@ -172,6 +172,10 @@
     <tr><td>
       <blockquote>
         <ul>
+                    <li><a href="#adding-external-tasks">
+  How do I add an external task that I've written to the
+      page "External Tools and Task"?
+  </a></li>
                     <li><a href="#passing-cli-args">
   How do I pass parameters from the command line to my
         build file?
@@ -631,7 +635,43 @@
     </td></tr>
   </table>
   </a>
-                        <a name="passing-cli-args">
+                        <a name="adding-external-tasks">
+  <table border="0" cellspacing="0" cellpadding="2" width="100%">
+    <tr><td bgcolor="#828DA6">
+      <font color="#ffffff" face="arial,helvetica,sanserif">
+        <strong>
+          How do I add an external task that I've written to the
+      page "External Tools and Task"?
+        </strong>
+      </font>
+    </td></tr>
+    <tr><td>
+      <blockquote>
+                              <p>Join and post a message to the ant-dev or ant-user mailing
+        list (one list is enough), including the following
+        information:</p>
+                                        <ul>
+          <li>the name of the task/tool</li>
+          <li>a short description of the task/tool</li>
+          <li>a Compatibility: entry stating with which version(s) of
+          Ant the tool/task is compatible to</li>
+          <li>a URL: entry linking to the main page of the tool/task</li>
+          <li>a Contact: entry containing the email address or the URL
+          of a webpage for the person or list to contact for issues
+          related to the tool/task.  <strong>Note that we'll add a
+          link on the page, so any email address added there is not
+          obfuscated and can (and probably will) be abused by robots
+          harvesting websites for addresses to spam.</strong></li>
+          <li>a License: entry containing the type of license for the
+          tool/task</li>
+        </ul>
+                                        <p>The preferred format for this information is a patch to <a href="http://cvs.apache.org/viewcvs.cgi/~checkout~/jakarta-ant/xdocs/external.xml">this</a>
+        document.</p>
+                        </blockquote>
+    </td></tr>
+  </table>
+  </a>
+        <a name="passing-cli-args">
   <table border="0" cellspacing="0" cellpadding="2" width="100%">
     <tr><td bgcolor="#828DA6">
       <font color="#ffffff" face="arial,helvetica,sanserif">

xdocs/external.xml

@@ -741,6 +741,31 @@
         </table>
       </subsection>
 
+      <subsection name="pack">
+
+        <p>pack is a task to build the smallest possible JAR to link
+        and run one or more classes.</p>
+
+        <table>
+          <tr>
+            <th>Compatibility:</th>
+            <td>Ant 1.5</td>
+          </tr>
+          <tr>
+            <th>URL:</th>
+            <td><a href="http://sadun-util.sourceforge.net/pack.html">http://sadun-util.sourceforge.net/pack.html</a></td>
+          </tr>
+          <tr>
+            <th>Contact:</th>
+            <td><a href="mailto:cristiano@xtractor.com">Cristiano Sadun</a></td>
+          </tr>
+          <tr>
+            <th>License:</th>
+            <td>GNU Lesser General Public License</td>
+          </tr>
+        </table>
+      </subsection>
+
       <subsection name="PMD">
 
         <p>PMD checks Java source code for unused variables,

xdocs/faq.xml

@@ -180,6 +180,39 @@
   </faqsection>
 
   <faqsection title="How do I ...">
+    <faq id="adding-external-tasks">
+      <question>How do I add an external task that I've written to the
+      page &quot;External Tools and Task&quot;?</question>
+      <answer>
+
+        <p>Join and post a message to the ant-dev or ant-user mailing
+        list (one list is enough), including the following
+        information:</p>
+
+        <ul>
+          <li>the name of the task/tool</li>
+          <li>a short description of the task/tool</li>
+          <li>a Compatibility: entry stating with which version(s) of
+          Ant the tool/task is compatible to</li>
+          <li>a URL: entry linking to the main page of the tool/task</li>
+          <li>a Contact: entry containing the email address or the URL
+          of a webpage for the person or list to contact for issues
+          related to the tool/task.  <strong>Note that we'll add a
+          link on the page, so any email address added there is not
+          obfuscated and can (and probably will) be abused by robots
+          harvesting websites for addresses to spam.</strong></li>
+          <li>a License: entry containing the type of license for the
+          tool/task</li>
+        </ul>
+
+        <p>The preferred format for this information is a patch to <a
+        href="http://cvs.apache.org/viewcvs.cgi/~checkout~/jakarta-ant/xdocs/external.xml">this</a>
+        document.</p>
+
+      </answer>
+
+    </faq>
+
     <faq id="passing-cli-args">
       <question>How do I pass parameters from the command line to my
         build file?</question>