https://gcc.gnu.org/g:dd2cc71e3898515a33970954d2bf7a4b67ea9790
commit r15-2386-gdd2cc71e3898515a33970954d2bf7a4b67ea9790 Author: Jonathan Wakely <jwak...@redhat.com> Date: Fri Mar 15 12:58:56 2024 +0000 doc: Improve punctuation and grammar in -fdiagnostics-format docs The hyphen can be misunderstood to mean "emitted to -" i.e. stdout. Refer to both forms by name, rather than using "the former" for one and referring to the other by name. gcc/ChangeLog: * doc/invoke.texi (Diagnostic Message Formatting Options): Replace hyphen with a new sentence. Replace "the former" with the actual value. Diff: --- gcc/doc/invoke.texi | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index e495b1271fa7..86f9b5d1fe5e 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -5865,8 +5865,9 @@ named @file{@var{source}.sarif}, respectively. The @samp{json} format is a synonym for @samp{json-stderr}. The @samp{json-stderr} and @samp{json-file} formats are identical, apart from -where the JSON is emitted to - with the former, the JSON is emitted to stderr, -whereas with @samp{json-file} it is written to @file{@var{source}.gcc.json}. +where the JSON is emitted to. With @samp{json-stderr}, the JSON is emitted +to stderr, whereas with @samp{json-file} it is written to +@file{@var{source}.gcc.json}. The emitted JSON consists of a top-level JSON array containing JSON objects representing the diagnostics.