Mon 25 Apr 2016 06:03:18 PM UTC, original submission:
In the troff man page, the meaning of "all" is clearly described as not, in fact, inclusive of all warnings, but rather most warnings. This definition is given in the WARNINGS section, after the table of warnings.
However, there is a forward reference to "all" in the description of the -w option, where it is stated that "[F]or example, to enable all warnings, use -w all." This is giving the reader an incorrect implicit definition of what "all" means.
Someone looking for the warning option might see this first, then then scroll down to the table of warnings, and then assume that all those warnings are what "all warnings" refers to.
But, alas, some important errors such as undefined macros are not diagnosed by -w all, because "all" excludes "mac".
A suggested text might be. "To enable most warnings use -wwall. Absolutely all warnings are enabled with -ww."
|