ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ste...@apache.org
Subject cvs commit: jakarta-ant/docs/manual cover.html platform.html feedback.html index.html installlist.html toc.html
Date Thu, 28 Feb 2002 22:40:18 GMT
stevel      02/02/28 14:40:18

  Modified:    docs/manual feedback.html index.html installlist.html
                        toc.html
  Added:       docs/manual cover.html platform.html
  Log:
  logo on start page, bit of troubleshooting on the feedback page before the mail list; platform
issues page
  
  Revision  Changes    Path
  1.6       +33 -4     jakarta-ant/docs/manual/feedback.html
  
  Index: feedback.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/feedback.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- feedback.html	4 Feb 2002 20:57:48 -0000	1.5
  +++ feedback.html	28 Feb 2002 22:40:18 -0000	1.6
  @@ -7,10 +7,39 @@
   
   <body>
   
  -<h1><a name="feedback">Feedback</a></h1>
  -<p>To provide feedback on this software, please subscribe to the
  -<a href="http://jakarta.apache.org/site/mail.html" target="_top">Ant User Mailing
List</a>
  -</p>
  +<h1><a name="feedback">Feedback</a> and Troubleshooting</h1>
  +<p>If things do not work, especially simple things like <tt>ant -version</tt>,

  +  then something is wrong with your configuration. Before filing bug reports and 
  +  emailing all the ant mailing lists</p>
  +<ol>
  +  <li>Check your environment variables. Are ANT_HOME and JAVA_HOME correct? If 
  +    they have quotes or trailing slashes, remove them.</li>
  +  <li>Unset CLASSPATH; if that is wrong things go horribly wrong. Ant does not 
  +    need the CLASSPATH variable defined to anything to work.</li>
  +  <li>Make sure there are no versions of crimson.jar or other XML parsers in JRE/ext</li>
  +  <li>Is your path correct? is Ant on it? What about JDK/bin? have you tested 
  +    this? If you are using Jikes, is it on the path? A createProcess error (especially

  +    with ID=2 on windows) usually means executable not found on the path.</li>
  +  <li>Which version of ant are you running? Other applications distribute a copy

  +    -it may be being picked up by accident.</li>
  +  <li>If a task is failing to run is optional.jar in ANT_HOME/lib? Are there any

  +    libraries which it depends on missing?</li>
  +  <li>If a task doesn't do what you expect, run <tt>ant -verbose</tt>
or <tt>ant 
  +    -debug</tt> to see what is happening</li>
  +</ol>
  +<p>If you can't fix your problem, start with the <a href="http://jakarta.apache.org/site/mail.html"
target="_top">Ant 
  +  User Mailing List</a> . These are other ant users who will help you learn to 
  +  use ant. If they cannot fix it then someone may suggest filing a bug report, 
  +  which will escalate the issue. Remember of course, that support, like all open 
  +  source development tasks, is voluntary. If you haven't invested time in helping 
  +  yourself by following the steps above, it is unlikely that anyone will invest 
  +  the time in helping you. </p>
  +<p>Also, if you don't understand something, the <a href="http://jakarta.apache.org/site/mail.html"
target="_top">Ant 
  +  User Mailing List</a> is the place to ask questions. Not the developer list, 
  +  nor the individuals whose names appears in the source and documentation. If 
  +  they answered all such emails, nobody would have any time to improve ant. </p>
  +<p>To provide feedback on this software, please subscribe to the <a href="http://jakarta.apache.org/site/mail.html"
target="_top">Ant 
  +  User Mailing List</a> </p>
   
   <p>If you want to contribute to Ant or stay current with the latest
   development, join the
  
  
  
  1.5       +1 -1      jakarta-ant/docs/manual/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/index.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- index.html	13 Dec 2001 17:16:26 -0000	1.4
  +++ index.html	28 Feb 2002 22:40:18 -0000	1.5
  @@ -7,7 +7,7 @@
   
   <frameset cols="25%,75%">
   <frame src="toc.html" name="navFrame">
  -<frame src="credits.html" name="mainFrame">
  +<frame src="cover.html" name="mainFrame">
   </frameset>
   <noframes>
   <H2>Apache Ant User Manual</H2>
  
  
  
  1.2       +9 -6      jakarta-ant/docs/manual/installlist.html
  
  Index: installlist.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/installlist.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- installlist.html	13 Dec 2001 17:16:26 -0000	1.1
  +++ installlist.html	28 Feb 2002 22:40:18 -0000	1.2
  @@ -11,12 +11,15 @@
   <h2><a href="toc.html" target="navFrame">Table of Contents</a></h2>
   
   <h3>Installing Ant</h3>
  -<a href="install.html#getting">Getting Ant</a><br>
  -<a href="install.html#sysrequirements">System Requirements</a><br>
  -<a href="install.html#installing">Installing Ant</a><br>
  -<a href="install.html#buildingant">Building Ant</a><br>
  -<a href="install.html#librarydependencies">Library Dependencies</a><br>
  -
  +<p><a href="install.html#getting">Getting Ant</a><br>
  +  <a href="install.html#sysrequirements">System Requirements</a><br>
  +  <a href="install.html#installing">Installing Ant</a><br>
  +  <a href="install.html#buildingant">Building Ant</a><br>
  +  <a href="install.html#librarydependencies">Library Dependencies</a><br>
  +  <a href="platform.html">Platform Specific Issues</a><br>
  +</p>
  +<p><br>
  +</p>
   </body>
   </html>
   
  
  
  
  1.12      +2 -1      jakarta-ant/docs/manual/toc.html
  
  Index: toc.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/toc.html,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -r1.11 -r1.12
  --- toc.html	20 Feb 2002 01:16:20 -0000	1.11
  +++ toc.html	28 Feb 2002 22:40:18 -0000	1.12
  @@ -20,7 +20,8 @@
   <a href="developlist.html" target="navFrame">Developing with Ant</a><br>
   <a href="api/index.html" target="_top">Ant API</a><br>
   <a href="LICENSE">License</a><br>
  -<a href="feedback.html">Feedback</a><br><br>
  +<a href="feedback.html">Feedback and Troubeshooting</a><br>
  +<br>
   <a href="credits.html">Authors</a><br>
   
   </body>
  
  
  
  1.1                  jakarta-ant/docs/manual/cover.html
  
  Index: cover.html
  ===================================================================
  <html>
  
  <head>
  <meta http-equiv="Content-Language" content="en-us">
  <title>Apache Ant 1.5 User Manual - Credits</title>
  </head>
  
  <body bgcolor="#FFFFFF">
  <div align="center"> 
    <h1><img src="../artwork/ant_logo_large.gif" width="190" height="120"></h1>
    <h1>Apache Ant 1.5 Manual</h1>
    <p align="left">This is the manual for version 1.5 of Apache Ant. If your version

      of ant (as verified with <tt>ant -version</tt>) is older or newer than this

      version then this is not the correct manual set. Please use the documentation 
      appropriate to your current version. </p>
    <p>&nbsp;</p>
  </div>
  
  
  <hr>
  <p align="center">Copyright &copy; 2001-2002 Apache Software Foundation. All rights
  Reserved.</p>
  
  </body>
  </html>
  
  
  
  1.1                  jakarta-ant/docs/manual/platform.html
  
  Index: platform.html
  ===================================================================
  <html>
  
  <head>
  <meta http-equiv="Content-Language" content="en-us">
  <title>Platform Issues</title>
  </head>
  
  <h1>Platform Issues</h1>
  
  
  <h2>Unix</h2>
  
  <ul>
  <li> You should use a GNU version of <tt>tar</tt> to untar the ant source
tree,
  if you have downloaded this as a tar file.
  </li>
  <li> Ant does not preserve file permissions when a file is copied, moved or 
  archived. Use <tt>&lt;chmod&gt;</tt> to set permissions, and when creating
a 
  tar archive, use the <tt>mode</tt> attribute of <tt>&lt;tarfileset&gt;</tt>
  to set the permissions in the tar file.
  </li>
  <li> Ant is not symbolic link aware in moves, deletes and when recursing down a tree
  of directories to build up a list of files. Unexpected things can happen.
  </ul>
  
  <h2>Microsoft Windows</h2>
  
  Windows 9x (win95, win98, win98SE and winME) has a batch file system which
  does not work fully with long file names, so we recommend that ant and the JDK
  are installed into directories without spaces, and with 8.3 filenames. 
  The Perl and Python launcher scripts do not suffer from this limitation.
  
  <p>
  All versions of windows are usually case insensitive, although mounted 
  file systems (Unix drives, Clearcase views) can be case sensitive underneath,
  confusing patternsets. 
  
  <p>
  Ant can often not delete a directory which is open in an Explorer window. 
  There is nothing we can do about this short of spawning a program to kill
  the shell before deleting directories.  
  
  <h2>Apple MacOS X</h2>
  
  MacOS X is the first of the Apple platforms that Ant supports completely;
  it is treated like any other Unix. 
  
  <h2>Novell Netware</h2>
  
  <h2>Other platforms</h2>
  Support for other platforms is not guaranteed to be complete, as certain 
  techniques to hide platform details from build files need to be written and
  tested on every particular platform. Contributions in this area are welcome.
  
  </html>
  
  
  

--
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