Re: RFR: 8318126: Refresh manpages

2023-10-17 Thread David Holmes
On Mon, 16 Oct 2023 23:55:01 GMT, Iris Clark  wrote:

>> The open nroff manpage files are out of sync with their closed markdown 
>> sources and need to be refreshed.
>> 
>> The changes to apply are coming from:
>> 
>> - [JDK-8288158](https://bugs.openjdk.org/browse/JDK-8288158): Add an anchor 
>> to each subcommand option on jfr html page
>> - [JDK-8273131](https://bugs.openjdk.org/browse/JDK-8273131): Update the 
>> java manpage markdown source for JFR filename expansion
>> - [JDK-8221633](https://bugs.openjdk.org/browse/JDK-8221633): 
>> StartFlightRecording: consider moving mention of multiple comma-separated 
>> parameters to the front
>> - [JDK-8308662](https://bugs.openjdk.org/browse/JDK-8308662): Update the 
>> "java" tool specification for CompileOnly
>> - [JDK-8317565](https://bugs.openjdk.org/browse/JDK-8317565): Update Manpage 
>> for obsoletion of UseSHM
>> - [JDK-8310460](https://bugs.openjdk.org/browse/JDK-8310460): Remove jdeps 
>> -profile option
>> 
>> There are also some simple line break changes, likely due to using different 
>> versions of the pandoc tool.
>> 
>> Thanks
>
> Marked as reviewed by iris (Reviewer).

Thanks @irisclark !

-

PR Comment: https://git.openjdk.org/jdk/pull/16196#issuecomment-1767198038


Re: RFR: 8318126: Refresh manpages

2023-10-16 Thread Iris Clark
On Mon, 16 Oct 2023 01:18:52 GMT, David Holmes  wrote:

> The open nroff manpage files are out of sync with their closed markdown 
> sources and need to be refreshed.
> 
> The changes to apply are coming from:
> 
> - [JDK-8288158](https://bugs.openjdk.org/browse/JDK-8288158): Add an anchor 
> to each subcommand option on jfr html page
> - [JDK-8273131](https://bugs.openjdk.org/browse/JDK-8273131): Update the java 
> manpage markdown source for JFR filename expansion
> - [JDK-8221633](https://bugs.openjdk.org/browse/JDK-8221633): 
> StartFlightRecording: consider moving mention of multiple comma-separated 
> parameters to the front
> - [JDK-8308662](https://bugs.openjdk.org/browse/JDK-8308662): Update the 
> "java" tool specification for CompileOnly
> - [JDK-8317565](https://bugs.openjdk.org/browse/JDK-8317565): Update Manpage 
> for obsoletion of UseSHM
> - [JDK-8310460](https://bugs.openjdk.org/browse/JDK-8310460): Remove jdeps 
> -profile option
> 
> There are also some simple line break changes, likely due to using different 
> versions of the pandoc tool.
> 
> Thanks

Marked as reviewed by iris (Reviewer).

-

PR Review: https://git.openjdk.org/jdk/pull/16196#pullrequestreview-1681114738


Re: RFR: 8318126: Refresh manpages

2023-10-16 Thread David Holmes
On Mon, 16 Oct 2023 06:02:02 GMT, Alan Bateman  wrote:

>> The open nroff manpage files are out of sync with their closed markdown 
>> sources and need to be refreshed.
>> 
>> The changes to apply are coming from:
>> 
>> - [JDK-8288158](https://bugs.openjdk.org/browse/JDK-8288158): Add an anchor 
>> to each subcommand option on jfr html page
>> - [JDK-8273131](https://bugs.openjdk.org/browse/JDK-8273131): Update the 
>> java manpage markdown source for JFR filename expansion
>> - [JDK-8221633](https://bugs.openjdk.org/browse/JDK-8221633): 
>> StartFlightRecording: consider moving mention of multiple comma-separated 
>> parameters to the front
>> - [JDK-8308662](https://bugs.openjdk.org/browse/JDK-8308662): Update the 
>> "java" tool specification for CompileOnly
>> - [JDK-8317565](https://bugs.openjdk.org/browse/JDK-8317565): Update Manpage 
>> for obsoletion of UseSHM
>> - [JDK-8310460](https://bugs.openjdk.org/browse/JDK-8310460): Remove jdeps 
>> -profile option
>> 
>> There are also some simple line break changes, likely due to using different 
>> versions of the pandoc tool.
>> 
>> Thanks
>
> Marked as reviewed by alanb (Reviewer).

Thanks for the reviews @AlanBateman and @Hamlin-Li

-

PR Comment: https://git.openjdk.org/jdk/pull/16196#issuecomment-1765289558


Re: RFR: 8318126: Refresh manpages

2023-10-16 Thread Hamlin Li
On Mon, 16 Oct 2023 01:18:52 GMT, David Holmes  wrote:

> The open nroff manpage files are out of sync with their closed markdown 
> sources and need to be refreshed.
> 
> The changes to apply are coming from:
> 
> - [JDK-8288158](https://bugs.openjdk.org/browse/JDK-8288158): Add an anchor 
> to each subcommand option on jfr html page
> - [JDK-8273131](https://bugs.openjdk.org/browse/JDK-8273131): Update the java 
> manpage markdown source for JFR filename expansion
> - [JDK-8221633](https://bugs.openjdk.org/browse/JDK-8221633): 
> StartFlightRecording: consider moving mention of multiple comma-separated 
> parameters to the front
> - [JDK-8308662](https://bugs.openjdk.org/browse/JDK-8308662): Update the 
> "java" tool specification for CompileOnly
> - [JDK-8317565](https://bugs.openjdk.org/browse/JDK-8317565): Update Manpage 
> for obsoletion of UseSHM
> - [JDK-8310460](https://bugs.openjdk.org/browse/JDK-8310460): Remove jdeps 
> -profile option
> 
> There are also some simple line break changes, likely due to using different 
> versions of the pandoc tool.
> 
> Thanks

Marked as reviewed by mli (Reviewer).

-

PR Review: https://git.openjdk.org/jdk/pull/16196#pullrequestreview-1679368261


Re: RFR: 8318126: Refresh manpages

2023-10-15 Thread Alan Bateman
On Mon, 16 Oct 2023 01:18:52 GMT, David Holmes  wrote:

> The open nroff manpage files are out of sync with their closed markdown 
> sources and need to be refreshed.
> 
> The changes to apply are coming from:
> 
> - [JDK-8288158](https://bugs.openjdk.org/browse/JDK-8288158): Add an anchor 
> to each subcommand option on jfr html page
> - [JDK-8273131](https://bugs.openjdk.org/browse/JDK-8273131): Update the java 
> manpage markdown source for JFR filename expansion
> - [JDK-8221633](https://bugs.openjdk.org/browse/JDK-8221633): 
> StartFlightRecording: consider moving mention of multiple comma-separated 
> parameters to the front
> - [JDK-8308662](https://bugs.openjdk.org/browse/JDK-8308662): Update the 
> "java" tool specification for CompileOnly
> - [JDK-8317565](https://bugs.openjdk.org/browse/JDK-8317565): Update Manpage 
> for obsoletion of UseSHM
> - [JDK-8310460](https://bugs.openjdk.org/browse/JDK-8310460): Remove jdeps 
> -profile option
> 
> There are also some simple line break changes, likely due to using different 
> versions of the pandoc tool.
> 
> Thanks

Marked as reviewed by alanb (Reviewer).

-

PR Review: https://git.openjdk.org/jdk/pull/16196#pullrequestreview-1679166064


RFR: 8318126: Refresh manpages

2023-10-15 Thread David Holmes
The open nroff manpage files are out of sync with their closed markdown sources 
and need to be refreshed.

The changes to apply are coming from:

- [JDK-8288158](https://bugs.openjdk.org/browse/JDK-8288158): Add an anchor to 
each subcommand option on jfr html page
- [JDK-8273131](https://bugs.openjdk.org/browse/JDK-8273131): Update the java 
manpage markdown source for JFR filename expansion
- [JDK-8221633](https://bugs.openjdk.org/browse/JDK-8221633): 
StartFlightRecording: consider moving mention of multiple comma-separated 
parameters to the front
- [JDK-8308662](https://bugs.openjdk.org/browse/JDK-8308662): Update the "java" 
tool specification for CompileOnly
- [JDK-8317565](https://bugs.openjdk.org/browse/JDK-8317565): Update Manpage 
for obsoletion of UseSHM
- [JDK-8310460](https://bugs.openjdk.org/browse/JDK-8310460): Remove jdeps 
-profile option

There are also some simple line break changes, likely due to using different 
versions of the pandoc tool.

Thanks

-

Commit messages:
 - 8318126: Refresh manpages

Changes: https://git.openjdk.org/jdk/pull/16196/files
 Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=16196&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8318126
  Stats: 115 lines in 4 files changed: 27 ins; 64 del; 24 mod
  Patch: https://git.openjdk.org/jdk/pull/16196.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/16196/head:pull/16196

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