From 1ee581ea32f8d1afb17f58ff14cb5064a3b62408 Mon Sep 17 00:00:00 2001
From: Bruno Haible <bruno@clisp.org>
Date: Fri, 5 Oct 2007 02:02:30 +0200
Subject: [PATCH] Explain what an absent module means.

---
 ChangeLog       | 6 ++++++
 doc/gnulib.texi | 9 +++++++++
 2 files changed, 15 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index e25f887f99..398d23b911 100644
--- 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 ebd1e5b7fc..571904f286 100644
--- 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::
-- 
2.30.2