changeset 17842:cd98ec88aefc

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>
author Eric Blake <eblake@redhat.com>
date Mon, 22 Dec 2014 11:46:41 -0700
parents b7c471ffe9a3
children 23358c3412ba
files ChangeLog doc/posix-headers/libgen.texi
diffstat 2 files changed, 8 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2014-12-22  Eric Blake  <eblake@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  <eggert@cs.ucla.edu>
 
 	assure: new module
--- a/doc/posix-headers/libgen.texi
+++ b/doc/posix-headers/libgen.texi
@@ -15,3 +15,6 @@
 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.