bug-gnulib
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH] docs: mention why libgen.h is bad


From: Eric Blake
Subject: [PATCH] docs: mention why libgen.h is bad
Date: Mon, 22 Dec 2014 11:49:20 -0700

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 <address@hidden>
---

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  <address@hidden>
+
+       docs: mention why libgen.h is bad
+       * doc/posix-headers/libgen.texi (libgen.h): Refer to dirname module.
+
 2014-12-20  Paul Eggert  <address@hidden>

        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
address@hidden and @code{dir_name} that also work with Windows file names.
-- 
2.1.0




reply via email to

[Prev in Thread] Current Thread [Next in Thread]