Attached is aa patch to the faq page with some new entries in it:
"Unable to create Checker"
"Error in ProjectProperties"
"Error in XmlPomValidator"
"Javadoc standard error"
"How do I update my build of Maven?"
The answers may not be right. For example, the last one refers to how to
update a cvs build. I've been in dumb user mode. Whenever I cvs update
Maven I try to bootstrap again, completely not thinking about what the
word bootstrap means.
Anyways, thought I'd submit them.
Hen
Index: faq.xml
===================================================================
RCS file: /home/cvs/jakarta-turbine-maven/xdocs/ref/faq.xml,v
retrieving revision 1.5
diff -c -r1.5 faq.xml
*** faq.xml 7 May 2002 16:09:40 -0000 1.5
--- faq.xml 14 Jun 2002 06:32:53 -0000
***************
*** 43,48 ****
--- 43,54 ----
following error message: Unable to read headerfile?
</a>
</li>
+ <li>
+ <a href="#check-source-unable-to-create-checker">
+ My <code>maven:check-source</code> fails with:
+ <code>Unable to create Checker</code>. How do I fix this?
+ </a>
+ </li>
<li>
<a href="#check-source-disable-header">
How do I prevent <code>maven:check-source</code> from using a
***************
*** 79,84 ****
--- 85,105 ----
Why does change log ask me to check out the source code?
</a>
</li>
+ <li>
+ <a href="#error-in-project-properties">
+ I get the error <code>Error in class
+org.apache.maven.ProjectProperties</code>. What's up?
+ </a>
+ </li>
+ <li>
+ <a href="#error-in-validate-pom">
+ Validating the pom fails with: <code>Error in class
+org.apache.maven.XmlPomValidator</code>. How do I fix?
+ </a>
+ </li>
+ <li>
+ <a href="#error-in-javadoc">
+ When I <code>ant maven:site</code> I get the standard Javadoc error. How
+do I make it Javadoc for me?
+ </a>
+ </li>
</ol>
<p><strong>Building Maven</strong></p>
<ol>
***************
*** 87,92 ****
--- 108,118 ----
How do I build Maven?
</a>
</li>
+ <li>
+ <a href="#how-to-update">
+ How do I update my build of Maven?
+ </a>
+ </li>
</ol>
<section name="General">
***************
*** 142,147 ****
--- 168,184 ----
href="properties.html#Checkstyle Settings">property</a>.
</dd>
<dt>
+ <a name="unable-to-create-checker">
+ My build fails with <code>Unable to create Checker</code>. How do I fix
+this?
+ </a>
+ </dt>
+ <dd>
+ You need to add <code>maven.checkstyle.header.file=/dev/null</code>
+ or <code>maven.checkstyle.header.file=NUL</code> to
+ project.properties for Unix-based and Windows operating systems
+ respectively. Alternatively, you can specify a header file.
+ </dd>
+ <dt>
<a name="check-source-disable-header">
How do I prevent <code>maven:check-source</code> from using
a header file while checking my source tree?
***************
*** 268,273 ****
--- 305,340 ----
appear on a checkout or update if it is empty in the repository.
Please do a clean checkout of the code and retry the report.
</dd>
+ <dt>
+ <a name="error-in-project-properties">
+ I get the error <code>Error in class
+org.apache.maven.ProjectProperties</code>. What's up?
+ </a>
+ </dt>
+ <dd>
+ Most likely your version of Maven does not match the project.xml
+ which you are writing. Running <code>ant maven:validate-pom may
+ help.
+ </dd>
+ <dt>
+ <a name="error-in-validate-pom">
+ Validating the pom fails with: <code>Error in class
+org.apache.maven.XmlPomValidator</code>. How do I fix?
+ </a>
+ </dt>
+ <dd>
+ You're trying to use a version 2 project.xml with a version 3
+ installation of Maven. Your project.xml needs upgrading. Obvious
+ signs are lacking a <pomVersion> tag and having a
+ <version> tag, and having <name> inside
+ <dependency> and not <id>
+ </dd>
+ <dt>
+ <a name="error-in-javadoc">
+ When I <code>ant maven:site</code> I get the standard Javadoc error. How
+do I make it Javadoc for me?
+ </a>
+ </dt>
+ <dd>
+ You have the wrong package name in the project.xml's <package>
+tag.
+ </dd>
</dl>
</section>
<section name="Building Maven">
***************
*** 280,285 ****
--- 347,364 ----
<dd>
Please see the <a href="../start/bootstrap.html">Bootstrapping</a>
document.
+ </dd>
+ </dl>
+ <dl>
+ <dt>
+ <a name="how-to-update">
+ How do I update my build of Maven?
+ </a>
+ </dt>
+ <dd>
+ Just run <code>ant</code>. You should only need to bootstrap the
+ first time. If this is still failing, empty the maven and lib.repo
+ directories and re-bootstrap.
</dd>
</dl>
</section>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>