> Please review a patch to add support for Markdown syntax in documentation
> comments, as described in the associated JEP.
>
> Notable features:
>
> * support for `///` documentation comments in `JavaTokenizer`
> * new module `jdk.internal.md` -- a private copy of the `commonmark-java`
> libra
On Wed, 7 Feb 2024 00:16:57 GMT, Jonathan Gibbons wrote:
>> There are two cases that need consideration:
>> 1. A tree that is not modified during the transformation, as in the test
>> case here, so that all nodes should be "as before"
>> 2. A tree that is modified during the transformation, rais
> Please review a patch to add support for Markdown syntax in documentation
> comments, as described in the associated JEP.
>
> Notable features:
>
> * support for `///` documentation comments in `JavaTokenizer`
> * new module `jdk.internal.md` -- a private copy of the `commonmark-java`
> libra
On Tue, 6 Feb 2024 19:57:45 GMT, Jonathan Gibbons wrote:
>> Uugh. Noted.
>
> There are two cases that need consideration:
> 1. A tree that is not modified during the transformation, as in the test case
> here, so that all nodes should be "as before"
> 2. A tree that is modified during the trans
> Please review a patch to add support for Markdown syntax in documentation
> comments, as described in the associated JEP.
>
> Notable features:
>
> * support for `///` documentation comments in `JavaTokenizer`
> * new module `jdk.internal.md` -- a private copy of the `commonmark-java`
> libra
On Tue, 6 Feb 2024 19:27:55 GMT, Jonathan Gibbons wrote:
>> src/jdk.internal.md/share/classes/jdk/internal/markdown/MarkdownTransformer.java
>> line 1:
>>
>>> 1: /*
>>
>> This transformer seems to break positions of the `RawTextTree`.
>> For javadoc like:
>>
>> /// Mar
On Tue, 6 Feb 2024 07:08:13 GMT, Jan Lahoda wrote:
>> Jonathan Gibbons has updated the pull request incrementally with one
>> additional commit since the last revision:
>>
>> First pass at remove DocCommentTransformer from the public API.
>>
>> It is still declared internally, and instal
To the best of my knowledge, this has never been raised as an issue.
I doubt that this rises to the level of general interest, but you could
easily create user-defined tag to use in your own documentation if you
wanted that kind of stylized documentation. I would expect that
side-effects are b
On Tue, 6 Feb 2024 16:24:53 GMT, Magnus Ihse Bursie wrote:
>> According to [the
>> specification](https://docs.oracle.com/en/java/javase/19/docs/api/java.base/java/util/Properties.html#load(java.io.Reader))
>> trailing whitespaces in the values of properties files are (somewhat
>> surprisingly
javadoc has some changes/fixes/enhancements in this area in JDK 22, both
in the code and the Doc Comment Specification.
The intent is to better align the lookup for inherited comments with the
general lookup rules in JLS.
-- Jon
On 2/6/24 7:14 AM, I Al Istannen wrote:
Hey,
I hope this is t
Apologies if this belongs to javadoc-next-dev but that list looks dormant so I posted here. Was there ever a discussion about adding dedicated block tag for documenting side effects, e.g. @effects? For example Thread.interrupted() could say: @effects interrupted status of the thread is cleared
Hey,
I hope this is the right place to ask :)
I was recently implementing javadoc comment inheritance for spoon[0] and
verified it against IntelliJ IDEA and the standard html doclet. While
doing this I found out that IntelliJ and the standard doclet disagree on
comment inheritance in this exa
Hey,
I hope this is the right place to ask :)
I was recently implementing javadoc comment inheritance for spoon[0] and
verified it against IntelliJ IDEA and the standard html doclet. While
doing this I found out that IntelliJ and the standard doclet disagree on
comment inheritance in this exa
On Fri, 2 Dec 2022 16:36:22 GMT, Magnus Ihse Bursie wrote:
> According to [the
> specification](https://docs.oracle.com/en/java/javase/19/docs/api/java.base/java/util/Properties.html#load(java.io.Reader))
> trailing whitespaces in the values of properties files are (somewhat
> surprisingly) ac
On Thu, 1 Feb 2024 11:57:04 GMT, Magnus Ihse Bursie wrote:
> This is a follow-up on
> [JDK-8324053](https://bugs.openjdk.org/browse/JDK-8324053). I have run the
> bin/blessed-modifier-order.sh on the entire code base, and manually checked
> the result. I have reverted all but these trivial and
15 matches
Mail list logo
