completions/gcc: Moar descriptions

share/completions/gcc.fish

@@ -126,21 +126,21 @@ complete -c gcc -o line -d 'Only meaningful in line-wrapping mode'
 complete -c gcc -o fdiagnostics-show-options -d 'This option instructs the diagnostic machinery to add text to each diagnostic emitted, which indicates which command line option directly controls that diagnostic, when such an option is known to the diagnostic machinery'
 complete -c gcc -o Wno- -d 'to turn off warnings; for example, -Wno-implicit'
 complete -c gcc -o fsyntax-only -d 'Check the code for syntax errors, but don’t do anything beyond that'
-complete -c gcc -o pedantic -d 'Issue all the warnings demanded by strict ISO C and ISO C++; reject all programs that use forbidden extensions, and some other programs that do not follow ISO C and ISO C++'
+complete -c gcc -o pedantic -d 'Issue all the warnings demanded by strict ISO C and ISO C++; reject all programs that use forbidden extensions'
 complete -c gcc -o pedantic-errors -d 'Like -pedantic, except that errors are produced rather than warnings'
 complete -c gcc -s w -d 'Inhibit all warning messages'
 complete -c gcc -o Wno-import -d 'Inhibit warning messages about the use of #import'
 complete -c gcc -o Wchar-subscripts -d 'Warn if an array subscript has type "char"'
-complete -c gcc -o Wcomment -d 'Warn whenever a comment-start sequence /* appears in a /* comment, or whenever a Backslash-Newline appears in a // comment'
-complete -c gcc -o Wfatal-errors -d 'This option causes the compiler to abort compilation on the first error occurred rather than trying to keep going and printing further error messages'
+complete -c gcc -o Wcomment -d 'Warn whenever a comment-start sequence appears in a comment'
+complete -c gcc -o Wfatal-errors -d 'Abort compilation on the first error'
 complete -c gcc -o Wformat -d 'Check calls to "printf" and "scanf", etc'
-complete -c gcc -o Wformat-y2k -d 'If -Wformat is specified, also warn about "strftime" formats which may yield only a two-digit year'
-complete -c gcc -o Wno-format-extra-args -d 'If -Wformat is specified, do not warn about excess arguments to a "printf" or "scanf" format function'
-complete -c gcc -o Wno-format-zero-length -d 'If -Wformat is specified, do not warn about zero-length formats'
-complete -c gcc -o Wformat-nonliteral -d 'If -Wformat is specified, also warn if the format string is not a string literal and so cannot be checked, unless the format function takes its format arguments as a "va_list"'
-complete -c gcc -o Wformat-security -d 'If -Wformat is specified, also warn about uses of format functions that represent possible security problems'
-complete -c gcc -o Wnonnull -d 'Warn about passing a null pointer for arguments marked as requiring a non-null value by the "nonnull" function attribute'
-complete -c gcc -o Winit-self -d '(C, C++, Objective-C and Objective-C++ only) Warn about uninitialized variables which are initialized with themselves'
+complete -c gcc -o Wformat-y2k -d 'With -Wformat, also warn about "strftime" formats which may yield only a two-digit year'
+complete -c gcc -o Wno-format-extra-args -d 'With -Wformat, do not warn about excess arguments to "printf" or "scanf"'
+complete -c gcc -o Wno-format-zero-length -d 'With -Wformat, do not warn about zero-length formats'
+complete -c gcc -o Wformat-nonliteral -d 'With -Wformat, also warn if the format string is not a string literal'
+complete -c gcc -o Wformat-security -d 'With -Wformat, also warn about uses of potentially insecure format functions'
+complete -c gcc -o Wnonnull -d 'Warn about passing a null pointer for arguments marked as requiring non-null'
+complete -c gcc -o Winit-self -d 'Warn about uninitialized variables which are initialized with themselves'
 complete -c gcc -o Wimplicit-int -d 'Warn when a declaration does not specify a type'
 complete -c gcc -o Wimplicit-function-declaration -d 'Give a warning (or error) whenever a function is used before being declared'
 complete -c gcc -o Werror-implicit-function-declaration -d 'Give a warning (or error) whenever a function is used before being declared'
@@ -148,25 +148,24 @@ complete -c gcc -o Wimplicit -d 'Same as -Wimplicit-int and -Wimplicit-function-
 complete -c gcc -o Wmain -d 'Warn if the type of main is suspicious'
 complete -c gcc -o Wmissing-braces -d 'Warn if an aggregate or union initializer is not fully bracketed'
 complete -c gcc -o Wmissing-include-dirs -d '(C, C++, Objective-C and Objective-C++ only) Warn if a user-supplied include directory does not exist'
-complete -c gcc -o Wparentheses -d 'Warn if parentheses are omitted in certain contexts, such as when there is an assignment in a context where a truth value is expected, or when operators are nested whose precedence people often get confused about'
-complete -c gcc -o Wsequence-point -d 'Warn about code that may have undefined semantics because of violations of sequence point rules in the C standard'
+complete -c gcc -o Wparentheses -d 'Warn if parentheses are omitted where confusing'
+complete -c gcc -o Wsequence-point -d 'Warn about undefined semantics because of violations of sequence point rules in the C standard'
 complete -c gcc -o Wreturn-type -d 'Warn whenever a function is defined with a return-type that defaults to "int"'
-complete -c gcc -o Wswitch -d 'Warn whenever a "switch" statement has an index of enumerated type and lacks a "case" for one or more of the named codes of that enumeration'
+complete -c gcc -o Wswitch -o Wswitch-enum -d 'Warn whenever a "switch" statement lacks a "case" for a member of an enum'
 complete -c gcc -o Wswitch-default -d 'Warn whenever a "switch" statement does not have a "default" case'
-complete -c gcc -o Wswitch-enum -d 'Warn whenever a "switch" statement has an index of enumerated type and lacks a "case" for one or more of the named codes of that enumeration'
 complete -c gcc -o Wtrigraphs -d 'Warn if any trigraphs are encountered that might change the meaning of the program (trigraphs within comments are not warned about)'
-complete -c gcc -o Wunused-function -d 'Warn whenever a static function is declared but not defined or a non-inline static function is unused'
-complete -c gcc -o Wunused-label -d 'Warn whenever a label is declared but not used'
-complete -c gcc -o Wunused-parameter -d 'Warn whenever a function parameter is unused aside from its declaration'
-complete -c gcc -o Wunused-variable -d 'Warn whenever a local variable or non-constant static variable is unused aside from its declaration'
+complete -c gcc -o Wunused-function -d 'Warn about unused functions'
+complete -c gcc -o Wunused-label -d 'Warn about unused labels'
+complete -c gcc -o Wunused-parameter -d 'Warn about unused function parameters'
+complete -c gcc -o Wunused-variable -d 'Warn about unused variables'
 complete -c gcc -o Wunused-value -d 'Warn whenever a statement computes a result that is explicitly not used'
-complete -c gcc -o Wunused -d 'All the above -Wunused options combined'
-complete -c gcc -o Wuninitialized -d 'Warn if an automatic variable is used without first being initialized or if a variable may be clobbered by a "setjmp" call'
-complete -c gcc -o Wunknown-pragmas -d 'Warn when a #pragma directive is encountered which is not understood by GCC'
-complete -c gcc -o Wno-pragmas -d 'Do not warn about misuses of pragmas, such as incorrect parameters, invalid syntax, or conflicts between pragmas'
-complete -c gcc -o Wstrict-aliasing -d 'This option is only active when -fstrict-aliasing is active' -a 2
+complete -c gcc -o Wunused -d 'All the -Wunused options combined'
+complete -c gcc -o Wuninitialized -d 'Warn if an automatic variable is used without being initialized'
+complete -c gcc -o Wunknown-pragmas -d 'Warn when an unknown #pragma directive is encountered'
+complete -c gcc -o Wno-pragmas -d 'Do not warn about misuses of pragmas'
+complete -c gcc -o Wstrict-aliasing -d 'Warn about strict aliasing rules' -a 2
 complete -c gcc -o Wall -d 'All of the above -W options combined'
-complete -c gcc -o Wextra -d '(This option used to be called -W'
+complete -c gcc -o Wextra -d 'Enable warnings not enabled by -Wall'
 complete -c gcc -o Wno-div-by-zero -d 'Do not warn about compile-time integer division by zero'
 complete -c gcc -o Wsystem-headers -d 'Print warning messages for constructs found in system header files'
 complete -c gcc -o Wfloat-equal -d 'Warn if floating point values are used in equality comparisons'
@@ -174,7 +173,7 @@ complete -c gcc -o Wtraditional -d '(C only) Warn about certain constructs that
 complete -c gcc -o Wdeclaration-after-statement -d '(C only) Warn when a declaration is found after a statement in a block'
 complete -c gcc -o Wundef -d 'Warn if an undefined identifier is evaluated in an #if directive'
 complete -c gcc -o Wno-endif-labels -d 'Do not warn whenever an #else or an #endif are followed by text'
-complete -c gcc -o Wshadow -d 'Warn whenever a local variable shadows another local variable, parameter or global variable or whenever a built-in function is shadowed'
+complete -c gcc -o Wshadow -d 'Warn if a local variable shadows another variable or if a built-in function is shadowed'
 complete -c gcc -o Wlarger-than-len -d 'Warn whenever an object of larger than len bytes is defined'
 complete -c gcc -o Wunsafe-loop-optimizations -d 'Warn if the loop cannot be optimized because the compiler could not assume anything on the bounds of the loop indices'
 complete -c gcc -o Wpointer-arith -d 'Warn about anything that depends on the "size of" a function type or of "void"'