Maven 1.x XDoc Plugin

Including DTD breaks xdoc

Details

  • Type: Bug Bug
  • Status: Closed Closed
  • Priority: Minor Minor
  • Resolution: Cannot Reproduce
  • Affects Version/s: 1.10.1
  • Fix Version/s: None
  • Component/s: None
  • Labels:
    None
  • Environment:
    WindowsXP SP2 x86, JDK6 build 1.6.0_05-b13
  • Number of attachments :
    1

Description

When including the XDoc-DTD as mentioned in issue MPXDOC-192 site generation fails with a Jelly-Exception.
I cannot say if this is an issue with the xdoc-plugin or with jelly.
My document starts with

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//Apache Software Foundation//DTD XDOC 1.0//EN"
"http://maven.apache.org/dtd/xdoc_1_0.dtd">

When invoking the goal xdoc:generate-from-pom (called through a custom goal ta30:doku) I get a Jelly-Exception (full report attached):

Caused by: org.apache.commons.jelly.JellyTagException: file:C:/Dokumente und Einstellungen/Orth/.maven/cache/maven-xdoc-plugin-1.10.1/plugin-resources/sitemap.jsl:84:51: <x:parse> Connection timed out: connect Nested exception: Connection t
imed out: connect
at org.apache.commons.jelly.tags.xml.ParseTagSupport.parse(ParseTagSuppo
rt.java:186)
at org.apache.commons.jelly.tags.xml.ParseTag.getXmlDocument(ParseTag.ja
va:106)
at org.apache.commons.jelly.tags.xml.ParseTag.doTag(ParseTag.java:55)
at org.apache.commons.jelly.impl.TagScript.run(TagScript.java:250)
at org.apache.commons.jelly.impl.ScriptBlock.run(ScriptBlock.java:95)
at org.apache.commons.jelly.TagSupport.invokeBody(TagSupport.java:186)
at org.apache.commons.jelly.tags.util.AvailableTag.doTag(AvailableTag.ja
va:68)
at org.apache.commons.jelly.impl.TagScript.run(TagScript.java:250)
at org.apache.commons.jelly.impl.ScriptBlock.run(ScriptBlock.java:95)
at org.apache.commons.jelly.TagSupport.invokeBody(TagSupport.java:186)
at org.apache.commons.jelly.tags.jsl.TemplateTag$1.run(TemplateTag.java:
160)
at org.dom4j.rule.Mode.fireRule(Mode.java:59)
at org.dom4j.rule.Stylesheet.applyTemplates(Stylesheet.java:185)
at org.dom4j.rule.Stylesheet.applyTemplates(Stylesheet.java:159)
at org.apache.commons.jelly.tags.jsl.ApplyTemplatesTag.doTag(ApplyTempla
tesTag.java:67)
... 112 more
Caused by: org.dom4j.DocumentException: Connection timed out: connect Nested exc
eption: Connection timed out: connect
at org.dom4j.io.SAXReader.read(SAXReader.java:484)
at org.dom4j.io.SAXReader.read(SAXReader.java:264)
at org.apache.commons.jelly.tags.xml.ParseTagSupport.parse(ParseTagSuppo
rt.java:168)
... 126 more

Leaving out the DTD "fixes" the issue, but then I cannot edit the xdoc-file in an XML-editor like the excellent visual XMLmind-editor (with xdoc-type-plugin).

Activity

Ascending order - Click to sort in descending order
Hide
Permalink
Lukas Theussl added a comment -

It works for me. Can you attach a small reproducible test case? However, check the connection timeout, maybe a proxy problem?

Show
Lukas Theussl added a comment - It works for me. Can you attach a small reproducible test case? However, check the connection timeout, maybe a proxy problem?
Hide
Permalink
Gregor B. Rosenauer added a comment -

(I am currently at home but will try on Monday at work)
I have configured the proxy for my Maven1-environment properly and it works normally, do I have to specify a separate proxy in this case? Is there another configuration I am not aware of?
It is true that it looks like a timeout, but I have maven.proxy.host and maven.proxy.port configured properly.

Show
Gregor B. Rosenauer added a comment - (I am currently at home but will try on Monday at work) I have configured the proxy for my Maven1-environment properly and it works normally, do I have to specify a separate proxy in this case? Is there another configuration I am not aware of? It is true that it looks like a timeout, but I have maven.proxy.host and maven.proxy.port configured properly.
Hide
Permalink
Gregor B. Rosenauer added a comment - - edited

When launching the xdoc:default-goal directly, it stops at the same position, so no custom build issues here:

xdoc:generate-from-pom:
[echo] Generating xdocs from POM ...

xdoc:sitemap-noinit:
-------------------------------------------------------------------------------
>> Unable to obtain goal [xdoc:generate-from-pom]
>> Connection timed out: connect Nested exception: Connection timed out: connect
>> Connection timed out: connect
-------------------------------------------------------------------------------
BUILD FAILED

However launching the goal xdoc:transform directly generates the documentation correctly.

Update:
The culprit was a DOCTYPE declaration in the changes.xml - the changelog-plugin does not accept this doctype and has trouble looking up the DTD it seems. Also, changes.xml-files do not conform to the general XDOC-doctype (does not know the "release"-tag etc.), so the declaration was in the wrong place anyway.

Now I only need to figure out why my sitemap is generated wrong even though I did not include any sitemap in my menu.xml - but that's another story...

Show
Gregor B. Rosenauer added a comment - - edited When launching the xdoc:default-goal directly, it stops at the same position, so no custom build issues here:
xdoc:generate-from-pom: [echo] Generating xdocs from POM ... xdoc:sitemap-noinit: ------------------------------------------------------------------------------- >> Unable to obtain goal [xdoc:generate-from-pom] >> Connection timed out: connect Nested exception: Connection timed out: connect >> Connection timed out: connect ------------------------------------------------------------------------------- BUILD FAILED
However launching the goal xdoc:transform directly generates the documentation correctly. Update: The culprit was a DOCTYPE declaration in the changes.xml - the changelog-plugin does not accept this doctype and has trouble looking up the DTD it seems. Also, changes.xml-files do not conform to the general XDOC-doctype (does not know the "release"-tag etc.), so the declaration was in the wrong place anyway. Now I only need to figure out why my sitemap is generated wrong even though I did not include any sitemap in my menu.xml - but that's another story...
Hide
Permalink
Gregor B. Rosenauer added a comment -

sorry, have to reopen because the issue has resurfaced.
The build fails exactly on the first XDOC that includes the DOCTYPE, as soon as I remove it, it runs through.
Log:

xdoc:jelly-transform:
About to use JSL stylesheet file:/C:/Dokumente und Einstellungen/Orth/.maven/cache/maven-xdoc-plugin-1.10.1/plugin-resources/site.jsl
[echo] de_AT.UTF-8
[echo] The current Locale is the default one
[echo] Scanning 'C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs'...
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/changelog-report.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\changelog-report.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/changes-report.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\changes-report.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/dependencies.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\dependencies.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/development-process.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\development-process.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/downloads.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\downloads.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/faq.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\faq.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/file-activity-report.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\file-activity-report.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/index.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\index.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/issue-tracking.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\issue-tracking.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/mail-lists.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\mail-lists.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/maven-reports.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\maven-reports.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/project-info.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\project-info.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/scm-usage.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\scm-usage.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/team-list.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\team-list.xml
Transforming user supplied documentation.
[echo] The current Locale is the default one
[echo] Scanning 'C:\ta30\workspaces\dda_25\ddaMain\xdocs'...
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/adobeCentralTemplates.html from C:\ta30\workspaces\dda_25\ddaMain\xdocs\adobeCentralTemplates.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/aktualisierung.html from C:\ta30\workspaces\dda_25\ddaMain\xdocs\aktualisierung.xml
[echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/batch.html from C:\ta30\workspaces\dda_25\ddaMain\xdocs\batch.xml
-------------------------------------------------------------------------------
>> Unable to obtain goal [xdoc:transform]
>> Connection timed out: connect Nested exception: Connection timed out: connect
>> Connection timed out: connect
-------------------------------------------------------------------------------
BUILD FAILED

Show
Gregor B. Rosenauer added a comment - sorry, have to reopen because the issue has resurfaced. The build fails exactly on the first XDOC that includes the DOCTYPE, as soon as I remove it, it runs through. Log: xdoc:jelly-transform: About to use JSL stylesheet file:/C:/Dokumente und Einstellungen/Orth/.maven/cache/maven-xdoc-plugin-1.10.1/plugin-resources/site.jsl [echo] de_AT.UTF-8 [echo] The current Locale is the default one [echo] Scanning 'C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs'... [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/changelog-report.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\changelog-report.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/changes-report.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\changes-report.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/dependencies.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\dependencies.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/development-process.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\development-process.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/downloads.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\downloads.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/faq.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\faq.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/file-activity-report.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\file-activity-report.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/index.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\index.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/issue-tracking.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\issue-tracking.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/mail-lists.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\mail-lists.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/maven-reports.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\maven-reports.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/project-info.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\project-info.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/scm-usage.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\scm-usage.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/team-list.html from C:\ta30\workspaces\dda_25\ddaMain\target\generated-xdocs\team-list.xml Transforming user supplied documentation. [echo] The current Locale is the default one [echo] Scanning 'C:\ta30\workspaces\dda_25\ddaMain\xdocs'... [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/adobeCentralTemplates.html from C:\ta30\workspaces\dda_25\ddaMain\xdocs\adobeCentralTemplates.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/aktualisierung.html from C:\ta30\workspaces\dda_25\ddaMain\xdocs\aktualisierung.xml [echo] Generating C:/ta30/workspaces/dda_25/ddaMain/target/docs/batch.html from C:\ta30\workspaces\dda_25\ddaMain\xdocs\batch.xml ------------------------------------------------------------------------------- >> Unable to obtain goal [xdoc:transform] >> Connection timed out: connect Nested exception: Connection timed out: connect >> Connection timed out: connect ------------------------------------------------------------------------------- BUILD FAILED
Hide
Permalink
Lukas Theussl added a comment -

If you don't attach a small test case I will close this as 'Cannot reproduce', it works for me.

Show
Lukas Theussl added a comment - If you don't attach a small test case I will close this as 'Cannot reproduce', it works for me.

People

Vote (0)
Watch (1)

Dates

  • Created:
    Updated:
    Resolved:
Atlassian JIRA (v4.4.3#663-r165197) | Report a problem
Powered by a free Atlassian JIRA open source license for Codehaus. Try JIRA - bug tracking software for your team.