I just debugged a failure in sharutils-4.14.2-1 for using basename()
without including <libgen.h>. In the process, I realized that we
aren't doing a good job of explaining why we don't offer a libgen.h
replacement (it is useless because the only two functions it rovides
are also useless).
* doc/posix-headers/libgen.texi (libgen.h): Refer to dirname module.
Signed-off-by: Eric Blake <ebl...@redhat.com>
---
I'm pushing this.
ChangeLog | 5 +++++
doc/posix-headers/libgen.texi | 3 +++
2 files changed, 8 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index 3cf10e5..75708b9 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2014-12-22 Eric Blake <ebl...@redhat.com>
+
+ docs: mention why libgen.h is bad
+ * doc/posix-headers/libgen.texi (libgen.h): Refer to dirname module.
+
2014-12-20 Paul Eggert <egg...@cs.ucla.edu>
assure: new module
diff --git a/doc/posix-headers/libgen.texi b/doc/posix-headers/libgen.texi
index 7667cbb..40d7039 100644
--- a/doc/posix-headers/libgen.texi
+++ b/doc/posix-headers/libgen.texi
@@ -15,3 +15,6 @@ libgen.h
This header file is missing on some platforms:
mingw, MSVC 9, BeOS.
@end itemize
+
+The Gnulib module @code{dirname} provides similar API, with functions
+@code{base_name} and @code{dir_name} that also work with Windows file names.
--
2.1.0
