summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorEric Blake <eblake@redhat.com>2014-12-22 11:46:41 -0700
committerEric Blake <eblake@redhat.com>2014-12-22 11:50:37 -0700
commit16518d9ed8f25d3e53931dd1aa343072933e4604 (patch)
tree8a712e4edca030f6749a50159e30fd3bcdc272b0 /doc
parent8d55a7b7a27076ecba2058d9c25b7122675582a3 (diff)
downloadgnulib-16518d9ed8f25d3e53931dd1aa343072933e4604.tar.gz
docs: mention why libgen.h is bad
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 provides are also useless). * doc/posix-headers/libgen.texi (libgen.h): Refer to dirname module. Signed-off-by: Eric Blake <eblake@redhat.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/posix-headers/libgen.texi3
1 files changed, 3 insertions, 0 deletions
diff --git a/doc/posix-headers/libgen.texi b/doc/posix-headers/libgen.texi
index 7667cbbe90..40d70391ec 100644
--- a/doc/posix-headers/libgen.texi
+++ b/doc/posix-headers/libgen.texi
@@ -15,3 +15,6 @@ Portability problems not fixed by Gnulib:
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.