[ http://jira.codehaus.org/browse/DOXIA-138?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_104917 ]
Lukas Theussl commented on DOXIA-138: ------------------------------------- I really don't like section titles as anchors. IMO, if you want to reference a section, you should explicitly provide an anchor. The use of automatically constructed anchors from section titles was discouraged in one of the last versions of the m1 xdoc plugin [1] as it only led to trouble (see MPXDOC-158 and MPPDF-40 for related discussions). We will have the same sort of problems in doxia if we implement that, so my preference would be to remove this statement from the user guide. [1] http://maven.apache.org/maven-1.x/plugins/xdoc/reference/xdocs.html#Referencing_sections_and_subsections > Review and clarify the APT guide > -------------------------------- > > Key: DOXIA-138 > URL: http://jira.codehaus.org/browse/DOXIA-138 > Project: Maven Doxia > Issue Type: Task > Components: Documentation, Module - Apt > Affects Versions: 1.0-alpha-8 > Reporter: Lukas Theussl > Fix For: 1.0 > > > Our current apt guide is a copy of > http://www.xmlmind.com/_aptconvert/docs/userguide2.html, but there are > several issues that need clarification, eg > * case sensitivity and white space handling in anchors > * anchors for section titles > * figure handling, esp extensions > * tables: is the first line always a header row? > Some of these depend on how things are going to be implemented. > We also decided to remove the apt guide at > http://maven.apache.org/guides/mini/guide-apt-format.html and only keep the > one on the doxia site. -- 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