completions/gcc: Improve some descriptions

This file is autogenerated, and these descriptions need quite a
cleanup.

This does the first 10% or so.

[ci skip]

share/completions/gcc.fish

@@ -26,7 +26,7 @@ for i in 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
 end
 
 complete -c gcc -s o -d 'Place output in file' -r
-complete -c gcc -o aux-info -d 'Output to the given filename prototyped declarations for all functions declared and/or defined in a translation unit, including those in header files' -r
+complete -c gcc -o aux-info -d 'Output to given file prototyped declarations for all functions from a translation unit' -r
 complete -c gcc -o fabi-version -d 'Use specified version of the C++ ABI' -xa "0 1"
 complete -c gcc -l sysroot -x -a '(__fish_complete_directories)' -d 'Use dir as the logical root directory for headers and libraries'
 
@@ -37,72 +37,71 @@ complete -c gcc -l sysroot -x -a '(__fish_complete_directories)' -d 'Use dir as
 
 complete -c gcc -o pass-exit-codes -d 'Return the highest error returned by any phase'
 complete -c gcc -s c -d 'Compile or assemble the source files, but do not link'
-complete -c gcc -s S -d 'Stop after the stage of compilation proper; do not assemble'
-complete -c gcc -s E -d 'Stop after the preprocessing stage; do not run the compiler proper'
-complete -c gcc -s v -d 'Print (on standard error output) the commands executed to run the stages of compilation'
-complete -c gcc -o \#\#\# -d 'Like -v except the commands are not executed and all command arguments are quoted'
-complete -c gcc -o pipe -d 'Use pipes rather than temporary files for communication between the various stages of compilation'
-complete -c gcc -o combine -d 'If you are compiling multiple source files, this option tells the driver to pass all the source files to the compiler at once (for those languages for which the compiler can handle this)'
-complete -c gcc -l help -d 'Print a description of the command line options understood by gcc'
-complete -c gcc -l target-help -d 'Print a description of target specific command line options for each tool'
-complete -c gcc -l version -d 'Display the version number and copyrights of the invoked GCC'
-complete -c gcc -o ansi -d 'In C mode, support all ISO C90 programs'
-complete -c gcc -o fno-asm -d 'Do not recognize "asm", "inline" or "typeof" as a keyword, so that code can use these words as identifiers'
-complete -c gcc -o fno-builtin -d 'Don’t recognize built-in functions that do not begin with __builtin_ as prefix'
+complete -c gcc -s S -d 'Do not assemble'
+complete -c gcc -s E -d 'Stop after preprocessing'
+complete -c gcc -s v -d 'Print to stderr the commands executed to run compilation'
+complete -c gcc -o \#\#\# -d 'Like -v except commands are not executed and all command arguments are quoted'
+complete -c gcc -o pipe -d 'Use pipes not temp files for communication'
+complete -c gcc -o combine -d 'Pass all the source files to the compiler at once'
+complete -c gcc -l help -d 'Print help'
+complete -c gcc -l target-help -d 'Print a description of target specific options for each tool'
+complete -c gcc -l version -d 'Display the version number and copyrights'
+complete -c gcc -o ansi -d 'Support all ISO C90 programs'
+complete -c gcc -o fno-asm -d 'No "asm", "inline" or "typeof" as keyword, so code can use these as identifiers'
+complete -c gcc -o fno-builtin -d 'Don’t recognize built-in functions without __builtin_ prefix'
 complete -c gcc -o fno-builtin-function -d 'Don’t recognize built-in functions that do not begin with __builtin_ as prefix'
 complete -c gcc -o fhosted -d 'Assert that compilation takes place in a hosted environment'
 complete -c gcc -o ffreestanding -d 'Assert that compilation takes place in a freestanding environment'
 complete -c gcc -o fms-extensions -d 'Accept some non-standard constructs used in Microsoft header files'
 complete -c gcc -o trigraphs -d 'Support ISO C trigraphs'
 complete -c gcc -o no-integrated-cpp -d 'Performs a compilation in two passes: preprocessing and compiling'
-complete -c gcc -o traditional -d 'Formerly, these options caused GCC to attempt to emulate a prestandard C compiler'
-complete -c gcc -o traditional-cpp -d 'Formerly, these options caused GCC to attempt to emulate a prestandard C compiler'
-complete -c gcc -o fcond-mismatch -d 'Allow conditional expressions with mismatched types in the second and third arguments'
-complete -c gcc -o funsigned-char -d 'Let the type "char" be unsigned, like "unsigned char"'
-complete -c gcc -o fsigned-char -d 'Let the type "char" be signed, like "signed char"'
+complete -c gcc -o traditional -o traditional-cpp -d 'Try to imitate pre-standard C preprocessors'
+complete -c gcc -o fcond-mismatch -d 'Allow conditional expressions with mismatched types'
+complete -c gcc -o funsigned-char -d 'Let "char" be unsigned, like "unsigned char"'
+complete -c gcc -o fsigned-char -d 'Let "char" be signed, like "signed char"'
 complete -c gcc -o fsigned-bitfields -d 'Treat bitfields as signed by default'
 complete -c gcc -o funsigned-bitfields -d 'Treat bitfields as unsigned by default'
 complete -c gcc -o fno-signed-bitfields -d 'Remove fsigned-bitfields'
 complete -c gcc -o fno-unsigned-bitfields -d 'Remove funsinged-bitfields'
 complete -c gcc -o fno-access-control -d 'Turn off all access checking'
-complete -c gcc -o fcheck-new -d 'Check that the pointer returned by "operator new" is non-null before attempting to modify the storage allocated'
+complete -c gcc -o fcheck-new -d 'Check pointer returned by "operator new" is non-null before attempting to modify allocated storage'
 complete -c gcc -o fconserve-space -d 'Put uninitialized or runtime-initialized global variables into the common segment, as C does'
-complete -c gcc -o ffriend-injection -d 'Inject friend functions into the enclosing namespace, so that they are visible outside the scope of the class in which they are declared'
-complete -c gcc -o fno-const-strings -d 'Give string constants type "char *" instead of type "const char *"'
-complete -c gcc -o fno-elide-constructors -d 'The C++ standard allows an implementation to omit creating a temporary which is only used to initialize another object of the same type'
+complete -c gcc -o ffriend-injection -d 'Inject friend functions into enclosing namespace'
+complete -c gcc -o fno-const-strings -d 'Give string constants type "char *" without const'
+complete -c gcc -o fno-elide-constructors -d "Don't elide temporaries used to construct objects"
 complete -c gcc -o fno-enforce-eh-specs -d 'Don’t generate code to check for violation of exception specifications at runtime'
-complete -c gcc -o ffor-scope -d 'If -ffor-scope is specified, the scope of variables declared in a for-init-statement is limited to the for loop itself, as specified by the C++ standard'
-complete -c gcc -o fno-for-scope -d 'If -ffor-scope is specified, the scope of variables declared in a for-init-statement is limited to the for loop itself, as specified by the C++ standard'
-complete -c gcc -o fno-gnu-keywords -d 'Do not recognize "typeof" as a keyword, so that code can use this word as an identifier'
-complete -c gcc -o fno-implicit-templates -d 'Never emit code for non-inline templates which are instantiated implicitly (i'
+complete -c gcc -o ffor-scope -d 'Limit scope of variables declared in a for-init-statement to the for loop itself, as specified by the C++ standard'
+complete -c gcc -o fno-for-scope -d "Don't limit scope of vars declared in for loop to the for loop"
+complete -c gcc -o fno-gnu-keywords -d 'Do not recognize "typeof" as a keyword, so code can use it as an identifier'
+complete -c gcc -o fno-implicit-templates -d 'Never emit code for non-inline templates which are instantiated implicitly'
 complete -c gcc -o fno-implicit-inline-templates -d 'Don’t emit code for implicit instantiations of inline templates, either'
-complete -c gcc -o fno-implement-inlines -d 'To save space, do not emit out-of-line copies of inline functions controlled by #pragma implementation'
-complete -c gcc -o fms-extensions -d 'Disable pedantic warnings about constructs used in MFC, such as implicit int and getting a pointer to member function via non-standard syntax'
+complete -c gcc -o fno-implement-inlines -d 'Do not emit out-of-line copies of inline functions controlled by #pragma implementation'
+complete -c gcc -o fms-extensions -d 'Disable pedantic warnings about constructs used in MFC'
 complete -c gcc -o fno-nonansi-builtins -d 'Disable built-in declarations of functions that are not mandated by ANSI/ISO C'
 complete -c gcc -o fno-operator-names -d 'Do not treat the operator name keywords "and", "bitand", "bitor", "compl", "not", "or" and "xor" as synonyms as keywords'
 complete -c gcc -o fno-optional-diags -d 'Disable diagnostics that the standard says a compiler does not need to issue'
 complete -c gcc -o fpermissive -d 'Downgrade some diagnostics about nonconformant code from errors to warnings'
 complete -c gcc -o frepo -d 'Enable automatic template instantiation at link time'
-complete -c gcc -o fno-rtti -d 'Disable generation of information about every class with virtual functions for use by the C++ runtime type identification features (dynamic_cast and typeid)'
+complete -c gcc -o fno-rtti -d 'Disable generation of information about classes with virtual functions for use by dynamic_cast and typeid'
 complete -c gcc -o fstats -d 'Emit statistics about front-end processing at the end of the compilation'
 complete -c gcc -o fno-threadsafe-statics -d 'Do not emit the extra code to use the routines specified in the C++ ABI for thread-safe initialization of local statics'
 complete -c gcc -o fuse-cxa-atexit -d 'Register destructors for objects with static storage duration with the "__cxa_atexit" function rather than the "atexit" function'
-complete -c gcc -o fvisibility-inlines-hidden -d 'Causes all inlined methods to be marked with "__attribute__ ((visibility ("hidden")))" so that they do not appear in the export table of a DSO and do not require a PLT indirection when used within the DSO'
-complete -c gcc -o fno-weak -d 'Do not use weak symbol support, even if it is provided by the linker'
-complete -c gcc -o nostdinc++ -d 'Do not search for header files in the standard directories specific to C++, but do still search the other standard directories'
+complete -c gcc -o fvisibility-inlines-hidden -d 'Mark inlined methods with "__attribute__ ((visibility ("hidden")))"'
+complete -c gcc -o fno-weak -d 'Do not use weak symbol support'
+complete -c gcc -o nostdinc++ -d 'Do not search for header files in the standard directories specific to C++'
 complete -c gcc -o fno-default-inline -d 'Do not assume inline for functions defined inside a class scope'
-complete -c gcc -o Wabi -d '(C++ only) Warn when G++ generates code that is probably not compatible with the vendor-neutral C++ ABI'
-complete -c gcc -o Wctor-dtor-privacy -d '(C++ only) Warn when a class seems unusable because all the constructors or destructors in that class are private, and it has neither friends nor public static member functions'
-complete -c gcc -o Wnon-virtual-dtor -d '(C++ only) Warn when a class appears to be polymorphic, thereby requiring a virtual destructor, yet it declares a non-virtual one'
-complete -c gcc -o Wreorder -d '(C++ only) Warn when the order of member initializers given in the code does not match the order in which they must be executed'
-complete -c gcc -o Weffc++ -d '(C++ only) Warn about violations of the following style guidelines from Scott Meyers’ Effective C++ book: * Item 11: Define a copy constructor and an assignment operator for classes with dynamically allocated memory'
+complete -c gcc -o Wabi -d 'Warn when code is probably incompatible with the vendor-neutral C++ ABI'
+complete -c gcc -o Wctor-dtor-privacy -d 'Warn when a class has no usable con/destructors'
+complete -c gcc -o Wnon-virtual-dtor -d 'Warn when a class requires a virtual destructor but declares a non-virtual one'
+complete -c gcc -o Wreorder -d 'Warn when the order of member initializers does not match the order in which they must be executed'
+complete -c gcc -o Weffc++ -d 'Warn about violations of style guidelines from Scott Meyers’ Effective C++ book'
 complete -c gcc -o Wno-deprecated -d '(C++ only) Do not warn about usage of deprecated features'
 complete -c gcc -o Wstrict-null-sentinel -d '(C++ only) Warn also about the use of an uncasted "NULL" as sentinel'
 complete -c gcc -o Wno-non-template-friend -d '(C++ only) Disable warnings when non-templatized friend functions are declared within a template'
-complete -c gcc -o Wold-style-cast -d '(C++ only) Warn if an old-style (C-style) cast to a non-void type is used within a C++ program'
+complete -c gcc -o Wold-style-cast -d 'Warn if an C-style cast to a non-void type is used in a C++ program'
 complete -c gcc -o Woverloaded-virtual -d '(C++ only) Warn when a function declaration hides virtual functions from a base class'
 complete -c gcc -o Wno-pmf-conversions -d '(C++ only) Disable the diagnostic for converting a bound pointer to member function to a plain pointer'
-complete -c gcc -o Wsign-promo -d '(C++ only) Warn when overload resolution chooses a promotion from unsigned or enumerated type to a signed type, over a conversion to an unsigned type of the same size'
+complete -c gcc -o Wsign-promo -d '(C++ only) Warn when overload resolution promotes from unsigned or enumerated type to a signed type'
 complete -c gcc -o fconstant-string-class -d 'Use class-name as the name of the class to instantiate for each literal string specified with the syntax "@"'
 complete -c gcc -o name -d 'Use class-name as the name of the class to instantiate for each literal string specified with the syntax "@"'
 complete -c gcc -o fgnu-runtime -d 'Generate object code compatible with the standard GNU Objective-C runtime'
@@ -1424,5 +1423,5 @@ complete -c gcc -o fargument-noalias -d 'Specify the possible relationships amon
 complete -c gcc -o fargument-noalias-global -d 'Specify the possible relationships among parameters and between parameters and global data'
 complete -c gcc -o fleading-underscore -d 'This option and its counterpart, -fno-leading-underscore, forcibly change the way C symbols are represented in the object file'
 complete -c gcc -o ftls-model -d '=model Alter the thread-local storage model to be used'
-complete -c gcc -o fvisibility -d '=default│internal│hidden│protected Set the default ELF image symbol visibility to the specified option---all symbols will be marked with this unless overridden within the code'
+complete -c gcc -o fvisibility -a 'default internal hidden protected' -d 'Set the default ELF image symbol visibility'
 complete -c gcc -o fopenmp -d 'Enable handling of OpenMP directives "#pragma omp" in C/C++ and "!$omp" in Fortran'