ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bode...@apache.org
Subject cvs commit: jakarta-ant/xdocs faq.xml
Date Tue, 30 Jul 2002 14:59:36 GMT
bodewig     2002/07/30 07:59:36

  Modified:    docs     Tag: ANT_15_BRANCH faq.html projects.html
               docs/manual/CoreTasks Tag: ANT_15_BRANCH javac.html
               xdocs    Tag: ANT_15_BRANCH faq.xml
  Log:
  Shell snippet that autodetects Emacs' compile mode and then passes
  -emacs as well as build.compiler.emacs to Ant.
  
  PR: 11056, 11057
  Submitted by:	Ville Skyttä <ville.skytta@iki.fi>
  
  Revision  Changes    Path
  No                   revision
  
  
  No                   revision
  
  
  1.30.2.1  +79 -7     jakarta-ant/docs/faq.html
  
  Index: faq.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/faq.html,v
  retrieving revision 1.30
  retrieving revision 1.30.2.1
  diff -u -r1.30 -r1.30.2.1
  --- faq.html	30 Apr 2002 01:20:31 -0000	1.30
  +++ faq.html	30 Jul 2002 14:59:36 -0000	1.30.2.1
  @@ -296,6 +296,11 @@
     &lt;style&gt; or &lt;junit&gt; ignores my
         &lt;classpath&gt;
     </a></li>
  +                    <li><a href="#1.5-cygwin-sh">
  +  The <code>ant</code> wrapper script of Ant 1.5 fails
  +      for Cygwin if <code>ANT_HOME</code> is set to a Windows style
  +      path.
  +  </a></li>
                   </ul>
         </blockquote>
       </td></tr>
  @@ -537,6 +542,20 @@
           </font>
     </td>
         </tr>
  +                  <tr>
  +                  <td bgcolor="#a0ddf0" colspan="" rowspan="" 
  +      valign="top" align="left">
  +    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  +          1.5
  +        </font>
  +  </td>
  +                      <td bgcolor="#a0ddf0" colspan="" rowspan="" 
  +      valign="top" align="left">
  +    <font color="#000000" size="-1" face="arial,helvetica,sanserif">
  +          10 July 2002
  +        </font>
  +  </td>
  +      </tr>
           </table>
                           </blockquote>
       </td></tr>
  @@ -752,6 +771,9 @@
     </td>
         </tr>
           </table>
  +                                        <p>With Ant &gt;= 1.5, you can also use
nested
  +          <code>&lt;compilerarg&gt;</code> elements with the
  +          <code>&lt;javac&gt;</code> task.</p>
                           </blockquote>
       </td></tr>
     </table>
  @@ -1271,8 +1293,8 @@
           your build file uses, this is done inside the <a href="http://www.w3.org/TR/2000/REC-xml-20001006#sec-prolog-dtd">XML
           declaration</a>.</p>
                                           <p>By default the parser assumes you are
using the UTF-8
  -        encoding instead of your platform's default.  For most western
  -        european contries you should set the encoding to
  +        encoding instead of your platform's default.  For most Western
  +        European countries you should set the encoding to
           <code>ISO-8859-1</code>.  To do so, make the very first line
           of you build file read like</p>
                                             <div align="left">
  @@ -1334,9 +1356,37 @@
           regular expressions in your editor that would account for
           this.</p>
                                           <p>You can disable this banner by invoking
Ant with the
  -        <code>-emacs</code> switch. Alternatively, you can add the
  -        following snippet to your <code>.emacs</code> to make Emacs
  -        understand Ant's output.</p>
  +        <code>-emacs</code> switch.  To make Ant autodetect
  +        Emacs' compile mode, put this into your
  +        <code>.antrc</code> (contributed by Ville Skyttä).</p>
  +                                          <div align="left">
  +    <table cellspacing="4" cellpadding="0" border="0">
  +      <tr>
  +        <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +        <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
  +        <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      </tr>
  +      <tr>
  +        <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
  +        <td bgcolor="#ffffff"><pre>
  +# Detect (X)Emacs compile mode
  +if [ &quot;$EMACS&quot; = &quot;t&quot; ] ; then 
  +  ANT_ARGS=&quot;$ANT_ARGS -emacs&quot; 
  +  ANT_OPTS=&quot;$ANT_OPTS -Dbuild.compiler.emacs=true&quot; 
  +fi 
  +</pre></td>
  +        <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
  +      </tr>
  +      <tr>
  +        <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +        <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
  +        <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
  +      </tr>
  +    </table>
  +  </div>
  +                                        <p>Alternatively, you can add the following
snippet to your
  +        <code>.emacs</code> to make Emacs understand Ant's
  +        output.</p>
                                             <div align="left">
       <table cellspacing="4" cellpadding="0" border="0">
         <tr>
  @@ -1619,7 +1669,7 @@
        * Determine the status of the build and the actions to follow, now that
        * the build has completed.
        *
  -     * @param       e       Event describing the build tatus.
  +     * @param       e       Event describing the build status.
        */
       public void buildFinished(BuildEvent e) {
           Throwable th = e.getException();
  @@ -1947,7 +1997,7 @@
           is in <code>CLASSPATH</code> as well.</p>
                                           <p>To solve this, you have two major options:</p>
                                           <ol>
  -          <li>put all external libaries you need in
  +          <li>put all external libraries you need in
             <code>CLASSPATH</code> as well this is not what you want,
             otherwise you wouldn't have found this FAQ entry.</li>
   
  @@ -1984,6 +2034,28 @@
           for <code>&lt;junit&gt;</code>, you still have to use a
           <code>&lt;taskdef&gt;</code> with a nested
           <code>&lt;classpath&gt;</code> to define the junit task.</p>
  +                        </blockquote>
  +    </td></tr>
  +  </table>
  +  </a>
  +        <a name="1.5-cygwin-sh">
  +  <table border="0" cellspacing="0" cellpadding="2" width="100%">
  +    <tr><td bgcolor="#828DA6">
  +      <font color="#ffffff" face="arial,helvetica,sanserif">
  +        <strong>
  +          The <code>ant</code> wrapper script of Ant 1.5 fails
  +      for Cygwin if <code>ANT_HOME</code> is set to a Windows style
  +      path.
  +        </strong>
  +      </font>
  +    </td></tr>
  +    <tr><td>
  +      <blockquote>
  +                              <p>This problem has been reported only hours after
Ant 1.5 has
  +        been released, see <a href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=10664">Bug
  +        10664</a> and all it's duplicates.</p>
  +                                        <p>A fixed version of the wrapper script
can be found <a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.5/errata/">here</a>.
  +        Simply replace your script with this version.</p>
                           </blockquote>
       </td></tr>
     </table>
  
  
  
  1.12.2.2  +5 -5      jakarta-ant/docs/projects.html
  
  Index: projects.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/projects.html,v
  retrieving revision 1.12.2.1
  retrieving revision 1.12.2.2
  diff -u -r1.12.2.1 -r1.12.2.2
  --- projects.html	23 Jul 2002 07:35:13 -0000	1.12.2.1
  +++ projects.html	30 Jul 2002 14:59:36 -0000	1.12.2.2
  @@ -188,12 +188,12 @@
       <tr><td>
         <blockquote>
                           <p>AntDoc is a tool that generates HTML documentation from
Ant
  -	buildfiles; the generated HTML is inspired from what javadoc
  -	yields. It also offers a simple Ant target launcher named
  -	AntDoc GUI. Ant targets may be launched from the generated
  -	AntDoc HTML pages.</p>
  +        buildfiles; the generated HTML is inspired from what javadoc
  +        yields. It also offers a simple Ant target launcher named
  +        AntDoc GUI. Ant targets may be launched from the generated
  +        AntDoc HTML pages.</p>
                                   <p>AntDoc can be run via an Ant task, AntDoc GUI
can be run
  -	via an Ant task, or via a JVM launch.</p>
  +        via an Ant task, or via a JVM launch.</p>
                                     <table>
                 <tr>
                     <td bgcolor="#039acc" colspan="" rowspan="" 
  
  
  
  No                   revision
  
  
  No                   revision
  
  
  1.33.2.7  +6 -9      jakarta-ant/docs/manual/CoreTasks/javac.html
  
  Index: javac.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/javac.html,v
  retrieving revision 1.33.2.6
  retrieving revision 1.33.2.7
  diff -u -r1.33.2.6 -r1.33.2.7
  --- javac.html	20 Jun 2002 09:40:30 -0000	1.33.2.6
  +++ javac.html	30 Jul 2002 14:59:36 -0000	1.33.2.7
  @@ -1,4 +1,4 @@
  -<html>
  +<html lang="en-us">
   
   <head>
   <meta http-equiv="Content-Language" content="en-us">
  @@ -21,7 +21,7 @@
   from the source file, and so on. See the
   <a href="../OptionalTasks/depend.html"><code>&lt;depend&gt;</code></a>
task
   for dependency checking based on other than just
  -existence/modification times.
  +existence/modification times.</p>
   <p>When the source files are part of a package, the directory structure of
   the source tree should follow the package
   hierarchy.</p>
  @@ -47,7 +47,7 @@
   <code>&lt;javac&gt;</code> task.
   <a name="compilervalues">Valid values for either the
   <code>build.compiler</code> property or the <code>compiler</code>
  -attribute are:</p>
  +attribute are:</a></p>
   <ul>
     <li><code>classic</code> (the standard compiler of JDK 1.1/1.2) &ndash;
         <code>javac1.1</code> and
  @@ -56,7 +56,7 @@
         <code>javac1.3</code> and
         <code>javac1.4</code> can be used as aliases.</li>
     <li><code>jikes</code> (the <a
  -    href="http://oss.software.ibm.com/developerworks/opensource/jikes/project" target="_top">Jikes</a>
  +    href="http://oss.software.ibm.com/developerworks/opensource/jikes/" target="_top">Jikes</a>
       compiler).</li>
     <li><code>jvc</code> (the Command-Line Compiler from Microsoft's SDK
         for Java / Visual J++) &ndash; <code>microsoft</code> can be used
  @@ -69,7 +69,6 @@
     <li><code>extJavac</code> (run either modern or classic in a JVM of
         its own).</li>
   </ul>
  -</a>
   <p>The default is <code>javac1.x</code> with <code>x</code>
depending
   on the JDK version you use while you are running Ant.
   If you wish to use a different compiler interface than those
  @@ -98,7 +97,6 @@
   The side effect of this is that you will not be able to delete or move
   those files later on in the build.  The workaround is to fork when
   invoking the compiler.</p>
  -</p>
   <h3>Parameters</h3>
   <table border="1" cellpadding="2" cellspacing="0">
     <tr>
  @@ -109,7 +107,7 @@
     <tr>
       <td valign="top">srcdir</td>
       <td valign="top">Location of the java files. (See the
  -     <a href="#srcdirnote">Note</a> below.)</td>
  +     <a href="#srcdirnote">note</a> below.)</td>
       <td align="center" valign="top">Yes, unless nested <code>&lt;src&gt;</code>
elements are present.</td>
     </tr>
     <tr>
  @@ -492,7 +490,7 @@
   
   <h3>Jikes Notes</h3>
   
  -Jikes supports some extra options, which can be set be defining
  +<p>Jikes supports some extra options, which can be set be defining
   the properties shown below prior to invoking the task. The setting
   for each property will be in affect for all <code>&lt;javac&gt;</code>
   tasks throughout the build.
  @@ -559,7 +557,6 @@
   	</td>
     </tr>
   </table>
  -</p>
   
   <hr>
   <p align="center">Copyright &copy; 2000-2002 Apache Software Foundation.
  
  
  
  No                   revision
  
  
  No                   revision
  
  
  1.17.2.1  +45 -7     jakarta-ant/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/xdocs/faq.xml,v
  retrieving revision 1.17
  retrieving revision 1.17.2.1
  diff -u -r1.17 -r1.17.2.1
  --- faq.xml	18 Apr 2002 14:48:13 -0000	1.17
  +++ faq.xml	30 Jul 2002 14:59:36 -0000	1.17.2.1
  @@ -138,6 +138,11 @@
               <td>1.4.1</td>
               <td>11 October 2001</td>
             </tr>
  +
  +          <tr>
  +            <td>1.5</td>
  +            <td>10 July 2002</td>
  +          </tr>
           </table>
         </answer>
       </faq>
  @@ -265,6 +270,10 @@
   
           </table>
   
  +        <p>With Ant &gt;= 1.5, you can also use nested
  +          <code>&lt;compilerarg&gt;</code> elements with the
  +          <code>&lt;javac&gt;</code> task.</p>
  +
         </answer>
       </faq>
   
  @@ -575,8 +584,8 @@
           declaration</a>.</p>  
   
           <p>By default the parser assumes you are using the UTF-8
  -        encoding instead of your platform's default.  For most western
  -        european contries you should set the encoding to
  +        encoding instead of your platform's default.  For most Western
  +        European countries you should set the encoding to
           <code>ISO-8859-1</code>.  To do so, make the very first line
           of you build file read like</p>
   
  @@ -607,9 +616,21 @@
           this.</p>
   
           <p>You can disable this banner by invoking Ant with the
  -        <code>-emacs</code> switch. Alternatively, you can add the
  -        following snippet to your <code>.emacs</code> to make Emacs
  -        understand Ant&apos;s output.</p>
  +        <code>-emacs</code> switch.  To make Ant autodetect
  +        Emacs&apos; compile mode, put this into your
  +        <code>.antrc</code> (contributed by Ville Skytt&#228;).</p>
  +
  +        <source><![CDATA[
  +# Detect (X)Emacs compile mode
  +if [ "$EMACS" = "t" ] ; then 
  +  ANT_ARGS="$ANT_ARGS -emacs" 
  +  ANT_OPTS="$ANT_OPTS -Dbuild.compiler.emacs=true" 
  +fi 
  +]]></source>
  +
  +        <p>Alternatively, you can add the following snippet to your
  +        <code>.emacs</code> to make Emacs understand Ant&apos;s
  +        output.</p>
   
           <source><![CDATA[
   (require 'compile)
  @@ -785,7 +806,7 @@
        * Determine the status of the build and the actions to follow, now that
        * the build has completed.
        *
  -     * @param       e       Event describing the build tatus.
  +     * @param       e       Event describing the build status.
        */
       public void buildFinished(BuildEvent e) {
           Throwable th = e.getException();
  @@ -1024,7 +1045,7 @@
           <p>To solve this, you have two major options:</p>
   
           <ol>
  -          <li>put all external libaries you need in
  +          <li>put all external libraries you need in
             <code>CLASSPATH</code> as well this is not what you want,
             otherwise you wouldn&apos;t have found this FAQ entry.</li>
   
  @@ -1065,6 +1086,23 @@
           for <code>&lt;junit&gt;</code>, you still have to use a
           <code>&lt;taskdef&gt;</code> with a nested
           <code>&lt;classpath&gt;</code> to define the junit task.</p>
  +      </answer>
  +    </faq>
  +
  +    <faq id="1.5-cygwin-sh">
  +      <question>The <code>ant</code> wrapper script of Ant 1.5 fails
  +      for Cygwin if <code>ANT_HOME</code> is set to a Windows style
  +      path.</question>
  +      <answer>
  +
  +        <p>This problem has been reported only hours after Ant 1.5 has
  +        been released, see <a
  +        href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=10664">Bug
  +        10664</a> and all it's duplicates.</p>
  +
  +        <p>A fixed version of the wrapper script can be found <a
  +        href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.5/errata/">here</a>.
  +        Simply replace your script with this version.</p>
         </answer>
       </faq>
     </faqsection>
  
  
  

--
To unsubscribe, e-mail:   <mailto:ant-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-dev-help@jakarta.apache.org>


Mime
View raw message