sub set_strictness
{
$strictness_name = $_[0];
+
+ # FIXME: 'portability' warnings are currently disabled by default.
+ # Eventually we want to turn them on in GNU and GNITS modes, but
+ # we don't do this yet in Automake 1.7 to help the 1.6/1.7 transition.
+ #
+ # Indeed there would be only two ways to get rid of these new warnings:
+ # 1. adjusting Makefile.am
+ # This is not always easy (or wanted). Consider %-rules or
+ # $(function args) variables.
+ # 2. using -Wno-portability
+ # This means there is no way to have the same Makefile.am
+ # working both with Automake 1.6 and 1.7 (since 1.6 does not
+ # understand -Wno-portability).
+ #
+ # In Automake 1.8 (or whatever it is called) we can turn these
+ # warnings on, since -Wno-portability will not be an issue for
+ # the 1.7/1.8 transition.
if ($strictness_name eq 'gnu')
{
$strictness = GNU;
setup_channel 'error-gnu', silent => 0;
setup_channel 'error-gnu/warn', silent => 0, type => 'error';
setup_channel 'error-gnits', silent => 1;
- setup_channel 'portability', silent => 0;
+ # setup_channel 'portability', silent => 0;
setup_channel 'gnu', silent => 0;
}
elsif ($strictness_name eq 'gnits')
setup_channel 'error-gnu', silent => 0;
setup_channel 'error-gnu/warn', silent => 0, type => 'error';
setup_channel 'error-gnits', silent => 0;
- setup_channel 'portability', silent => 0;
+ # setup_channel 'portability', silent => 0;
setup_channel 'gnu', silent => 0;
}
elsif ($strictness_name eq 'foreign')
setup_channel 'error-gnu', silent => 1;
setup_channel 'error-gnu/warn', silent => 0, type => 'warning';
setup_channel 'error-gnits', silent => 1;
- setup_channel 'portability', silent => 1;
+ # setup_channel 'portability', silent => 1;
setup_channel 'gnu', silent => 1;
}
else
`obsolete' obsolete features or constructions
`unsupported' unsupported or incomplete features (default)
`unused' unused variables (default)
- `portability' portability issues (default in gnu and gnits modes)
+ `portability' portability issues
`all' all the warnings
`no-CATEGORY' turn off warnings in CATEGORY
`none' turn off all the warnings
@item unused
unused variables
@item portability
-portability issues
+portability issues (e.g., use of Make features which are known not portable)
@item all
all the warnings
@item none
variables.
The categories output by default are @samp{unsupported} and
-@samp{unused}. Additionally, @samp{gnu} and @samp{portability} warnings
-are enabled in @samp{--gnu} and @samp{--gnits} strictness.
+@samp{unused}. Additionally, @samp{gnu} is enabled in @samp{--gnu} and
+@samp{--gnits} strictness.
+
+@samp{portability} warnings are currently disabled by default, but they
+will be enabled in @samp{--gnu} and @samp{--gnits} strictness in a
+future release.
@vindex WARNINGS
The environment variable @samp{WARNINGS} can contain a comma separated