OpenPOWER Library

 1.5.3. Build failures

Build errors are easily identified as well. Below is the most common example:

...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 4.827s
[INFO] Finished at: Wed Jul 29 14:55:33 CDT 2015
[INFO] Final Memory: 17M/171M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.0:generate-webhelp (generate-webhelp) on project openpower-template-guide: Execution generate-webhelp of goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.0:generate-webhelp failed: XInclude resource error (sec_template_new_document.xml) and no fallback provided. XProc error err:XD0011: org.xml.sax.SAXParseException; systemId: file:/home/user1/openpower-foundation-docbkx-framework/doc/doc_dev_guide/sec_template_new_document.xml; lineNumber: 55; columnNumber: 17; The element type "para" must be terminated by the matching end-tag "</para>". -> [Help 1]
...

Like validation errors, three key pieces of information are again provided:

  1. The full path and filename of our failure is /home/user1/Docs-Template/doc_dev_guide/sec_template_new_document.xml.

  2. The location within the file of the error is "lineNumber: 55; columnNumber: 17.

  3. An explanation of the failure begins with the text, "The element type "para" must be terminated by the matching end-tag "</para>."

With these details in hand for either error, one simply locates the offending syntax and makes the appropriate correction. Online resources such as those listed in Section 1.10, “Finding more information” may be helpful.

When creating new documentation projects, you may encounter the following error during your first build:

...
[ERROR] Failed to execute goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.5:generate-webhelp (generate-webhelp) on project openpower-vector-programming-guide: Execution generate-webhelp of goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.5:generate-webhelp failed: One of setGitDir or setWorkTree must be called. -> [Help 1]
...

This error results from interactions of the maven build process and git. It may be circumvented by issuing the git init command in your directory.


loading table of contents...