Explain what an absent module means.

diff --git a/ChangeLog b/ChangeLog
index e25f887f992180e81673aad8a67e1e51c0fc1a85..398d23b91118ed8d60737c5b83bee13698ead497 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+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.

diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index ebd1e5b7fcdace9be5ecdc661f4392b5bac65dde..571904f2860e943e8be15a2e9471429b5d2595f9 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::