Re: RFR: 8180066: Convert package.html files to package-info.java

2023-06-22 Thread Kevin Rushforth
On Wed, 21 Jun 2023 15:05:47 GMT, Kevin Rushforth wrote: > One thing I didn't do is add a * at the beginning of the lines that are now > part of a javadoc-style comment block. This minimizes the diffs, but it means > we won't be using the usual pattern for those comment blocks. I'm inclined to

Re: RFR: 8180066: Convert package.html files to package-info.java

2023-06-21 Thread Kevin Rushforth
On Wed, 21 Jun 2023 18:54:40 GMT, Andy Goryachev wrote: > I guess we don't change the copyright year because we don't change the actual > content? Or should it be changed? Right. Even if we did want to change it, I would just let our copyright scripts update it, rather than doing it manually (

Re: RFR: 8180066: Convert package.html files to package-info.java

2023-06-21 Thread Andy Goryachev
On Wed, 21 Jun 2023 15:05:47 GMT, Kevin Rushforth wrote: > This is a doc cleanup task to convert all `package.html` files to > `package-info.java`, which is the recommended way to provide package > documentation. > > The first commit is the result of running a shell script that > @jonathan-gi

Re: RFR: 8180066: Convert package.html files to package-info.java

2023-06-21 Thread Kevin Rushforth
On Wed, 21 Jun 2023 18:35:50 GMT, Andy Goryachev wrote: > String converters link got lost in allpackages-index and index-all. is this > intentional? It's the other way around. That link is _not_ present in the existing JavaFX API docs because of the redundant first sentence. It is now there be

Re: RFR: 8180066: Convert package.html files to package-info.java

2023-06-21 Thread Kevin Rushforth
On Wed, 21 Jun 2023 15:05:47 GMT, Kevin Rushforth wrote: > This is a doc cleanup task to convert all `package.html` files to > `package-info.java`, which is the recommended way to provide package > documentation. > > The first commit is the result of running a shell script that > @jonathan-gi

Re: RFR: 8180066: Convert package.html files to package-info.java

2023-06-21 Thread Andy Goryachev
On Wed, 21 Jun 2023 15:05:47 GMT, Kevin Rushforth wrote: > This is a doc cleanup task to convert all `package.html` files to > `package-info.java`, which is the recommended way to provide package > documentation. > > The first commit is the result of running a shell script that > @jonathan-gi

Re: RFR: 8180066: Convert package.html files to package-info.java

2023-06-21 Thread Andy Goryachev
On Wed, 21 Jun 2023 15:05:47 GMT, Kevin Rushforth wrote: > This is a doc cleanup task to convert all `package.html` files to > `package-info.java`, which is the recommended way to provide package > documentation. > > The first commit is the result of running a shell script that > @jonathan-gi