[
https://issues.apache.org/jira/browse/GROOVY-11945?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Paul King updated GROOVY-11945:
-------------------------------
Description:
Javadoc has supported three additional block tags since JEP 172: @apiNote
(guidance for callers), @implSpec (contract that overriders must preserve), and
@implNote (non-contract implementation detail). Groovydoc does not recognise
any of
them. They currently fall through the unknown-tag path and render inline at
source position as a plain generic block with the raw tag name as its label,
e.g. "implNote:" instead of "Implementation Note:", and they appear wherever
the
author wrote them rather than being collated with @param / @return in the
method's tag section.
> recognise @apiNote, @implSpec, @implNote block tags in groovydoc
> ----------------------------------------------------------------
>
> Key: GROOVY-11945
> URL: https://issues.apache.org/jira/browse/GROOVY-11945
> Project: Groovy
> Issue Type: Improvement
> Reporter: Paul King
> Priority: Major
>
> Javadoc has supported three additional block tags since JEP 172: @apiNote
> (guidance for callers), @implSpec (contract that overriders must preserve),
> and @implNote (non-contract implementation detail). Groovydoc does not
> recognise any of
> them. They currently fall through the unknown-tag path and render inline at
> source position as a plain generic block with the raw tag name as its label,
> e.g. "implNote:" instead of "Implementation Note:", and they appear wherever
> the
> author wrote them rather than being collated with @param / @return in the
> method's tag section.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
