Mercurial > gnulib
changeset 37522:a7711dac866e
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 | 047d9cf411ce |
| children | 56dd7355cbf4 |
| files | ChangeLog doc/posix-headers/libgen.texi |
| diffstat | 2 files changed, 8 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- a/ChangeLog Sun Dec 21 07:03:14 2014 -0800 +++ b/ChangeLog Mon Dec 22 11:46:41 2014 -0700 @@ -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 Sun Dec 21 07:03:14 2014 -0800 +++ b/doc/posix-headers/libgen.texi Mon Dec 22 11:46:41 2014 -0700 @@ -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.