The following comment has been added to this issue:
Author: Howard M. Lewis Ship
Created: Thu, 3 Jul 2003 7:59 PM
Body:
Edit common/links.xml and then maven xdoc to see what I'm talking about.
---------------------------------------------------------------------
View the issue:
http://jira.codehaus.org/secure/ViewIssue.jspa?key=MAVEN-482
Here is an overview of the issue:
---------------------------------------------------------------------
Key: MAVEN-482
Summary: xdoc with XML entities goes wierd
Type: Bug
Status: Unassigned
Priority: Minor
Time Spent: Unknown
Remaining: 0 minutes
Project: maven
Components:
plugin-xdoc
Versions:
1.0-beta-9
Assignee:
Reporter: Howard M. Lewis Ship
Created: Thu, 12 Jun 2003 7:50 AM
Updated: Mon, 23 Jun 2003 2:00 AM
Environment: windows xp, JDK 1.4.1
Description:
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?)
---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
If you want more information on JIRA, or have a bug to report see:
http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
