[#MPXDOC-17] xdoc with XML entities goes wierd - jira.codehaus.org

Maven 1.x XDoc Plugin

xdoc with XML entities goes wierd

Created: 12/Jun/03 07:50 AM Updated: 02/May/06 06:46 PM Resolved: 02/May/06 06:46 PM

Return to search

Component/s:

None

Affects Version/s:

None

Fix Version/s:

1.10

Time Tracking:

Not Specified

Environment:

windows xp, JDK 1.4.1

Issue Links:

dependent

This issue is depended upon by:

~~MAVEN-401~~ Release maven-b10

Description

« Hide

I'm having a problem using XML entities inside xdoc files.

I like to create XML entities for my XML documentation for common things like links to API docs, or to descriptions of my schemas.

So, I have a file, services.xml, which begins:

<?xml version="1.0"?>
<!DOCTYPE document [
<!ENTITY % common-links SYSTEM "../common/links.xml">
%common-links;
]>

Inside common/links.xml I have stuff like:

<!ENTITY _module '<module>'>
<!ENTITY module '<a href="descriptor.html#module">&_module;</a>'>

And that works properly in my docs; <module> appears as a link when I use
&module; in the document.

However, if you do something simpler it fails:

<!ENTITY api.IFactory 'IFactory'>

Appears in the output as a blank space.

<!ENTITY api.IFactory '<IFactory>'>

Appears as: <IFactory>

<!ENTITY api.IFactory '[IFactory]'>

Appears as: ]

<!ENTITY api.IFactory '<a
href="apidocs/org/apache/commons/hivemind/IFactory.html">IFactory</a>'>

Appears as:
<a href="apidocs/org/apache/commons/hivemind/IFactory.html">
tory
</a>

Something appears screwed up in the xdoc processing pipeline. Does this all sound familiar?

Alternately, is there another way to accomplish my goals (using some kind of Velocity markup?)

Sort Order:

[ Permalink | « Hide ]

Howard M. Lewis Ship added a comment - 12/Jun/03 07:52 AM

If you want to see the real sources, this is part of HiveMind (http://jakarta.apache.org/commons/sandbox/hivemind). You can, obviously, get latest from CVS and build using Maven.

You poor suckers ... you've created a system where the easiest test case is: download my project and build it for me!

[ Permalink | « Hide ]

Ben Walding added a comment - 12/Jun/03 04:09 PM

This smells like something Jelly/JSL would be doing to us. Send the army of Strachan Jelly Coderbots.

dion gillard made changes - 23/Jun/03 02:00 AM

Field	Original Value	New Value
Link		This issue is depended upon by ~~MAVEN-401~~ [ ~~MAVEN-401~~ ]

[ Permalink | « Hide ]

dion gillard added a comment - 03/Jul/03 07:50 PM

Will download hivemind and see how it goes

[ Permalink | « Hide ]

Howard M. Lewis Ship added a comment - 03/Jul/03 07:59 PM

Edit common/links.xml and then maven xdoc to see what I'm talking about.

[ Permalink | « Hide ]

Brett Porter added a comment - 04/Jul/03 10:08 AM

this definitely seems to be a jelly bug, coming down to line 587 of site:jsl:

<jsl:template match="*" trim="false">
<jsl:copy trim="false">
<jsl:applyTemplates trim="false"/>
</jsl:copy>
</jsl:template>

I've found that <jsl:copyOf select="."/> gives
&api.IFactory;IFactory (so evaluating it as an expression, then correctly displaying it).

I'm having a quick look at Jelly now, but in my opinion this shouldn't be blocking beta-10

dion gillard made changes - 09/Jul/03 01:41 AM

Remaining Estimate	0 minutes [ 0 ]
Fix Version/s		1.0-beta-10 [ 10095 ]
Original Estimate	0

dion gillard made changes - 23/Jul/03 10:54 PM

Fix Version/s		1.0-rc1 [ 10181 ]
Fix Version/s	1.0-beta-10 [ 10095 ]

[ Permalink | « Hide ]

Brett Porter added a comment - 02/Sep/03 07:07 PM

need for time to enlist the jellybots

Brett Porter made changes - 02/Sep/03 07:07 PM

Affects Version/s		1.0-beta-10 [ 10095 ]
Fix Version/s	1.0-rc1 [ 10181 ]
Fix Version/s		1.0-final [ 10149 ]
Component/s		jelly-integ [ 10027 ]

Jason van Zyl made changes - 01/Dec/03 09:23 AM

Component/s	plugin-xdoc [ 10061 ]
Component/s	jelly-integ [ 10027 ]
Affects Version/s	1.0-beta-9 [ 10071 ]
Project	maven [ 10030 ]	maven-xdoc-plugin [ 10355 ]
Key	MAVEN-482	~~MPXDOC-17~~
Affects Version/s	1.0-beta-10 [ 10095 ]
Fix Version/s	1.0-final [ 10149 ]

Brett Porter made changes - 07/May/04 07:11 PM

Link

This issue is depended upon by ~~MAVEN-1244~~ [ ~~MAVEN-1244~~ ]

Brett Porter made changes - 07/May/04 08:32 PM

Link

This issue is depended upon by ~~MAVEN-1244~~ [ ~~MAVEN-1244~~ ]

Arnaud Heritier made changes - 16/Aug/04 06:00 PM

Assignee

Arnaud HERITIER [ aheritier ]

Arnaud Heritier made changes - 22/Aug/05 06:41 AM

Assignee

Arnaud Heritier [ aheritier ]

[ Permalink | « Hide ]

Lukas Theussl added a comment - 02/May/06 06:46 PM

This works in Maven 1.1 with jsl:copyOf instead of jsl:copy. I hope this doesn't break anything else though...

Lukas Theussl made changes - 02/May/06 06:46 PM

Status	Open [ 1 ]	Closed [ 6 ]
Resolution		Fixed [ 1 ]
Assignee		Lukas Theussl [ lukas ]
Fix Version/s		1.10 [ 11986 ]