[jira] Commented: (DOXIA-324) Doxia generates wrong xdoc when generating book from docbook

["Lukas Theussl (JIRA)" <ji...@codehaus.org>]

    [ http://jira.codehaus.org/browse/DOXIA-324?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=179572#action_179572 ] 

Lukas Theussl commented on DOXIA-324:
-------------------------------------

Thanks for testing and the feedback!

So a fix would be to check for the special case of article and emit the anchor after the document start.

However, I have some doubts:

* I checked that an id attribute is legal for article in simplified docbook, but I don't quite see the use case, what is it for?

* we have removed automatic anchor generation from the apt and xdoc parsers (see eg DOXIA-152), I think the docbook should do the same. If the id attribute of an element is preserved, then one can link to that, you don't need an anchor. However, I don't use docbook myself so I'm not too sure if this isn't going to break something I am not aware of. Especially in a point release we should try not to change any expected behavior, but in principle I would vote for removing the anchor insertion.

> Doxia generates wrong xdoc when generating book from docbook
> ------------------------------------------------------------
>
>                 Key: DOXIA-324
>                 URL: http://jira.codehaus.org/browse/DOXIA-324
>             Project: Maven Doxia
>          Issue Type: Bug
>    Affects Versions: 1.1
>            Reporter: Arne Limburg
>            Assignee: Lukas Theussl
>             Fix For: 1.1.1
>
>         Attachments: AbstractXdocBookSink.patch, doxia-book-sample.zip, doxia-book-sample.zip
>
>
> When generating a book from a docbook input the output is missing the starting document tag.

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