[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openjdk-2d-dev
Subject:    Integrated: 8330178: Clean up non-standard use of /** comments in `java.base`
From:       Jonathan Gibbons <jjg () openjdk ! org>
Date:       2024-04-23 18:46:34
Message-ID: Hf-QMEmB4eLr-CA0UEIiWRwxxplcD-ZKUVbOJ44BPsc=.20073ab8-4ece-463c-a4e4-afdba6586f28 () github ! com
[Download RAW message or body]

On Thu, 18 Apr 2024 20:44:00 GMT, Jonathan Gibbons <jjg@openjdk.org> wrote:

> Please review a set of updates to clean up use of `/**` comments in the vicinity of \
> declarations. 
> There are various categories of update:
> 
> * "Box comments" beginning with `/**`
> * Misplaced doc comments before package or import statements
> * Misplaced doc comments after the annotations for a declaration
> * Dangling `/**` comments relating to a group of declarations, separate from the \
>                 doc comments for each of those declarations
> * Use of `/**` for the legal header at or near the top of the file
> 
> In one case, two doc comments before a declaration were merged, which fixes a \
> bug/omission in the documented serialized form.

This pull request has now been integrated.

Changeset: 9cc163a9
Author:    Jonathan Gibbons <jjg@openjdk.org>
URL:       https://git.openjdk.org/jdk/commit/9cc163a999eb8e9597d45b095b642c25071043bd
                
Stats:     134 lines in 23 files changed: 50 ins; 56 del; 28 mod

8330178: Clean up non-standard use of /** comments in `java.base`

Reviewed-by: darcy, iris, dfuchs, aivanov, naoto

-------------

PR: https://git.openjdk.org/jdk/pull/18846


[prev in list] [next in list] [prev in thread] [next in thread]