[
https://issues.apache.org/jira/browse/DOXIA-754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Konrad Windszus resolved DOXIA-754.
-----------------------------------
Fix Version/s: 2.1.0
Resolution: Fixed
Clarified javadoc in
https://github.com/apache/maven-doxia/commit/e6190a9aa5121bfda9bb4efac3acd4cbbfee5880.
> Clarify Sink method order for nested lists
> ------------------------------------------
>
> Key: DOXIA-754
> URL: https://issues.apache.org/jira/browse/DOXIA-754
> Project: Maven Doxia
> Issue Type: Improvement
> Components: Core
> Reporter: Konrad Windszus
> Assignee: Konrad Windszus
> Priority: Major
> Fix For: 2.1.0
>
>
> From the [Sink Javadoc of
> list()|https://maven.apache.org/doxia/doxia/doxia-sink-api/apidocs/org/apache/maven/doxia/sink/Sink.html#list-org.apache.maven.doxia.sink.SinkEventAttributes-]
> (or the other related list methods) it is not clear how to properly nest
> lists/list items
> There are different options:
> {code}
> list();
> listItem();
> text("level 1")
> listItem();
> text("level 1.1")
> listItem_();
> listItem_();
> list_();
> {code}
> or
> {code}
> list();
> listItem();
> text("level 1")
> list();
> listItem();
> text("level 1.1")
> listItem_();
> list_();
> listItem_();
> list_();
> {code}
>
> This should be clarified, so that it is clear for both Sink impls as well as
> Sink API users which order to expect/use.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
