Yesterday's patches added more than 50 new deprecated modules. Of course,
we don't plan to document deprecated modules; therefore it makes no sense
to list them in the "Undocumented modules" index. This patch implemnts that.


2024-12-28  Bruno Haible  <br...@clisp.org>

        doc: Omit deprecated modules from the "Undocumented modules" index.
        * doc/Makefile (undocumented-modules.texi): Filter out the deprecated
        modules.

diff --git a/doc/Makefile b/doc/Makefile
index 5f5307a9fc..343419f44a 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -24,8 +24,11 @@ tex_opts = -I ../build-aux
 undocumented-modules.texi: force
        grep -h '^@mindex ' `find . -name '*.texi'` | sed -e 's/@mindex //' | 
LC_ALL=C sort -u > documented-modules.tmp
        (cd .. && ./gnulib-tool --list) | LC_ALL=C sort -u > all-modules.tmp
-       LC_ALL=C join -v1 all-modules.tmp documented-modules.tmp | sed -e 
's/^/@umindex /' > undocumented-modules.texi
-       rm -f documented-modules.tmp all-modules.tmp
+       LC_ALL=C join -v1 all-modules.tmp documented-modules.tmp > 
undocumented-modules.tmp
+# For testing whether a module is deprecated, "./gnulib-tool --extract-status 
<module>" is a bit slow, so use grep instead.
+       modules=`cat undocumented-modules.tmp`; (cd ../modules && grep -l 
'^deprecated$$' $$modules) > deprecated-undocumented-modules.tmp
+       LC_ALL=C join -v1 undocumented-modules.tmp 
deprecated-undocumented-modules.tmp | sed -e 's/^/@umindex /' > 
undocumented-modules.texi
+       rm -f documented-modules.tmp all-modules.tmp undocumented-modules.tmp 
deprecated-undocumented-modules.tmp
 
 %.info: %.texi undocumented-modules.texi
        $(MAKEINFO) $(manual_opts) $<




Reply via email to