[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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH] docs: mention why libgen.h is bad,
Eric Blake <=