[jira] Updated: (MAVEN-482) xdoc with XML entities goes wierd

[ji...@codehaus.org]

The following issue has been updated:

    Updater: Brett Porter (mailto:brettporter@yahoo.com)
       Date: Tue, 2 Sep 2003 7:07 PM
    Comment:
need for time to enlist the jellybots
    Changes:
             Version changed to 1.0-beta-10
             Component changed to jelly-integ
             Fix Version changed to 1.0-final
             Fix Version changed from 1.0-rc1
    ---------------------------------------------------------------------
For a full history of the issue, see:

  http://jira.codehaus.org/secure/ViewIssue.jspa?key=MAVEN-482&page=history

---------------------------------------------------------------------
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: Unknown

    Project: maven
 Components: 
             jelly-integ
             plugin-xdoc
   Fix Fors:
             1.0-final
   Versions:
             1.0-beta-9
             1.0-beta-10

   Assignee: 
   Reporter: Howard M. Lewis Ship

    Created: Thu, 12 Jun 2003 7:50 AM
    Updated: Tue, 2 Sep 2003 7:07 PM
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 '&lt;module&gt;'>
<!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 '&lt;IFactory&gt;'>

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: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org