[jira] Commented: (DOXIA-138) Review and clarify the APT guide

["Denis Cabasson (JIRA)" <ji...@codehaus.org>]

    [ http://jira.codehaus.org/browse/DOXIA-138?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_103924 ] 

Denis Cabasson commented on DOXIA-138:
--------------------------------------

the guide states :
"Section titles are implicitly defined anchors." however, it doesn't seem to be the case.

Still for anchors, they are rewritten in minuscule, with spaces distilled to '_'. That should be somewhere in the documentation....

> 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