You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by ho...@apache.org on 2002/03/05 01:43:06 UTC
cvs commit: jakarta-ant/docs antnews.html external.html faq.html index.html logocontest.html logos.html problems.html projects.html resources.html
holtdl 02/03/04 16:43:06
Modified: xdocs problems.xml
xdocs/stylesheets templates.vm
docs antnews.html external.html faq.html index.html
logocontest.html logos.html problems.html
projects.html resources.html
Log:
Edit the right dang file this time! (Sure hope I'm doing this right
this time.)
Also add the JavaWorld finalist logo (unless for some reason people
don't want it up there).
Revision Changes Path
1.5 +224 -139 jakarta-ant/xdocs/problems.xml
Index: problems.xml
===================================================================
RCS file: /home/cvs/jakarta-ant/xdocs/problems.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- problems.xml 27 Sep 2001 06:58:35 -0000 1.4
+++ problems.xml 5 Mar 2002 00:43:05 -0000 1.5
@@ -8,168 +8,253 @@
<body>
<section name="Having Problems?">
- <p>If you are having problems with Ant, this page details some steps you can take
- to try and resolve the problem. If you can't resolve the problem then this page will help
- you collect some of the relevant information to provide a bug report. This information will help
- the Ant developers understand and resolve the problem. Of course, not all of the steps here will
- make sense for every problem you encounter. These are just some suggestions to
- point you in the right direction.
- </p>
+ <p>
+ This page details some steps you can take to try and resolve
+ any problems you may be having with Ant. If you find you can't
+ resolve the problem, then this page will help you collect some of
+ the relevant information to provide in a bug report. This information
+ will help the Ant developers understand and resolve the problem.
+ Of course, not all the steps here will make sense for every problem
+ you may encounter - these are just some suggestions to point
+ you in the right direction.
+ </p>
<subsection name="Read the Manual">
- <p>The first step to take when you have a problem is to read the <a href="manual/index.html">
- manual</a> entry for the task or concept that is giving you trouble. Check particularly the meaning of
- attributes and nested elements. Perhaps an attribute would provide the behavior you require. If you
- have problems with the manual, then you can submit a documentation bug report (see below) to help us
- improve the Ant documentation.
- </p>
+ <p>
+ The first step to take when you have a problem with Ant is to read
+ the <a href="manual/index.html">manual</a> entry for the task or
+ concept that is giving you trouble. In particular, check the
+ meaning of a task's attributes and nested elements. Perhaps an
+ attribute is available that would provide the behavior you require.
+ If you have problems with the manual itself, you can submit a
+ documentation bug report (see below) to help us improve the Ant
+ documentation.
+ </p>
</subsection>
<subsection name="Examine Debug Output">
- <p>The first step when you have a problem is to see what Ant is doing. Try running Ant with
- The verbose flag<br/><br/>
- <code>ant -verbose</code><br/><br/>
- or<br/><br/>
- <code>ant -v</code><br/><br/>
+ <p>
+ If you're still having a problem, the next step is to try and
+ gather additional information about what Ant is doing.
+ Try running Ant with the <code>verbose</code> flag:
+ <br></br><br></br>
+ <font face="verdana" size="-1">ant -verbose</font>
+ <br></br><br></br>
+ or
+ <br></br><br></br>
+ <font face="verdana" size="-1">ant -v</font>
+ <br></br><br></br>
- This will produce something which starts like the following:</p>
- <source>
-Ant version 1.4alpha compiled on August 6 2001
-Buildfile: build.xml
-Detected Java version: 1.3 in: f:\jdk1.3\jre
-Detected OS: Windows NT
-parsing buildfile \jakarta-ant\build.xml with
-URI = file:/jakarta-ant/build.xml
-Project base dir set to: \jakarta-ant
- [property] Loading \jakarta-ant\.ant.properties
- [property] Unable to find property file: \jakarta-ant\.ant.properties
- [property] Loading \conor\.ant.properties
- [property] Override ignored for debug
-
-prepare:
-
-check_for_optional_packages:
-...
- </source>
+ This will produce output that starts like the following:</p>
+<table>
+<tr>
+<td>
+Ant version 1.4.1 compiled on October 11 2001<br></br>
+Buildfile: build.xml<br></br>
+Detected Java version: 1.3 in: D:\usr\local\java\jdk13\jre<br></br>
+Detected OS: Windows NT<br></br>
+parsing buildfile D:\ant\build.xml
+with URI = file:D:/ant/build.xml<br></br>
+Project base dir set to: D:\ant<br></br>
+  [property] Loading Environment env.<br></br>
+  [property] Loading D:\ant\conf.properties<br></br>
+Build sequence for target 'debug' is [debug]<br></br>
+Complete build sequence is [debug, gensrc, compile, jar, test]<br></br>
+. . .<br></br>
+</td>
+</tr>
+</table>
<p>
- You may be able to see in this trace what ant is doing and why it takes a particular
- course of action. If you need even more information you can use the <code>-debug</code>
- flag rather than <code>-verbose</code>. This will generally produce so much output that
- you may want to save the output and analyze it in an editor.
+ You should be able to see from the trace more about what Ant
+ is doing and why it's taking a particular course of action.
+ If you need even more information, you can use the
+ <code>-debug</code> flag rather than
+ <code>-verbose</code>.
+ This will generally produce so much
+ output that you may want to save the output to a file and
+ analyze it in an editor. You can save the output using the
+ <code>-logfile <filename></code> flag, or using
+ redirection.
</p>
-
- <p>So, once you have all this debug information, how can you use it to solve your problem?
- That will depend on the task in question and the nature of your problem. Each task logs
- different aspects of its operation, but it will give you an idea of what is going on. For
- example, the <javac> task logs the reasons why it chooses to compile particular
- classes and the equivalent command it is using. The following trace (which has been edited
- and reformatted for clarity) shows javac adding one class but skipping another. This is followed
- by the compiler arguments and a summary of all the classes to be compiled.
+ <p>
+ Once you have all this debug information, how can you use it
+ to solve your problem? That will depend on the task in question
+ and the nature of your problem. Each task logs different aspects
+ of its operation, but it should give you an idea of what is going
+ on. For example, the <code><javac></code> task logs the
+ reasons why it
+ chooses to compile particular class files and not others, along
+ with which compiler it is using and the arguments it will pass
+ to that compiler. The following partial trace shows why
+ <code><javac></code> is adding one class file but
+ skipping another.
+ This is followed by which compiler it will be using, the
+ arguments that will get passed to the compiler,
+ and a list of all the class files to be compiled.
</p>
-<source>
- [javac] org\apache\tools\ant\listener\Log4jListener.java added as
- \build\classes\org\apache\tools\ant\listener\Log4jListener.class
- is outdated.
- [javac] org\apache\tools\ant\Location.java omitted as
- \build\classes\org\apache\tools\ant\Location.class is up to date.
- ...
- [javac] Compiling 1 source file to \jakarta-ant\build\classes
- [javac] Using modern compiler
- [javac] Compilation args: -d \jakarta-ant\build\classes -classpath
- \jakarta-ant\build\classes;F:\jdk1.3\lib\tools.jar;
- \Ant\lib\optional.jar;\Ant\lib\log4j.jar;
- \Ant\lib\junit.jar;\Ant\lib\jaxp.jar;
- \Ant\lib\crimson.jar;\Ant\lib\ant.jar
- -sourcepath \jakarta-ant\src\main -g:none -O
- [javac] File to be compiled:
- \src\main\org\apache\tools\ant\listener\Log4jListener.java
-</source>
+<table>
+<tr>
+<td>
+[javac] Test.java omitted as D:\classes\Test.class is up to date.<br></br>
+[javac] Unset.java added as D:\classes\Unset.class is outdated.<br></br>
+[javac] Compiling 1 source file to D:\classes<br></br>
+[javac] Using classic compiler<br></br>
+[javac] Compilation args: -d D:\classes -classpath D:\classes;<br></br>
+D:\jdk118\classes.zip; -sourcepath D:\src\java -g:none<br></br>
+[javac] File to be compiled:<br></br>
+D:\src\java\Unset.java<br></br>
+</td>
+</tr>
+</table>
- <p>
- In many cases Ant tasks are wrappers around OS commands or other java classes. In debug mode, many
- of these tasks will print out the equivalent command line, as the <javac> task above does. If
- you are having a problem, it is often useful to run the command directly in the same way Ant is doing
- and see if the problem persists. The problem may lie in the command being run by Ant, or in the way
- the Ant task is running the command. You can also see the effect of changing attribute values on the
- generated command line. This can help you to understand whether you are using the correct attributes
- and values.
+ <p>
+ In many cases, Ant tasks are wrappers around OS commands or
+ other Java classes. In debug mode, many of these tasks will
+ print out the equivalent command line, as the
+ <code><javac></code> task
+ output does. If you are having a problem, it is often useful to
+ run the command directly from the command line, in the same way
+ Ant is running it, and see if the problem occurs from there
+ as well. The problem may be in the command that is being run,
+ or it may be in the way the Ant task is running the command.
+ You can also see the effect of changing attribute values on the
+ generated command line. This can help you to understand whether
+ you are using the correct attributes and values.
</p>
</subsection>
- <subsection name="Has it been fixed?">
- <p>
- After examining the debug output, you still believe that the problem you are having may be caused by Ant.
- Chances are that someone else may have already encountered this problem and perhaps it has been
- fixed. The next step, therefore, may be to try a nightly build of Ant to see if the
- problem has been fixed. Nightly builds for Ant are available from the
- <a href="http://www.apache.org/dist/jakarta/jakarta-ant/nightly/">Jakarta web site</a>. While Ant nightly
- builds are typically quite stable and are used by <a href="http://www.apache.org/dist/jakarta/gump/latest/">
- Gump</a> to build many other Jakarta projects, these builds should be treated as experimental. You can
- install and verify whether your problem has been fixed. Note that nightly builds do not build many of the
- optional tasks the come with Ant. A snapshot of these optional tasks is occasionally uploaded to the nightly
- download <a href="http://www.apache.org/dist/jakarta/jakarta-ant/nightly/optional/">area</a>. Note that even
- this snapshot does not contain every optional task.
+ <subsection name="Has It Been Fixed?">
+ <p>
+ After examining the debug output, if you still believe that the
+ problem you are having is caused by Ant, chances are that someone
+ else may have already encountered this problem, and perhaps it has
+ been fixed. The next step, therefore, may be to try a nightly build
+ of Ant to see if the problem has been fixed. Nightly builds for Ant
+ are available from the
+ <a href="http://www.apache.org/dist/jakarta/jakarta-ant/nightly/">
+ Jakarta web site</a>. While Ant nightly builds are typically quite
+ stable and are used by
+ <a href="http://www.apache.org/dist/jakarta/gump/latest/">Gump</a>
+ to build many other Jakarta projects, these builds should
+ nonetheless be treated as experimental. Note that nightly builds
+ do not build many of the optional tasks the come with Ant.
+ A snapshot of these optional tasks is occasionally uploaded to
+ the nightly download
+ <a href="http://www.apache.org/dist/jakarta/jakarta-ant/nightly/optional/">
+ area</a>. However, even this snapshot does not contain every
+ optional task.
</p>
</subsection>
- <subsection name="Has it been reported?">
- <p>
- If the current nightly build doesn't resolve your problem, it is possible that someone else has reported
- the issue. It is time to look at the <a href="http://nagoya.apache.org/bugzilla/">Apache Bug Database</a>.
- This system is easy to use and it will let you search the
- <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Ant&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id">
- currently open
- </a>.
- and resolved bugs to see if your problem has already been reported.
- If your problem has been reported, you can see whether any of the developers have commented,
- suggesting workarounds or the reason for the bug, etc. You may have more information to add (see about
- creating bug reports below), in which case, go right ahead and add it. If you can't add more information
- you may just want to vote for this bug, and perhaps add yourself to the CC list to follow the progress of
- this bug.
- </p>
+ <subsection name="Has It Been Reported?">
+ <p>
+ If the current nightly build doesn't resolve your problem, it is
+ possible that someone else has reported the issue. It is time to
+ look at the <a href="http://nagoya.apache.org/bugzilla/">
+ Apache Bug Database</a>. This system is easy to use, and it will
+ let you search the <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Ant&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id">
+ currently open</a> and resolved bugs to see if your problem has
+ already been reported. If your problem has been reported, you can
+ see whether any of the developers have commented, suggesting
+ workarounds, or the reason for the bug, etc. Or you may have
+ information to add (see about creating and modifying bug reports
+ below), in which case, go right ahead and add the information.
+ If you don't have any additional information, you may just want
+ to vote for this bug, and perhaps
+ add yourself to the <code>CC</code> list to follow the progress
+ of this bug.
+ </p>
</subsection>
- <subsection name="Filing a Bug report">
- <p>By this time you may have decided that there is a bug in Ant. You have a few choices at this
- point. You can send an email to the ant-user mailing list to see if others have encountered your issue
- and how they may have worked around it. If after some discussion, you still feel you have a bug, it
- is time to create a bug report. This is a simple operation in the Bug Database. Please try to provide
- as much information as possible to assist the developers in resolving the bug. Please try to enter correct
- values for the various inputs when creating the bug. Once the bug is created you can add attachments to
- the bug report.
- </p>
-
- <p>What information should you include in your bug report? The easiest bugs to fix are those which are most
- easily reproducible, so if you can, it is really helpful to produce a small test case that exhibits the
- problem. In this case, you would attach the build file and other files necessary to reproduce the problem
- probably packed together in an archive. If you can't produce a test case, you should try to include a
- snippet from your build file and the relevant sections from the debug out from Ant. Try to include the
- header information where Ant states the version, the OS and VM information etc. As the debug output is
- likely to be very large, you should try to remove the output which is not relevant. Once the bug is
- entered into the Bug Database, you will be kept informed about progress on the bug. If you receive email
- asking for further information, please try to respond as it will aid in the resolution of your bug.
- </p>
+ <subsection name="Filing a Bug Report">
+ <p>
+ By this time, you may have decided that there is an unreported
+ bug in Ant. You have a few choices at this point. You can send
+ an email to the <code>ant-user</code> mailing list to see if
+ others have encountered your issue and find out how they may
+ have worked around it. If after some discussion, you feel it
+ is time to create
+ a bug report, this is a simple operation in the bug database.
+ Please try to provide as much information as possible in order
+ to assist the developers in resolving the bug. Please try to enter
+ correct values for the various inputs when creating the bug, such
+ as which version of Ant you are running, and on which platform,
+ etc. Once the bug is created, you can also add attachments to
+ the bug report.
+ </p>
+ <p>
+ What information should you include in your bug report? The
+ easiest bugs to fix are those that are most easily reproducible,
+ so it is really helpful if you can produce a small test case that
+ exhibits the problem. In this case, you would attach the build file
+ and any other files necessary to reproduce the problem, probably
+ packed together in an archive. If you can't produce a test case,
+ you should try to include a snippet from your build file and the
+ relevant sections from the verbose or debug output from Ant. Try
+ to include the header information where Ant states the version,
+ the OS and VM information, etc. As debug output is likely to be
+ very large, it's best to remove any output that is not
+ relevant. Once the bug is entered into the bug database, you
+ will be kept informed by email about progress on the bug. If
+ you receive email asking for further information, please try to
+ respond, as it will aid in the resolution of your bug.
+ </p>
</subsection>
- <subsection name="Asking for an enhancement">
- <p>Sometimes, you may find that Ant just doesn't do what you want. It isn't a bug, as such, since Ant
- is working the way it is supposed to. Perhaps it is something that hasn't been thought of yet, or
- a completely new task. For these situations you will want to raise an enhancement request.
- Enhancement requests are managed using the same Apache Bug Database described above.
- These are just a different type of report. If you look in the database, you will see that one of
- the severity settings for a bug is "Enhancement". So, just fill the bug report in, and
- in the description, state how you would like to have Ant enhanced. Again you should check whether
- there are any existing enhancment requests that cover your needs. If so, just add your vote to these.
+ <subsection name="Asking for an Enhancement">
+ <p>
+ Sometimes, you may find that Ant just doesn't do what you need it
+ to. It isn't a bug, as such, since Ant is working the way it is
+ supposed to work. Perhaps it is some additional functionality for
+ a task that hasn't been thought of yet, or maybe a completely new
+ task. For these situations, you will
+ want to raise an <i>enhancement request</i>. Enhancement requests
+ are managed using the same Apache Bug Database described above.
+ These are just a different type of bug report. If you look in the
+ bug database, you will see that one of the severity settings for
+ a bug is "Enhancement". Just fill the bug report in,
+ set the severity of the bug to "Enhancement", and
+ state in the description how you would like to have Ant enhanced.
+ Again, you should first check whether there are any existing
+ enhancment requests that cover your needs. If so, just add your
+ vote to these.
</p>
</subsection>
<subsection name="Fixing the Bug">
- <p>If you aren't satisfied just filing a bug report, you can try to find and fix the problem yourself. The
- best way to do that is by working against the latest code from CVS. Alternatively, you can work with the
- source code from the source distributions available on the Jakarta website. If you are going to tackle the
- issues at this level, you may want to discuss details on the ant-dev mailing list. Once you have a fix
- for the problem, you may either submit the patch to the ant-dev mailing list or enter into the Bug
- Database as described above, attaching the patch. Using the Bug database has the advantage of tracking
- the progress of your bug.
+ <p>
+ If you aren't satisfied with just filing a bug report, you can
+ try to find the cause of the problem and provide a fix yourself.
+ The best way to do that is by working with the latest code from CVS.
+ Alternatively, you can work with the source code available from the
+ <a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.4.1/src/">
+ source distributions</a>. If you
+ are going to tackle the problem at this level, you may want to
+ discuss some details first on the <code>ant-dev</code> mailing
+ list. Once you have a fix for the problem, you may submit
+ the fix as a <i>patch</i> to either the <code>ant-dev</code> mailing
+ list, or enter the bug database as described above and attach the
+ patch to the bug report. Using the bug database has the advantage
+ of being able to track the progress of your patch.
+ </p>
+ <p>
+ If you have a patch to submit and are sending it to the
+ <code>ant-dev</code> mailing list, prefix "[PATCH]"
+ to your message subject. Please include any relevant bug numbers.
+ Patch files should be created with the <code>-u</code>
+ option of the
+ <code>diff</code> or <code>cvs diff</code> command. For
+ example:<br></br><br></br>
+ <font face="verdana" size="-1">
+ diff -u Javac.java.orig Javac.java > javac.diffs<br></br><br></br>
+ </font>
+ or, if you have source from CVS:<br></br><br></br>
+ <font face="verdana" size="-1">
+ cvs diff -u Javac.java > javac.diffs<br></br><br></br>
+ </font>
+
+ Note: You should give your patch files meaningful names.
+ This makes it easier for developers who need to apply a number
+ of different patch files.
</p>
</subsection>
1.4 +3 -0 jakarta-ant/xdocs/stylesheets/templates.vm
Index: templates.vm
===================================================================
RCS file: /home/cvs/jakarta-ant/xdocs/stylesheets/templates.vm,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- templates.vm 10 Jan 2002 11:21:21 -0000 1.3
+++ templates.vm 5 Mar 2002 00:43:05 -0000 1.4
@@ -129,6 +129,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
#set ( $logoString = $project.getChild("logo").getAttributeValue("href") )
#if ( $logoString.startsWith("/") )
1.21 +3 -0 jakarta-ant/docs/antnews.html
Index: antnews.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/antnews.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- antnews.html 1 Mar 2002 09:17:36 -0000 1.20
+++ antnews.html 5 Mar 2002 00:43:05 -0000 1.21
@@ -23,6 +23,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
<a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
</td>
1.37 +3 -0 jakarta-ant/docs/external.html
Index: external.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/external.html,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- external.html 1 Mar 2002 09:17:36 -0000 1.36
+++ external.html 5 Mar 2002 00:43:05 -0000 1.37
@@ -21,6 +21,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
<a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
</td>
1.20 +3 -0 jakarta-ant/docs/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/faq.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- faq.html 1 Mar 2002 09:17:37 -0000 1.19
+++ faq.html 5 Mar 2002 00:43:05 -0000 1.20
@@ -21,6 +21,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
<a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
</td>
1.226 +3 -0 jakarta-ant/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/index.html,v
retrieving revision 1.225
retrieving revision 1.226
diff -u -r1.225 -r1.226
--- index.html 1 Mar 2002 09:17:37 -0000 1.225
+++ index.html 5 Mar 2002 00:43:05 -0000 1.226
@@ -23,6 +23,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
<a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
</td>
1.4 +3 -0 jakarta-ant/docs/logocontest.html
Index: logocontest.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/logocontest.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- logocontest.html 1 Mar 2002 09:17:37 -0000 1.3
+++ logocontest.html 5 Mar 2002 00:43:05 -0000 1.4
@@ -21,6 +21,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
<a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
</td>
1.23 +3 -0 jakarta-ant/docs/logos.html
Index: logos.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/logos.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- logos.html 1 Mar 2002 09:17:37 -0000 1.22
+++ logos.html 5 Mar 2002 00:43:05 -0000 1.23
@@ -21,6 +21,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
<a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
</td>
1.13 +141 -131 jakarta-ant/docs/problems.html
Index: problems.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/problems.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- problems.html 2 Mar 2002 02:49:05 -0000 1.12
+++ problems.html 5 Mar 2002 00:43:05 -0000 1.13
@@ -18,9 +18,15 @@
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
- <td colspan="2">
- <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
+ <td align="left">
+ <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
+ <td align="right">
+ <a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
+ </td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
@@ -88,21 +94,22 @@
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Having problems?"><strong>Having problems?</strong></a>
+ <a name="Having Problems?"><strong>Having Problems?</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p>This page details some steps you can take to try and resolve
+ <p>
+ This page details some steps you can take to try and resolve
any problems you may be having with Ant. If you find you can't
resolve the problem, then this page will help you collect some of
the relevant information to provide in a bug report. This information
will help the Ant developers understand and resolve the problem.
Of course, not all the steps here will make sense for every problem
- you may encounter – these are just some suggestions to point
+ you may encounter - these are just some suggestions to point
you in the right direction.
</p>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Read the Manual"><strong>Read the Manual</strong></a>
@@ -110,7 +117,8 @@
</td></tr>
<tr><td>
<blockquote>
- <p>The first step to take when you have a problem with Ant is to read
+ <p>
+ The first step to take when you have a problem with Ant is to read
the <a href="manual/index.html">manual</a> entry for the task or
concept that is giving you trouble. In particular, check the
meaning of a task's attributes and nested elements. Perhaps an
@@ -119,10 +127,10 @@
documentation bug report (see below) to help us improve the Ant
documentation.
</p>
- </blockquote>
+ </blockquote>
</td></tr>
</table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Examine Debug Output"><strong>Examine Debug Output</strong></a>
@@ -130,105 +138,94 @@
</td></tr>
<tr><td>
<blockquote>
- <p>If you're still having a problem, the next step is to try and
+ <p>
+ If you're still having a problem, the next step is to try and
gather additional information about what Ant is doing.
- Try running Ant with the <code>verbose</code> flag:<br><br>
- <font face="verdana" size="-1">ant -verbose</font><br><br>
- or<br><br>
- <font face="verdana" size="-1">ant -v</font><br><br>
+ Try running Ant with the <code>verbose</code> flag:
+ <br /><br />
+ <font face="verdana" size="-1">ant -verbose</font>
+ <br /><br />
+ or
+ <br /><br />
+ <font face="verdana" size="-1">ant -v</font>
+ <br /><br />
- This will produce output that starts like the following:</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">
-<font face="verdana" size="-1">
-Ant version 1.4.1 compiled on October 11 2001<br>
-Buildfile: build.xml<br>
-Detected Java version: 1.3 in: D:\usr\local\java\jdk13\jre<br>
-Detected OS: Windows NT<br>
+ This will produce output that starts like the following:</p>
+ <table>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
+ valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+Ant version 1.4.1 compiled on October 11 2001<br />
+Buildfile: build.xml<br />
+Detected Java version: 1.3 in: D:\usr\local\java\jdk13\jre<br />
+Detected OS: Windows NT<br />
parsing buildfile D:\ant\build.xml
-with URI = file:D:/ant/build.xml<br>
-Project base dir set to: D:\ant<br>
- [property] Loading Environment env.<br>
- [property] Loading D:\ant\conf.properties<br>
-Build sequence for target 'debug' is [debug]<br>
-Complete build sequence is [debug, gensrc, compile, jar, test]<br>
-. . .<br>
-</font>
-</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>
+with URI = file:D:/ant/build.xml<br />
+Project base dir set to: D:\ant<br />
+��[property] Loading Environment env.<br />
+��[property] Loading D:\ant\conf.properties<br />
+Build sequence for target 'debug' is [debug]<br />
+Complete build sequence is [debug, gensrc, compile, jar, test]<br />
+. . .<br />
+
+ </font>
+ </td>
</tr>
- </table>
- </div>
- <p>You should be able to see from the trace more about what Ant
+ </table>
+ <p>
+ You should be able to see from the trace more about what Ant
is doing and why it's taking a particular course of action.
If you need even more information, you can use the
- <code>‑debug</code> flag rather than
- <code>‑verbose</code>.
+ <code>-debug</code> flag rather than
+ <code>-verbose</code>.
This will generally produce so much
output that you may want to save the output to a file and
analyze it in an editor. You can save the output using the
- <code>‑logfile <filename></code> flag, or using
+ <code>-logfile <filename></code> flag, or using
redirection.
</p>
- <p>Once you have all this debug information, how can you use it
+ <p>
+ Once you have all this debug information, how can you use it
to solve your problem? That will depend on the task in question
and the nature of your problem. Each task logs different aspects
of its operation, but it should give you an idea of what is going
- on. For example, the <javac> task logs the reasons why it
+ on. For example, the <code><javac></code> task logs the
+ reasons why it
chooses to compile particular class files and not others, along
with which compiler it is using and the arguments it will pass
to that compiler. The following partial trace shows why
- <javac> is adding one class file but skipping another.
+ <code><javac></code> is adding one class file but
+ skipping another.
This is followed by which compiler it will be using, the
arguments that will get passed to the compiler,
and a list of all the class files to be compiled.
</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">
-<font face="verdana" size="-1">
-[javac] Test.java omitted as D:\classes\Test.class is up to date.<br>
-[javac] Unset.java added as D:\classes\Unset.class is outdated.<br>
-[javac] Compiling 1 source file to D:\classes<br>
-[javac] Using classic compiler<br>
-[javac] Compilation args: -d D:\classes -classpath D:\classes;<br>
-D:\jdk118\classes.zip; -sourcepath D:\src\java -g:none<br>
-[javac] File to be compiled:<br>
- D:\src\java\Unset.java<br>
-</font>
-</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>
+ <table>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
+ valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+[javac] Test.java omitted as D:\classes\Test.class is up to date.<br />
+[javac] Unset.java added as D:\classes\Unset.class is outdated.<br />
+[javac] Compiling 1 source file to D:\classes<br />
+[javac] Using classic compiler<br />
+[javac] Compilation args: -d D:\classes -classpath D:\classes;<br />
+D:\jdk118\classes.zip; -sourcepath D:\src\java -g:none<br />
+[javac] File to be compiled:<br />
+D:\src\java\Unset.java<br />
+
+ </font>
+ </td>
</tr>
- </table>
- </div>
- <p>In many cases, Ant tasks are wrappers around OS commands or
+ </table>
+ <p>
+ In many cases, Ant tasks are wrappers around OS commands or
other Java classes. In debug mode, many of these tasks will
- print out the equivalent command line, as the <javac> task
+ print out the equivalent command line, as the
+ <code><javac></code> task
output does. If you are having a problem, it is often useful to
run the command directly from the command line, in the same way
Ant is running it, and see if the problem occurs from there
@@ -238,18 +235,19 @@
generated command line. This can help you to understand whether
you are using the correct attributes and values.
</p>
- </blockquote>
+ </blockquote>
</td></tr>
</table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Has it been fixed?"><strong>Has it been fixed?</strong></a>
+ <a name="Has It Been Fixed?"><strong>Has It Been Fixed?</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p>After examining the debug output, if you still believe that the
+ <p>
+ After examining the debug output, if you still believe that the
problem you are having is caused by Ant, chances are that someone
else may have already encountered this problem, and perhaps it has
been fixed. The next step, therefore, may be to try a nightly build
@@ -268,37 +266,38 @@
area</a>. However, even this snapshot does not contain every
optional task.
</p>
- </blockquote>
+ </blockquote>
</td></tr>
</table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Has it been reported?"><strong>Has it been reported?</strong></a>
+ <a name="Has It Been Reported?"><strong>Has It Been Reported?</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p>If the current nightly build doesn't resolve your problem, it is
+ <p>
+ If the current nightly build doesn't resolve your problem, it is
possible that someone else has reported the issue. It is time to
look at the <a href="http://nagoya.apache.org/bugzilla/">
Apache Bug Database</a>. This system is easy to use, and it will
let you search the <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Ant&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&order=bugs.bug_id">
- currently open</a> and resolved bugs to see if your problem has
- already been reported. If your problem has been reported, you can
- see whether any of the developers have commented, suggesting
- workarounds, or the reason for the bug, etc. Or you may have
- information to add (see about creating and modifying bug reports
- below), in which case, go right ahead and add the information.
- If you don't have any additional information, you may just want
- to vote for this bug, and perhaps
- add yourself to the <code>CC</code> list to follow the progress
- of this bug.
+ currently open</a> and resolved bugs to see if your problem has
+ already been reported. If your problem has been reported, you can
+ see whether any of the developers have commented, suggesting
+ workarounds, or the reason for the bug, etc. Or you may have
+ information to add (see about creating and modifying bug reports
+ below), in which case, go right ahead and add the information.
+ If you don't have any additional information, you may just want
+ to vote for this bug, and perhaps
+ add yourself to the <code>CC</code> list to follow the progress
+ of this bug.
</p>
- </blockquote>
+ </blockquote>
</td></tr>
</table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Filing a Bug Report"><strong>Filing a Bug Report</strong></a>
@@ -306,7 +305,8 @@
</td></tr>
<tr><td>
<blockquote>
- <p>By this time, you may have decided that there is an unreported
+ <p>
+ By this time, you may have decided that there is an unreported
bug in Ant. You have a few choices at this point. You can send
an email to the <code>ant-user</code> mailing list to see if
others have encountered your issue and find out how they may
@@ -320,7 +320,8 @@
etc. Once the bug is created, you can also add attachments to
the bug report.
</p>
- <p>What information should you include in your bug report? The
+ <p>
+ What information should you include in your bug report? The
easiest bugs to fix are those that are most easily reproducible,
so it is really helpful if you can produce a small test case that
exhibits the problem. In this case, you would attach the build file
@@ -336,10 +337,10 @@
you receive email asking for further information, please try to
respond, as it will aid in the resolution of your bug.
</p>
- </blockquote>
+ </blockquote>
</td></tr>
</table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Asking for an Enhancement"><strong>Asking for an Enhancement</strong></a>
@@ -347,7 +348,8 @@
</td></tr>
<tr><td>
<blockquote>
- <p>Sometimes, you may find that Ant just doesn't do what you need it
+ <p>
+ Sometimes, you may find that Ant just doesn't do what you need it
to. It isn't a bug, as such, since Ant is working the way it is
supposed to work. Perhaps it is some additional functionality for
a task that hasn't been thought of yet, or maybe a completely new
@@ -356,17 +358,17 @@
are managed using the same Apache Bug Database described above.
These are just a different type of bug report. If you look in the
bug database, you will see that one of the severity settings for
- a bug is "Enhancement". Just fill the bug report in,
- set the severity of the bug to "Enhancement", and
+ a bug is "Enhancement". Just fill the bug report in,
+ set the severity of the bug to "Enhancement", and
state in the description how you would like to have Ant enhanced.
Again, you should first check whether there are any existing
enhancment requests that cover your needs. If so, just add your
vote to these.
</p>
- </blockquote>
+ </blockquote>
</td></tr>
</table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Fixing the Bug"><strong>Fixing the Bug</strong></a>
@@ -374,7 +376,8 @@
</td></tr>
<tr><td>
<blockquote>
- <p>If you aren't satisfied with just filing a bug report, you can
+ <p>
+ If you aren't satisfied with just filing a bug report, you can
try to find the cause of the problem and provide a fix yourself.
The best way to do that is by working with the latest code from CVS.
Alternatively, you can work with the source code available from the
@@ -388,42 +391,49 @@
patch to the bug report. Using the bug database has the advantage
of being able to track the progress of your patch.
</p>
- <p>If you have a patch to submit and are sending it to the
- <code>ant-dev</code> mailing list, prefix "[PATCH]"
+ <p>
+ If you have a patch to submit and are sending it to the
+ <code>ant-dev</code> mailing list, prefix "[PATCH]"
to your message subject. Please include any relevant bug numbers.
- Patch files should be created with the <code>‑u</code>
+ Patch files should be created with the <code>-u</code>
option of the
<code>diff</code> or <code>cvs diff</code> command. For
- example:<br><br>
- <font face="verdana" size="-1">
- diff -u Javac.java.orig Javac.java > javac.diffs<br><br>
- </font>
- or, if you have source from CVS:<br><br>
- <font face="verdana" size="-1">
- cvs diff -u Javac.java > javac.diffs<br><br>
+ example:<br /><br />
+ <font face="verdana" size="-1">
+ diff -u Javac.java.orig Javac.java > javac.diffs<br /><br />
+ </font>
+ or, if you have source from CVS:<br /><br />
+ <font face="verdana" size="-1">
+ cvs diff -u Javac.java > javac.diffs<br /><br />
+ </font>
Note: You should give your patch files meaningful names.
This makes it easier for developers who need to apply a number
of different patch files.
- </blockquote>
+ </p>
+ </blockquote>
</td></tr>
</table>
- </blockquote>
+ </blockquote>
</td></tr>
</table>
- </td></tr>
+ </td>
+ </tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1">
- <em>Copyright © 2000-2002, Apache Software Foundation</em>
- </font></div>
+ <div align="center"><font color="#525D76" size="-1"><em>
+ Copyright © 2000-2002, Apache Software Foundation
+ </em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
+
+
+
1.6 +3 -0 jakarta-ant/docs/projects.html
Index: projects.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/projects.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- projects.html 1 Mar 2002 09:17:37 -0000 1.5
+++ projects.html 5 Mar 2002 00:43:05 -0000 1.6
@@ -21,6 +21,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
<a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
</td>
1.20 +3 -0 jakarta-ant/docs/resources.html
Index: resources.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/resources.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- resources.html 1 Mar 2002 09:17:37 -0000 1.19
+++ resources.html 5 Mar 2002 00:43:05 -0000 1.20
@@ -21,6 +21,9 @@
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
+ <td align="center">
+ <a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a>
+ </td>
<td align="right">
<a href="http://jakarta.apache.org/ant/"><img src="./artwork/ant_logo_large.gif" alt="Apache Ant" border="0"/></a>
</td>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-ant/docs antnews.html external.html faq.html index.html logocontest.html logos.html problems.html projects.html resources.html
Posted by Erik Hatcher <ja...@ehatchersolutions.com>.
Ah, ok.... I apologize. I just saw the HTML file changes with no
corresponding XML file changes.
----- Original Message -----
From: "Diane Holt" <ho...@yahoo.com>
To: "Ant Developers List" <an...@jakarta.apache.org>
Sent: Monday, March 04, 2002 8:08 PM
Subject: Re: cvs commit: jakarta-ant/docs antnews.html external.html
faq.html index.html logocontest.html logos.html problems.html projects.html
resources.html
> --- Erik Hatcher <ja...@ehatchersolutions.com> wrote:
> > You edited the right problems.xml file.... but you need to edit the the
> > xdocs/*.xml files and not the HTML files for the others also.
>
> I didn't edit them -- just regen'd them, to accommodate the JW logo.
>
> > Then run 'ant -f docs.xml' (you need jakarta-site2 checked out next to
> > jakarta-ant).
>
> Yeah I know -- otherwise, how would I have gotten the new .html files :)
>
> Diane
>
> =====
> (holtdl@yahoo.com)
>
>
>
> __________________________________________________
> Do You Yahoo!?
> Yahoo! Sports - sign up for Fantasy Baseball
> http://sports.yahoo.com
>
> --
> To unsubscribe, e-mail: <ma...@jakarta.apache.org>
> For additional commands, e-mail: <ma...@jakarta.apache.org>
>
>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-ant/docs antnews.html external.html faq.html index.html logocontest.html logos.html problems.html projects.html resources.html
Posted by Diane Holt <ho...@yahoo.com>.
--- Erik Hatcher <ja...@ehatchersolutions.com> wrote:
> You edited the right problems.xml file.... but you need to edit the the
> xdocs/*.xml files and not the HTML files for the others also.
I didn't edit them -- just regen'd them, to accommodate the JW logo.
> Then run 'ant -f docs.xml' (you need jakarta-site2 checked out next to
> jakarta-ant).
Yeah I know -- otherwise, how would I have gotten the new .html files :)
Diane
=====
(holtdl@yahoo.com)
__________________________________________________
Do You Yahoo!?
Yahoo! Sports - sign up for Fantasy Baseball
http://sports.yahoo.com
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-ant/docs antnews.html external.html faq.html index.html logocontest.html logos.html problems.html projects.html resources.html
Posted by Erik Hatcher <ja...@ehatchersolutions.com>.
> holtdl 02/03/04 16:43:06
>
> Modified: xdocs problems.xml
> xdocs/stylesheets templates.vm
> docs antnews.html external.html faq.html index.html
> logocontest.html logos.html problems.html
> projects.html resources.html
> Log:
> Edit the right dang file this time! (Sure hope I'm doing this right
> this time.)
You edited the right problems.xml file.... but you need to edit the the
xdocs/*.xml files and not the HTML files for the others also. Only our task
documentation has its source in HTML files, everything else is XML (maybe an
exception or two, but if there is a corresponding XML, then edit it, not the
HTML).
Then run 'ant -f docs.xml' (you need jakarta-site2 checked out next to
jakarta-ant).
Erik
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-ant/docs antnews.html external.html faq.html index.html logocontest.html logos.html problems.html projects.html resources.html
Posted by Stefan Bodewig <bo...@apache.org>.
On Tue, 5 Mar 2002, Diane Holt <ho...@yahoo.com> wrote:
> But I did what I could within the timeframe
no problem at all.
>> What I really don't like is that you've put <font> tags into the
>> xml sources.
>
> Well, there were <code> tags in there, which is fonting, so...
Nope, not in my book. 8-)
<bold> is "fonting", <strong> is not. <tt> is fonting, <code> is not.
> I did create a new macro and got rid of the blue and did the
> fonting, but it didn't seem worth it to use it unless I can make it
> do the rest of the formatting as well.
I agree - and I'd like to see a solution without hardcoded <br>s as
well (I can live with the blue background if necessary).
>> Fine, as long as we remember to remove it once the decision has
>> been made.
>
> And replace it with the "winner" logo, right? :)
Sure 8-), but only for a short time, OK? We need to find a spot for
all the other "winner" logos that follow.
Seriously, I think we could put that logo (the "finalist") as well as
a potentially future "winner" logo into the news page after some
time. Maybe we start an awards page after that.
Stefan
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-ant/docs antnews.html external.html faq.html index.html logocontest.html logos.html problems.html projects.html resources.html
Posted by Diane Holt <ho...@yahoo.com>.
--- Stefan Bodewig <bo...@apache.org> wrote:
> You did. I don't like how you did what you did, but that is something
> different ;-)
No surprise there -- once I saw how these pages were done, I figured I'd
probably get some flack. But I did what I could within the timeframe I had
to do it, since I don't know
Velocity/Anakia/XDoclet/whatever-the-heck-all-that-stuff-is, and I just
wanted to at least fix the booboo you so thoroughly let me know I'd made
the first time around.
> What I really don't like is that you've put <font> tags into the xml
> sources.
Well, there were <code> tags in there, which is fonting, so...
> What exactly has been your problem with problems.html?
I thougt it was funky the way it was, with it riding off the edge of the
window like that. So I unfunkified it as best I could. (And edited the
overall text, so it reads a whole lot better now as well :)
> I guess you had to remove the <pre> tags in favor of a table with a
> bunch of <br>s, yes?
I wasn't all that thrilled with having to do that (or the blue
background), either, and I have an email into velocity-user to see if
there's a way I can avoid all the coded linebreaks. (I did create a new
macro and got rid of the blue and did the fonting, but it didn't seem
worth it to use it unless I can make it do the rest of the formatting as
well.)
> How can you view faq.html?
I originally thought I'd do the same for it, but changed my mind the more
I thought about it. The "problems" page is likely pretty much done --
ie., it probably won't got through many more (if any) changes from here on
out. The FAQ page, though, is something likely subject to ongoing changes
-- and, there's an awful lot of source code and whatnot that's <pre>'d on
it, and it just wouldn't be practical (unless I can get a macro together)
to try and do anything about it. And really, FAQs are almost always kind
of funky looking anyway :) Whereas the "problems" page is more like
actual documentation, and should look all nice and professional and all
that.
> > Also add the JavaWorld finalist logo
>
> Fine, as long as we remember to remove it once the decision has been
> made.
And replace it with the "winner" logo, right? :)
Diane
=====
(holtdl@yahoo.com)
__________________________________________________
Do You Yahoo!?
Try FREE Yahoo! Mail - the world's greatest free email!
http://mail.yahoo.com/
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-ant/docs antnews.html external.html faq.html index.html logocontest.html logos.html problems.html projects.html resources.html
Posted by Stefan Bodewig <bo...@apache.org>.
On 5 Mar 2002, <ho...@apache.org> wrote:
> Edit the right dang file this time! (Sure hope I'm doing this
> right this time.)
You did. I don't like how you did what you did, but that is something
different ;-)
What I really don't like is that you've put <font> tags into the xml
sources. IMHO the .xml files should hold the content and the
templates/stylesheets should deal with presentation. I'll look into
that again.
What exactly has been your problem with problems.html? I guess you
had to remove the <pre> tags in favor of a table with a bunch of
<br>s, yes?
How can you view faq.html?
> Also add the JavaWorld finalist logo
Fine, as long as we remember to remove it once the decision has been
made. Maybe add a news entry to antnews and put the logo in there
after the decision?
Stefan
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>
Re: cvs commit: jakarta-ant/docs antnews.html external.html faq.html index.html logocontest.html logos.html problems.html projects.html resources.html
Posted by Diane Holt <ho...@yahoo.com>.
Hopefully I got it all right this time. The only thing I couldn't get it
to do was to recognize a non-breaking hyphen (entity name '&nbhy', numeric
code '‑', hex code '‑') -- just came up as a '?'. (Non-breaking
hyphens are useful when you're explaining a flag to use, so you don't end
up with:
yadda yadda yadda ........ use -
verbose to get ....
)
Diane
=====
(holtdl@yahoo.com)
__________________________________________________
Do You Yahoo!?
Yahoo! Sports - sign up for Fantasy Baseball
http://sports.yahoo.com
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>