This is a suggestion for improvement for https://docs.oracle.com/en/java/javase/12/tools/java.html
Both sections: FlightRecorderOptions and StartFlightRecording:

Both sections (FlightRecorderOptions and StartFlightRecording) mention this:
      "You can specify values for multiple parameters by separating them with a comma."

      This is correct, but this is mentioned at the end of the last option. Perhaps, it would
      be better to mention this at the beginning of the section for each command.
      Users of the documentation will not always read thru the whole section, if they are
      interested in just couple of options, and may not notice this statement at the end
      of the section.