Explain what an absent module means.

diff --git a/ChangeLog b/ChangeLog
index e25f887..398d23b 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2007-10-04  Bruno Haible  <bruno@clisp.org>
 
+       * doc/gnulib.texi (Function Substitutes): Explain what an absent module
+       means.
+       Reported by Benoît Sigoure <tsuna@lrde.epita.fr>.
+
+2007-10-04  Bruno Haible  <bruno@clisp.org>
+
        * modules/truncl-tests: New file.
        * tests/test-truncl.c: New file.
 

diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index ebd1e5b..571904f 100644 (file)
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -635,6 +635,15 @@ ISO C or POSIX are substituted by Gnulib, which portability pitfalls are
 fixed by Gnulib, and which (known) portability problems are not worked around
 by Gnulib.
 
+The notation ``Gnulib module: ---'' means that Gnulib does not provide a
+module providing a substitute for the function.  When the list
+``Portability problems not fixed by Gnulib'' is empty, such a module is
+not needed: No portability problems are known.  Otherwise, it indicates
+that such a module would be useful but is not available: Noone so far
+found this function important enough to contribute a substitute for it.
+If you need this particular function, you may write to
+@code{<bug-gnulib at gnu dot org>}.
+
 @menu
 * FD_CLR::
 * FD_ISSET::