From 16518d9ed8f25d3e53931dd1aa343072933e4604 Mon Sep 17 00:00:00 2001 From: Eric Blake Date: Mon, 22 Dec 2014 11:46:41 -0700 Subject: [PATCH] docs: mention why libgen.h is bad I just debugged a failure in sharutils-4.14.2-1 for using basename() without including . 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 --- ChangeLog | 5 +++++ doc/posix-headers/libgen.texi | 3 +++ 2 files changed, 8 insertions(+) diff --git a/ChangeLog b/ChangeLog index 3cf10e51e3..75708b9396 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2014-12-22 Eric Blake + + docs: mention why libgen.h is bad + * doc/posix-headers/libgen.texi (libgen.h): Refer to dirname module. + 2014-12-20 Paul Eggert assure: new module 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. -- 2.39.5