From 453d5a43c05070f5e465ec168dea0a4ee6f2d4a3 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Tue, 10 Jan 2012 20:53:57 +0100 Subject: [PATCH] doc: Mention --with-tests option. * gnulib-tool (func_usage): Suggest --with-tests for --test etc. * doc/gnulib.texi (Extra tests modules): Mention the need to pass --with-tests. Reported by Reuben Thomas. --- ChangeLog | 8 ++++++++ doc/gnulib.texi | 10 +++++----- gnulib-tool | 4 ++++ 3 files changed, 17 insertions(+), 5 deletions(-) diff --git a/ChangeLog b/ChangeLog index 212aeaf15..175916729 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2012-01-10 Bruno Haible + + doc: Mention --with-tests option. + * gnulib-tool (func_usage): Suggest --with-tests for --test etc. + * doc/gnulib.texi (Extra tests modules): Mention the need to pass + --with-tests. + Reported by Reuben Thomas. + 2012-01-10 Reuben Thomas users.txt: order package names lexicographically. diff --git a/doc/gnulib.texi b/doc/gnulib.texi index 836320249..1ab056f35 100644 --- a/doc/gnulib.texi +++ b/doc/gnulib.texi @@ -825,17 +825,17 @@ there is no workaround about it. Such a test is better avoided in a release that is made for the general public. @end table -@code{gnulib-tool --import} will not include tests marked with these -attributes by default. When @code{gnulib-tool} is invoked with one +@code{gnulib-tool --import --with-tests} will not include tests marked with +these attributes by default. When @code{gnulib-tool} is invoked with one of the options @code{--with-c++-tests}, @code{--with-longrunning-tests}, @code{--with-privileged-tests}, @code{--with-unportable-tests}, it will include tests despite the corresponding special status attribute. When @code{gnulib-tool} receives the option @code{--with-all-tests}, it will include all tests regardless of their status attributes. -@code{gnulib-tool --create-testdir} and -@code{gnulib-tool --create-megatestdir} by default include all tests of -modules specified on the command line, regardless of their status +@code{gnulib-tool --create-testdir --with-tests} and +@code{gnulib-tool --create-megatestdir --with-tests} by default include all +tests of modules specified on the command line, regardless of their status attributes. Tests of modules occurring as dependencies are not included by default if they have one of these status attributes. The options @code{--with-c++-tests}, @code{--with-longrunning-tests}, diff --git a/gnulib-tool b/gnulib-tool index da3aa4d03..de8f6fea7 100755 --- a/gnulib-tool +++ b/gnulib-tool @@ -164,11 +164,15 @@ Operation modes: --update update the current package, restore files omitted from version control --create-testdir create a scratch package with the given modules + (pass --with-tests to include the unit tests) --create-megatestdir create a mega scratch package with the given modules one by one and all together + (pass --with-tests to include the unit tests) --test test the combination of the given modules + (pass --with-tests to include the unit tests) (recommended to use CC=\"gcc -Wall\" here) --megatest test the given modules one by one and all together + (pass --with-tests to include the unit tests) (recommended to use CC=\"gcc -Wall\" here) --extract-description extract the description --extract-comment extract the comment -- 2.11.0