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 &lt;pomVersion&gt; tag and having a 
+             &lt;version&gt; tag, and having &lt;name&gt; inside 
+             &lt;dependency&gt; and not &lt;id&gt;
+         </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 &lt;package&gt; 
+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]>

Reply via email to