On Tue, 20 Jan 2026, Jakub Jelinek wrote:
> Hi!
>
> Last night I was surprised because make check help.exp reported the missing
> dot at the end of cobol/lang.opt description below:
>
> Wmove-index
> Cobol Warning Var(move_index, 1) Init(1)
> Warn if MOVE INDEX is used
>
> but has not reported
>
> fexec-national-charset=
> Cobol Joined Var(cobol_national_charset) RejectNegative
> Set the default execution character set for NATIONAL data items
>
> a few lines earlier.
>
> The problem is that help.exp verified output of
> --help={common,optimizers,param,target,warnings} and just selected FEs:
> --help={ada,c,c++,d,fortran,go} and no other languages.
> Wmove-index above got reported because it appears in --help=warnings,
> but fexec-national-charset= didn't, because it only appears in --help=cobol
>
> So, the following patch adds 6 further languages to what help.exp tests
> and fixes the reported bugs.
>
> Tested on x86_64-linux, ok for trunk?
OK.
Richard.
> Note, Modula-2 seems to also not capitalize most of the descriptions,
> while all other *.opt files do, shall we fix that too incrementally?
I think so.
> 2026-01-20 Jakub Jelinek <[email protected]>
>
> gcc/testsuite/
> * gcc.misc-tests/help.exp: Check for descriptions without terminating
> dot or semicolon also for objc, objc++, rust, modula-2, cobol and
> algol68.
> gcc/rust/
> * lang.opt (frust-crate=, frust-extern=,
> frust-incomplete-and-experimental-compiler-do-not-use,
> frust-max-recursion-depth=, frust-crate-type=, frust-mangling=,
> frust-cfg=, frust-edition=, frust-embed-metadata,
> frust-metadata-output=, frust-compile-until=,
> frust-name-resolution-2.0, frust-panic=, frust-overflow-checks): Add
> dot at the end of the description.
> gcc/cobol/
> * lang.opt (fexec-national-charset=): Add dot at the end of the
> description.
> gcc/algol68/
> * lang.opt (std=algol68, std=gnu68): Add dot at the end of the
> description.
> gcc/m2/
> * lang.opt (Wpedantic-param-names, Wpedantic-cast, Wverbose-unbounded,
> Wstyle, fauto-init, fbounds, fcase, fcpp, fcpp-end, fcpp-begin,
> fdebug-builtins, fd, fdebug-function-line-numbers, fdef=,
> fdump-system-exports, fextended-opaque, ffloatvalue,
> fgen-module-list=, findex, fiso, flocation=, fm2-debug-trace=,
> fm2-dump=, fm2-dump-decl=, fm2-dump-gimple=, fm2-dump-quad=,
> fm2-dump-filter=, fm2-file-offset-bits=, fm2-g, fm2-lower-case,
> fm2-pathname=, fm2-pathname-root=, fm2-pathname-rootI=, fm2-plugin,
> fm2-prefix=, fm2-statistics, fm2-strict-type, fm2-strict-type-reason,
> fm2-whole-program, fmod=, fnil, fpim, fpim2, fpim3, fpim4,
> fpositive-mod-floor-div, fpthread, fq, frange, freturn,
> fruntime-modules=, fscaffold-dynamic, fscaffold-c, fscaffold-c++,
> fscaffold-main, fscaffold-static, fshared, fsoft-check-all, fsources,
> fswig, fuse-list=, fwideset, fwholediv, fwholevalue, save-temps,
> save-temps=): Add dot at the end of the description.
>
> --- gcc/testsuite/gcc.misc-tests/help.exp.jj 2026-01-02 22:41:17.364552147
> +0100
> +++ gcc/testsuite/gcc.misc-tests/help.exp 2026-01-20 01:55:30.446257015
> +0100
> @@ -144,7 +144,8 @@ check_for_options c "--help=joined,undoc
> # find the source a failure.
>
> foreach cls { "ada" "c" "c++" "d" "fortran" "go" \
> - "common" "optimizers" "param" "target" "warnings" } {
> + "objc" "objc++" "rust" "modula-2" "cobol" "algol68" \
> + "common" "optimizers" "param" "target" "warnings" } {
> check_for_options c "--help=$cls" "" "^ +-.*\[^:.\]$" ""
> }
>
> --- gcc/rust/lang.opt.jj 2026-01-02 22:41:17.328552744 +0100
> +++ gcc/rust/lang.opt 2026-01-20 02:05:42.916251018 +0100
> @@ -60,11 +60,11 @@ Warn for infinitely recursive calls.
>
> frust-crate=
> Rust Joined RejectNegative
> --frust-crate=<name> Set the crate name for the compilation
> +-frust-crate=<name> Set the crate name for the compilation.
>
> frust-extern=
> Rust RejectNegative Joined
> --frust-extern= Specify where an external library is located
> +-frust-extern= Specify where an external library is located.
>
> frust-debug
> Rust Var(flag_rust_debug)
> @@ -76,15 +76,15 @@ Rust Joined RejectNegative
>
> frust-incomplete-and-experimental-compiler-do-not-use
> Rust Var(flag_rust_experimental)
> -Enable experimental compilation of Rust files at your own risk
> +Enable experimental compilation of Rust files at your own risk.
>
> frust-max-recursion-depth=
> Rust RejectNegative Type(int) Var(rust_max_recursion_depth) Init(64)
> --frust-max-recursion-depth=<integer>
> +-frust-max-recursion-depth=<integer>.
>
> frust-crate-type=
> Rust Joined RejectNegative Enum(frust_crate_type) Var(flag_rust_crate_type)
> --frust-crate-type=[bin|lib|rlib|dylib|cdylib|staticlib|proc-macro] Crate
> type to emit
> +-frust-crate-type=[bin|lib|rlib|dylib|cdylib|staticlib|proc-macro] Crate
> type to emit.
>
> Enum
> Name(frust_crate_type) Type(int) UnknownError(unknown crate type: '%qs')
> @@ -112,7 +112,7 @@ Enum(frust_crate_type) String(proc-macro
>
> frust-mangling=
> Rust Joined RejectNegative Enum(frust_mangling) Var(flag_rust_mangling)
> --frust-mangling=[legacy|v0] Version to use for name mangling
> +-frust-mangling=[legacy|v0] Version to use for name mangling.
>
> Enum
> Name(frust_mangling) Type(int) UnknownError(unknown rust mangling option %qs)
> @@ -125,11 +125,11 @@ Enum(frust_mangling) String(v0) Value(1)
>
> frust-cfg=
> Rust Joined RejectNegative
> --frust-cfg=<name> Set a config expansion option
> +-frust-cfg=<name> Set a config expansion option.
>
> frust-edition=
> Rust Joined RejectNegative Enum(frust_edition) Var(flag_rust_edition)
> --frust-edition=[2015|2018|2021] Edition to use when compiling
> rust code
> +-frust-edition=[2015|2018|2021] Edition to use when compiling
> rust code.
>
> Enum
> Name(frust_edition) Type(int) UnknownError(unknown rust edition %qs)
> @@ -145,11 +145,11 @@ Enum(frust_edition) String(2021) Value(2
>
> frust-embed-metadata
> Rust Var(flag_rust_embed_metadata)
> -Enable embedding metadata directly into object files
> +Enable embedding metadata directly into object files.
>
> frust-metadata-output=
> Rust Joined RejectNegative
> --frust-metadata-output=<path.rox> Path to output crate metadata
> +-frust-metadata-output=<path.rox> Path to output crate metadata.
>
> o
> Rust Joined Separate
> @@ -157,7 +157,7 @@ Rust Joined Separate
>
> frust-compile-until=
> Rust Joined RejectNegative Enum(frust_compile_until)
> Var(flag_rust_compile_until)
> --frust-compile-until=[ast|attributecheck|expansion|astvalidation|featuregating|nameresolution|lowering|typecheck|privacy|unsafety|const|borrowcheck|compilation|end]
> The pipeline will run up until this stage when compiling Rust
> code
> +-frust-compile-until=[ast|attributecheck|expansion|astvalidation|featuregating|nameresolution|lowering|typecheck|privacy|unsafety|const|borrowcheck|compilation|end]
> The pipeline will run up until this stage when compiling Rust
> code.
>
> Enum
> Name(frust_compile_until) Type(int) UnknownError(unknown rust compile-until
> %qs)
> @@ -206,7 +206,7 @@ Enum(frust_compile_until) String(end) Va
>
> frust-name-resolution-2.0
> Rust Var(flag_name_resolution_2_0) Init(1)
> -Use the temporary and experimental name resolution pipeline instead of the
> stable one
> +Use the temporary and experimental name resolution pipeline instead of the
> stable one.
>
> frust-borrowcheck
> Rust Var(flag_borrowcheck)
> @@ -214,7 +214,7 @@ Use the WIP borrow checker.
>
> frust-panic=
> Rust Joined RejectNegative Enum(frust_panic) Var(flag_rust_panic)
> --frust-edition=[unwind|abort] Panic strategy to compile crate
> with
> +-frust-edition=[unwind|abort] Panic strategy to compile crate
> with.
>
> Enum
> Name(frust_panic) Type(int) UnknownError(unknown panic strategy %qs)
> @@ -227,11 +227,11 @@ Enum(frust_panic) String(abort) Value(1)
>
> frust-overflow-checks
> Rust Var(flag_overflow_checks) Init(1)
> -Enable the overflow checks in code generation
> +Enable the overflow checks in code generation.
>
> frust-assume-builtin-offset-of
> Rust Var(flag_assume_builtin_offset_of)
> -Define a built-in offset_of macro in the compiler and assume it is present
> +Define a built-in offset_of macro in the compiler and assume it is present.
>
> frust-unused-check-2.0
> Rust Var(flag_unused_check_2_0)
> --- gcc/cobol/lang.opt.jj 2026-01-20 01:29:54.856866624 +0100
> +++ gcc/cobol/lang.opt 2026-01-20 01:56:57.868828783 +0100
> @@ -79,7 +79,7 @@ Cobol Joined Var(cobol_charset) RejectNe
>
> fexec-national-charset=
> Cobol Joined Var(cobol_national_charset) RejectNegative
> -Set the default execution character set for NATIONAL data items
> +Set the default execution character set for NATIONAL data items.
>
> ;; warnings
>
> --- gcc/algol68/lang.opt.jj 2026-01-02 22:41:16.716562890 +0100
> +++ gcc/algol68/lang.opt 2026-01-20 01:57:30.548294894 +0100
> @@ -102,11 +102,11 @@ Link the GNU Algol 68 run-time library d
>
> std=algol68
> Algol68
> -Compile strict Algol 68 as defined by the Revised Report
> +Compile strict Algol 68 as defined by the Revised Report.
>
> std=gnu68
> Algol68
> -Accept GNU extensions to Algol 68
> +Accept GNU extensions to Algol 68.
>
> ; Stropping regimes.
>
> --- gcc/m2/lang.opt.jj 2026-01-02 22:41:17.249554054 +0100
> +++ gcc/m2/lang.opt 2026-01-20 02:03:25.286499494 +0100
> @@ -36,19 +36,19 @@ turns on case statement label compile ti
>
> Wpedantic-param-names
> Modula-2
> -compiler checks to force definition module procedure parameter names with
> their implementation module counterpart
> +compiler checks to force definition module procedure parameter names with
> their implementation module counterpart.
>
> Wpedantic-cast
> Modula-2
> -compiler warns if a cast is being used on types of differing sizes
> +compiler warns if a cast is being used on types of differing sizes.
>
> Wverbose-unbounded
> Modula-2
> -inform user which parameters will be passed by reference
> +inform user which parameters will be passed by reference.
>
> Wstyle
> Modula-2
> -extra compile time semantic checking, typically tries to catch poor
> programming style
> +extra compile time semantic checking, typically tries to catch poor
> programming style.
>
> Wuninit-variable-checking
> Modula-2
> @@ -60,67 +60,67 @@ turns on compile time analysis to detect
>
> fauto-init
> Modula-2
> -automatically initializes all pointers to NIL
> +automatically initializes all pointers to NIL.
>
> fbounds
> Modula-2
> -turns on runtime subrange, array index and indirection via NIL pointer
> checking
> +turns on runtime subrange, array index and indirection via NIL pointer
> checking.
>
> fcase
> Modula-2
> -turns on runtime checking to check whether a CASE statement requires an ELSE
> clause when one was not specified
> +turns on runtime checking to check whether a CASE statement requires an ELSE
> clause when one was not specified.
>
> fcpp
> Modula-2
> -use cpp to preprocess the module
> +use cpp to preprocess the module.
>
> fcpp-end
> Modula-2
> -passed to the preprocessor if -fcpp is used (internal switch)
> +passed to the preprocessor if -fcpp is used (internal switch).
>
> fcpp-begin
> Modula-2
> -passed to the preprocessor if -fcpp is used (internal switch)
> +passed to the preprocessor if -fcpp is used (internal switch).
>
> fdebug-builtins
> Modula-2
> -call a real function, rather than the builtin equivalent
> +call a real function, rather than the builtin equivalent.
>
> fd
> Modula-2
> -turn on internal debugging of the compiler (internal switch)
> +turn on internal debugging of the compiler (internal switch).
>
> fdebug-function-line-numbers
> Modula-2
> -turn on tracing of procedure line numbers (internal switch)
> +turn on tracing of procedure line numbers (internal switch).
>
> fdef=
> Modula-2 Joined
> -recognize the specified suffix as a definition module filename
> +recognize the specified suffix as a definition module filename.
>
> fdump-system-exports
> Modula-2
> -display all inbuilt system items
> +display all inbuilt system items.
>
> fextended-opaque
> Modula-2
> -allows opaque types to be implemented as any type (a GNU Modula-2 extension)
> +allows opaque types to be implemented as any type (a GNU Modula-2 extension).
>
> ffloatvalue
> Modula-2
> -turns on runtime checking to check whether a floating point number will
> exceed range
> +turns on runtime checking to check whether a floating point number will
> exceed range.
>
> fgen-module-list=
> Modula-2 Joined
> -create a topologically sorted module list from all dependent modules used in
> the application
> +create a topologically sorted module list from all dependent modules used in
> the application.
>
> findex
> Modula-2
> -turns on all range checking for numerical values
> +turns on all range checking for numerical values.
>
> fiso
> Modula-2
> -use ISO dialect of Modula-2
> +use ISO dialect of Modula-2.
>
> flibs=
> Modula-2 Joined
> @@ -128,47 +128,47 @@ specify the library order, the libraries
>
> flocation=
> Modula-2 Joined
> -set all location values to a specific value (internal switch)
> +set all location values to a specific value (internal switch).
>
> fm2-debug-trace=
> Modula-2 Joined
> -turn on internal debug tracing for quad,token,line,all (internal switch)
> +turn on internal debug tracing for quad,token,line,all (internal switch).
>
> fm2-dump=
> Modula-2 Joined
> -dump Modula-2 internal intemediate representation specified by:
> all,quad,decl,gimple
> +dump Modula-2 internal intemediate representation specified by:
> all,quad,decl,gimple.
>
> fm2-dump-decl=
> Modula-2 Joined
> -dump Modula-2 decls to the filename stem specified
> +dump Modula-2 decls to the filename stem specified.
>
> fm2-dump-gimple=
> Modula-2 Joined
> -dump Modula-2 gimple to the filename stem specified
> +dump Modula-2 gimple to the filename stem specified.
>
> fm2-dump-quad=
> Modula-2 Joined
> -dump Modula-2 quads to the filename stem specified
> +dump Modula-2 quads to the filename stem specified.
>
> fm2-dump-filter=
> Modula-2 Joined
> -filter the language dump using a comma separated list of procedures and
> modules
> +filter the language dump using a comma separated list of procedures and
> modules.
>
> fm2-file-offset-bits=
> Modula-2 Joined
> -override the default 64 bit definition of SYSTEM.COFF_T with the argument
> specified
> +override the default 64 bit definition of SYSTEM.COFF_T with the argument
> specified.
>
> fm2-g
> Modula-2
> -generate extra nops to improve debugging, producing an instruction for every
> code related keyword
> +generate extra nops to improve debugging, producing an instruction for every
> code related keyword.
>
> fm2-lower-case
> Modula-2
> -generate error messages which render keywords in lower case
> +generate error messages which render keywords in lower case.
>
> fm2-pathname=
> Modula-2 Joined
> -specify the module mangled prefix name for all modules in the following
> include paths
> +specify the module mangled prefix name for all modules in the following
> include paths.
>
> fm2-pathnameI
> Modula-2 Joined
> @@ -176,7 +176,7 @@ Modula-2 Joined
>
> fm2-pathname-root=
> Modula-2 Joined
> -add include paths for all the library names in -flibs= to this directory root
> +add include paths for all the library names in -flibs= to this directory
> root.
>
> fm2-pathname-rootI=
> Modula-2 Joined
> @@ -184,27 +184,27 @@ Modula-2 Joined
>
> fm2-plugin
> Modula-2
> -insert plugin to identify runtime errors at compiletime
> +insert plugin to identify runtime errors at compiletime.
>
> fm2-prefix=
> Modula-2 Joined
> -specify the module mangled prefix name
> +specify the module mangled prefix name.
>
> fm2-statistics
> Modula-2
> -display statistics about the amount of source lines compiled and symbols used
> +display statistics about the amount of source lines compiled and symbols
> used.
>
> fm2-strict-type
> Modula-2
> -experimental flag to turn on the new strict type checker
> +experimental flag to turn on the new strict type checker.
>
> fm2-strict-type-reason
> Modula-2
> -provides more detail why the types are incompatible
> +provides more detail why the types are incompatible.
>
> fm2-whole-program
> Modula-2
> -compile all implementation modules and program module at once
> +compile all implementation modules and program module at once.
>
> fmem-report
> Modula-2
> @@ -212,87 +212,87 @@ Modula-2
>
> fmod=
> Modula-2 Joined
> -recognize the specified suffix as implementation and module filenames
> +recognize the specified suffix as implementation and module filenames.
>
> fnil
> Modula-2
> -turns on runtime checking to detect accessing data through a NIL value
> pointer
> +turns on runtime checking to detect accessing data through a NIL value
> pointer.
>
> fpim
> Modula-2
> -use PIM [234] dialect of Modula-2
> +use PIM [234] dialect of Modula-2.
>
> fpim2
> Modula-2
> -use PIM 2 dialect of Modula-2
> +use PIM 2 dialect of Modula-2.
>
> fpim3
> Modula-2
> -use PIM 3 dialect of Modula-2
> +use PIM 3 dialect of Modula-2.
>
> fpim4
> Modula-2
> -use PIM 4 dialect of Modula-2
> +use PIM 4 dialect of Modula-2.
>
> fpositive-mod-floor-div
> Modula-2
> -force positive result from MOD and DIV result floor
> +force positive result from MOD and DIV result floor.
>
> fpthread
> Modula-2
> -link against the pthread library (default on)
> +link against the pthread library (default on).
>
> fq
> Modula-2
> -internal compiler debugging information, dump the list of quadruples
> +internal compiler debugging information, dump the list of quadruples.
>
> frange
> Modula-2
> -turns on all range checking for numerical values
> +turns on all range checking for numerical values.
>
> freturn
> Modula-2
> -turns on runtime checking for functions which finish without executing a
> RETURN statement
> +turns on runtime checking for functions which finish without executing a
> RETURN statement.
>
> fruntime-modules=
> Modula-2 Joined
> -specify the list of runtime modules and their initialization order
> +specify the list of runtime modules and their initialization order.
>
> fscaffold-dynamic
> Modula-2
> -the modules initialization order is dynamically determined by M2RTS and
> application dependencies
> +the modules initialization order is dynamically determined by M2RTS and
> application dependencies.
>
> fscaffold-c
> Modula-2
> -generate a C source scaffold for the current module being compiled
> +generate a C source scaffold for the current module being compiled.
>
> fscaffold-c++
> Modula-2
> -generate a C++ source scaffold for the current module being compiled
> +generate a C++ source scaffold for the current module being compiled.
>
> fscaffold-main
> Modula-2
> -generate the main function
> +generate the main function.
>
> fscaffold-static
> Modula-2
> -generate static scaffold initialization and finalization for every module
> inside main
> +generate static scaffold initialization and finalization for every module
> inside main.
>
> fshared
> Modula-2
> -generate a shared library from the module
> +generate a shared library from the module.
>
> fsoft-check-all
> Modula-2
> -turns on all software runtime checking (an abbreviation for -fnil -frange
> -findex -fwholediv -fcase -freturn -fwholevalue -ffloatvalue)
> +turns on all software runtime checking (an abbreviation for -fnil -frange
> -findex -fwholediv -fcase -freturn -fwholevalue -ffloatvalue).
>
> fsources
> Modula-2
> -display the location of module source files as they are compiled
> +display the location of module source files as they are compiled.
>
> fswig
> Modula-2
> -create a swig interface file for the module
> +create a swig interface file for the module.
>
> ftime-report
> Modula-2
> @@ -304,7 +304,7 @@ optimize non var unbounded parameters by
>
> fuse-list=
> Modula-2 Joined
> -orders the initialization/finalizations for scaffold-static or force linking
> of modules if scaffold-dynamic
> +orders the initialization/finalizations for scaffold-static or force linking
> of modules if scaffold-dynamic.
>
> fversion
> Modula-2
> @@ -312,15 +312,15 @@ Modula-2
>
> fwideset
> Modula-2
> -link against the module M2WIDESET to perform the wideset operator, the
> negative version of this option will generate a warning if this module is
> required
> +link against the module M2WIDESET to perform the wideset operator, the
> negative version of this option will generate a warning if this module is
> required.
>
> fwholediv
> Modula-2
> -turns on all division and modulus by zero checking for ordinal values
> +turns on all division and modulus by zero checking for ordinal values.
>
> fwholevalue
> Modula-2
> -turns on runtime checking to check whether a whole number will exceed range
> +turns on runtime checking to check whether a whole number will exceed range.
>
> static-libgm2
> Driver
> @@ -469,11 +469,11 @@ Modula-2 Alias(save-temps)
>
> save-temps
> Modula-2
> -save temporary preprocessed files
> +save temporary preprocessed files.
>
> save-temps=
> Modula-2 Joined
> -save temporary preprocessed files
> +save temporary preprocessed files.
>
> traditional-cpp
> Modula-2
>
> Jakub
>
>
--
Richard Biener <[email protected]>
SUSE Software Solutions Germany GmbH,
Frankenstrasse 146, 90461 Nuernberg, Germany;
GF: Jochen Jaser, Andrew McDonald, Werner Knoblich; (HRB 36809, AG Nuernberg)
