Maven 1.x XDoc Plugin

Add a public DTD identifier for XDOC

Details

  • Type: Improvement Improvement
  • Status: Closed Closed
  • Priority: Major Major
  • Resolution: Fixed
  • Affects Version/s: None
  • Fix Version/s: 1.10
  • Component/s: None
  • Labels:
    None
  • Number of attachments :
    1

Description

To be able to automatically select the DTD for XDOC (which will be first released with the maven xdoc plugin), it would be good to define and add a public DTD identifier for the XDOC format. As discussed, I'd like to propose

<!DOCTYPE document PUBLIC "-//Apache Software Foundation//DTD XDOC 1.0//EN"
"http://www.apache.org/dtds/xdoc_1_0.dtd">

for the XDOC format. It would be great if you could also adopt this for the xdoc plugin (and change the name of the xdoc DTD file from the current 1.10 version to match the xdoc_1_0.dtd name.

Once the plugin is released, we can coordinate with the infra people to get the file in the referenced location.

Activity

Ascending order - Click to sort in descending order
Hide
Permalink
Henning Schmiedehausen added a comment -

To ensure that XML Editors like XMLMind are able to preserve the whitespace in the <source>..</source> blocks, please apply the attached patch to the DTD.

Show
Henning Schmiedehausen added a comment - To ensure that XML Editors like XMLMind are able to preserve the whitespace in the <source>..</source> blocks, please apply the attached patch to the DTD.
Hide
Permalink
Henning Schmiedehausen added a comment -

This is a patch which adds the xml:space attribute for source to the DTD. This is needed e.g. for XMLMind so source blocks don't get reformatted.

Show
Henning Schmiedehausen added a comment - This is a patch which adds the xml:space attribute for source to the DTD. This is needed e.g. for XMLMind so source blocks don't get reformatted.
Hide
Permalink
Lukas Theussl added a comment -

Patch applied in SVN.

Show
Lukas Theussl added a comment - Patch applied in SVN.
Hide
Permalink
Lukas Theussl added a comment -

Docs have been added.
I'd prefer to keep the name within the xdoc plugin so we are flexible to update it in a future release (not likely, but who knows). We will add a note in the README that it's identical to the file on http://www.apache.org/dtds/xdoc_1_0.dtd. I'll try to get the file uploaded there during the voting period.

Show
Lukas Theussl added a comment - Docs have been added. I'd prefer to keep the name within the xdoc plugin so we are flexible to update it in a future release (not likely, but who knows). We will add a note in the README that it's identical to the file on http://www.apache.org/dtds/xdoc_1_0.dtd. I'll try to get the file uploaded there during the voting period.
Hide
Permalink
Lukas Theussl added a comment -

The dtd will be at http://maven.apache.org/dtd/xdoc_1_0.dtd

Show
Lukas Theussl added a comment - The dtd will be at http://maven.apache.org/dtd/xdoc_1_0.dtd

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.