On Mon, 3 Jun 2024 17:26:52 GMT, Nizar Benalla <nbena...@openjdk.org> wrote:
> Can I please get a review for this small change? The motivation is that javac
> does not recognize `package.html` files.
>
> The conversion was simple, I used a script to rename the files, append "*" on
> the left and remove some HTML tags like `<body>` and `<html>`. I did the
> conversion in place, renaming them in git but with the big amount of change
> `git` thinks it's a new file.
>
> I also added a new `package-info.java` file to `javax.naming.ldap.spi`. I
> hope that's fine.
I recommend having the new package-info.java files follow the now-current
javadoc conventions including:
* Using `{@code foo}` in preference to `<code>foo</code>`
* Using the `@snippet` tag in preference to `<blockquore><pre>`
* etc.
-------------
PR Comment: https://git.openjdk.org/jdk/pull/19529#issuecomment-2146157205
