summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPeter Rosin <peda@lysator.liu.se>2011-10-21 00:24:38 +0200
committerPeter Rosin <peda@lysator.liu.se>2011-10-21 00:24:38 +0200
commitcc2202a6b0d5a7dc2f8af17e4ac2fdd3fe46d267 (patch)
tree0be49174b44e7b56d7986ae62f0693f6ba1c4536 /doc
parentc7a6a92ea100e3c78c7f48bd6a672da3ad46fc7f (diff)
downloadautomake-cc2202a6b0d5a7dc2f8af17e4ac2fdd3fe46d267.tar.gz
warnings: new 'extra-portability' category, for AM_PROG_AR
* lib/Automake/ChannelDefs.pm: Register new extra-portability warning channel. (switch_warning): Turn off extra-portability if portability is turned off, and turn on portability if extra-portability is turned on. (set_strictness): Silence extra-portability for --gnits, --gnu and --foreign. * tests/extra-portability2.test: New test, checking that the extra-portability channel is silenced by --gnits, --gnu and --foreign. * doc/automake.texi (Invoking Automake): Document the new warning category and its interaction with the portability category. * tests/extra-portability.test: New test, checking the interaction between the portability and extra-portability warning categories. * automake.in (handle_libraries, handle_ltlibraries): Move the AM_PROG_AR warnings to the new extra-portability channel. * tests/ar2.test: Adjust to the new warning channel. * tests/pr300-lib.test: Likewise. * tests/pr300-ltlib.test: Likewise. * tests/pr307.test: Likewise. * tests/pr401.test: Likewise. * tests/pr401b.test: Likewise. * tests/pr401c.test: Likewise. * tests/pr72.test: Likewise. * NEWS: Likewise. * tests/Makefile.am (TESTS): Update. Signed-off-by: Peter Rosin <peda@lysator.liu.se>
Diffstat (limited to 'doc')
-rw-r--r--doc/automake.texi13
1 files changed, 11 insertions, 2 deletions
diff --git a/doc/automake.texi b/doc/automake.texi
index c789e7433..25b1d4d10 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -2680,6 +2680,9 @@ user redefinitions of Automake rules or variables
@item portability
portability issues (e.g., use of @command{make} features that are
known to be not portable)
+@item extra-portability
+extra portability issues related to obscure tools. One example of such
+a tool is the Microsoft @command{lib} archiver.
@item syntax
weird syntax, unused variables, typos
@item unsupported
@@ -2702,6 +2705,12 @@ are enabled in @option{--gnu} and @option{--gnits} strictness.
On the other hand, the @option{silent-rules} options (@pxref{Options})
turns off portability warnings about recursive variable expansions.
+@c Checked by extra-portability.test
+Turning off @samp{portability} will also turn off @samp{extra-portability},
+and similarly turning on @samp{extra-portability} will also turn on
+@samp{portability}. However, turning on @samp{portability} or turning
+off @samp{extra-portability} will not affect the other category.
+
@vindex WARNINGS
The environment variable @env{WARNINGS} can contain a comma separated
list of categories to enable. It will be taken into account before the
@@ -3949,8 +3958,8 @@ you have an @command{emacs} that supports Emacs Lisp).
@acindex AM_PROG_AR
@vindex AR
You must use this macro when you use the archiver in your project, if
-you want support for unusual archivers such as Microsoft lib. The
-content of the optional argument is executed if the archiver
+you want support for unusual archivers such as Microsoft @command{lib}.
+The content of the optional argument is executed if the archiver
interface is not recognized; the default action is to abort configure
with an error message.