Hi Collin,
> I've added a small mention in the documentation to make it official.
Thanks. Now that I think more about it, I forgot to update gnulib-tool.sh.
gnulib-tool.sh does not need to support the new feature, but it should
at least not malfunction just because a module description contains this
new section marker.
2024-07-28 Bruno Haible <br...@clisp.org>
More updates regarding the 'Useable-in-testdir' sections.
* gnulib-tool.sh (sed_extract_prog, sed_extract_field_header): Recognize
the 'Useable-in-testdir' sections.
* modules/TEMPLATE-EXTENDED: Add a 'Useable-in-testdir' section.
* doc/gnulib.texi (Module description): Move new text.
diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 3f2d1ee44d..33e82f2907 100644
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -411,10 +411,6 @@
Gnulib's documentation generator will automatically convert the first part
to a hyperlink when it has this form.
-@item Usable-in-testdir
-This field should contain @samp{no} if the module cannot be used in a
-test directory created with @code{gnulib-tool --create-testdir}.
-
@item Status
This field is either empty/absent, or contains the word @samp{obsolete}. In
the latter case, @command{gnulib-tool} will, unless the option
@@ -439,6 +435,10 @@
both @code{Makefile.am}s. This is useful for modules which provide
Makefile.am macros rather than compiled source code.
+@item Usable-in-testdir
+This field should contain @samp{no} if the module cannot be used in a
+test directory created with @code{gnulib-tool --create-testdir}.
+
@item Files
This field contains a newline separated list of the files that are part of
the module. @code{gnulib-tool} copies these files into the package that
diff --git a/gnulib-tool.sh b/gnulib-tool.sh
index 0efc25f0dc..de9e3c4b50 100755
--- a/gnulib-tool.sh
+++ b/gnulib-tool.sh
@@ -1951,6 +1951,7 @@ sed_extract_prog=':[ ]*$/ {
s/^Status:[ ]*$//
s/^Notice:[ ]*$//
s/^Applicability:[ ]*$//
+ s/^Usable-in-testdir:[ ]*$//
s/^Files:[ ]*$//
s/^Depends-on:[ ]*$//
s/^configure\.ac-early:[ ]*$//
@@ -1975,6 +1976,7 @@ sed_extract_field_header='
s/^Status:[ ]*$/status/
s/^Notice:[ ]*$/notice/
s/^Applicability:[ ]*$/applicability/
+ s/^Usable-in-testdir:[ ]*$/usability_in_testdir/
s/^Files:[ ]*$/files/
s/^Depends-on:[ ]*$/dependson/
s/^configure\.ac-early:[ ]*$/configureac_early/
diff --git a/modules/TEMPLATE-EXTENDED b/modules/TEMPLATE-EXTENDED
index c9e9051895..af91e86b96 100644
--- a/modules/TEMPLATE-EXTENDED
+++ b/modules/TEMPLATE-EXTENDED
@@ -8,6 +8,8 @@ Notice:
Applicability:
+Usable-in-testdir:
+
Files:
Depends-on:
