On Sun, Sep 21, 2014 at 04:43:07PM +0200, Werner LEMBERG wrote:
>
> The functions `base_name' and `dir_name' (or rather `mdir_name'),
> intended as replacements for `basename' and `dirname' that work on
> Windows also, are not documented in `gnulib.pdf'. I suggest to
> mention those two function names at least in `modules/dirname'.
I applied the following. I hope that it helps.
--8<--------------------------cut here-------------------------->8--
From: Ben Pfaff <b...@cs.stanford.edu>
Date: Sun, 28 Sep 2014 09:52:08 -0700
Subject: [PATCH] basename, dirname: Improve documentation.
* doc/posix-functions/basename.texi: Mention dirname module and
base_name() function.
* doc/posix-functions/dirname.texi: Mention dir_name() and
mdir_name() functions.
Suggested by Werner LEMBERG <w...@gnu.org>.
---
ChangeLog | 9 +++++++++
doc/posix-functions/basename.texi | 3 +++
doc/posix-functions/dirname.texi | 5 +++--
3 files changed, 15 insertions(+), 2 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 876174f..0bf83d4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2014-09-28 Ben Pfaff <b...@cs.stanford.edu>
+
+ basename, dirname: Improve documentation.
+ * doc/posix-functions/basename.texi: Mention dirname module and
+ base_name() function.
+ * doc/posix-functions/dirname.texi: Mention dir_name() and
+ mdir_name() functions.
+ Suggested by Werner LEMBERG <w...@gnu.org>.
+
2014-09-24 Jim Meyering <meyer...@fb.com>
exclude: declare exclude_patopts static
diff --git a/doc/posix-functions/basename.texi
b/doc/posix-functions/basename.texi
index 699f28e..bb068f4 100644
--- a/doc/posix-functions/basename.texi
+++ b/doc/posix-functions/basename.texi
@@ -22,3 +22,6 @@ the GNU version.
@code{basename} assumes file names in POSIX syntax; it does not work with file
names in Windows syntax.
@end itemize
+
+The Gnulib module @code{dirname} provides similar API, with function
+@code{base_name}, that also works with Windows file names.
diff --git a/doc/posix-functions/dirname.texi b/doc/posix-functions/dirname.texi
index 026f404..dd86e58 100644
--- a/doc/posix-functions/dirname.texi
+++ b/doc/posix-functions/dirname.texi
@@ -20,5 +20,6 @@ IRIX 6.5, Solaris 2.5.1, mingw, MSVC 9, BeOS.
names in Windows syntax.
@end itemize
-The Gnulib module @code{dirname} provides similar API that also works with
-Windows file names.
+The Gnulib module @code{dirname} provides similar API, with functions
+@code{dir_name} and @{code{mdir_name}, that also works with Windows
+file names.
--
2.1.0
