> The jcmd docs for Compiler.perfmap currently say:
> 
>     - *filename*: (Optional) The name of the map file (STRING, no default 
> value)
> 
> However, there is a default, so not only should that be made more clear in 
> the above, but also some descriptive text as to how the default is generated 
> should be added.
> 
> VM.cds has a similar issue, but already has the descriptive text, so just the 
> "no default value" part needs to be fixed.
> 
> Another change needed is to consistently use *filename* (italics) instead of 
> `filename` (monospace). Note this is how html formatting is done. For the man 
> page formatting, *filename* does no formatting and `filename` is displayed in 
> color if supported. Personally I prefer `filename`, but it seems that there 
> is already a strong precedence for using italics in the *arguments* list. For 
> example:
> 
>     *arguments*:
> 
>     - *flag name*: The name of the flag that you want to set (STRING, no
>         default value)
> 
>     - *string value*: (Optional) The value that you want to set (STRING, no
>         default value)

Chris Plummer has updated the pull request incrementally with two additional 
commits since the last revision:

 - Get rid of extra empty line.
 - Remove quotes from around filename to be consistent with how jcmd STRING 
defaults are printed.

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/17359/files
  - new: https://git.openjdk.org/jdk/pull/17359/files/7238d2d6..86fb2c37

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=17359&range=05
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=17359&range=04-05

  Stats: 3 lines in 2 files changed: 0 ins; 1 del; 2 mod
  Patch: https://git.openjdk.org/jdk/pull/17359.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/17359/head:pull/17359

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

Reply via email to