You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by "Arnaud Heritier (JIRA)" <ji...@codehaus.org> on 2005/08/22 13:42:33 UTC

[jira] Updated: (MPXDOC-17) xdoc with XML entities goes wierd

     [ http://jira.codehaus.org/browse/MPXDOC-17?page=all ]

Arnaud Heritier updated MPXDOC-17:
----------------------------------

    Assign To:     (was: Arnaud Heritier)

> xdoc with XML entities goes wierd
> ---------------------------------
>
>          Key: MPXDOC-17
>          URL: http://jira.codehaus.org/browse/MPXDOC-17
>      Project: maven-xdoc-plugin
>         Type: Bug
>  Environment: windows xp, JDK 1.4.1
>     Reporter: Howard M. Lewis Ship
>     Priority: Minor

>
>
> 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?)

-- 
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
-
For more information on JIRA, 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