mingw-cvs Mailing List for MinGW - Minimalist GNU for Windows

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Repository: mingw-org-wsl".

The branch, legacy has been updated
       via  40713b7cbd4d766a71a78c6b3cdd79a6491cdf96 (commit)
      from  3c94eba695c5ce6233295a22c70e01426004f48e (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
https://sf.net/p/mingw/mingw-org-wsl/ci/40713b7cbd4d766a71a78c6b3cdd79a6491cdf96/

commit 40713b7cbd4d766a71a78c6b3cdd79a6491cdf96
Author: Keith Marshall <kei...@us...>
Date:   Wed Apr 13 21:39:45 2016 +0100

    Generalize procedure for installing manpages.
    
    --HG--
    rename : mingwrt/man/dirname.man => mingwrt/man/dirname.3.man

diff --git a/mingwrt/ChangeLog b/mingwrt/ChangeLog
index eed2c0b..e8ff75b 100644
--- a/mingwrt/ChangeLog
+++ b/mingwrt/ChangeLog
@@ -1,3 +1,21 @@
+2016-04-13  Keith Marshall  <kei...@us...>
+
+	Generalize procedure for installing manpages.
+
+	* man/dirname.man: Rename it as...
+	* man/dirname.3.man: ...this, with inherent MANSECT specification.
+	(TH): Use %PAGEREF% substitution for NAME, MANSECT, and DATE.
+	(MS-Windows): Do not append \[tm]; it doesn't render well in Windows
+	console. Further, correct typos; some syntactic adjustments.
+
+	* Makefile.in (%:%.man): New rule; define it.
+	(%.mancopy, %.mancopy-recursive): New rules; define and use with...
+	(reference_manpage): ...this new macro, defining it to map...
+	(dirname.3.man): ...this as the reference source file for both of...
+	(basename.3, dirname.3): ...these installed manpages.
+	(format_manpage): Add MANSECT and DATE to expansion of...
+	(%PAGEREF%): ...this sed substitution pattern.
+
 2016-04-12  Keith Marshall  <kei...@us...>
 
 	Update several incorrectly attributed header files.
diff --git a/mingwrt/Makefile.in b/mingwrt/Makefile.in
index b754086..9957a56 100644
--- a/mingwrt/Makefile.in
+++ b/mingwrt/Makefile.in
@@ -733,21 +733,31 @@ install-%-dll-files:
 
 # Install manpages.
 #
-install-man install-manpages: install-mingwrt-manpages
-format_manpage = sed "s/%PAGEREF%/`echo $1 | tr a-z A-Z` $2/"
-
 vpath %.man ${mingwrt_srcdir}/man
-basename.$(man3ext) dirname.$(man3ext): %.$(man3ext): dirname.man
-	$(call format_manpage,$*,$(man3ext)) $< > $@
-
-mingwrt-man$(man3ext): basename.$(man3ext) dirname.$(man3ext)
-
+install-man install-manpages: install-mingwrt-manpages
+mingwrt-man$(man3ext): $(addsuffix .$(man3ext),basename dirname)
 install-mingwrt-manpages: mandir mingwrt-man3
+
 mingwrt-man%:
 	$(call mkinstalldirs,,${man$*dir})
 	$(call INSTALL_DATA,$^,${man$*dir})
 	$(RM) $^
 
+%: %.man
+	$(call format_manpage,$(basename $*),$(suffix $*),$<) $< > $@
+
+format_manpage = sed \
+  -e "s/%PAGEREF%/`echo $1 | tr a-z A-Z` $(2:.%=%) `date -r $3 +%d-%b-%Y`/"
+
+basename.$(man3ext): export reference_manpage = dirname.$(man3ext).man
+basename.$(man3ext): %: %.mancopy-recursive
+
+%.mancopy-recursive:
+	$(MAKE) --no-print-directory $*.mancopy
+
+%.mancopy: $(reference_manpage)
+	$(call format_manpage,$(basename $*),$(suffix $*),$<) $< > $*
+
 
 # Undo Installation
 # -----------------
diff --git a/mingwrt/man/dirname.man b/mingwrt/man/dirname.3.man
similarity index 82%
rename from mingwrt/man/dirname.man
rename to mingwrt/man/dirname.3.man
index 82e1a9a..99926e5 100644
--- a/mingwrt/man/dirname.man
+++ b/mingwrt/man/dirname.3.man
@@ -1,9 +1,10 @@
-.\" t
-.TH DIRNAME 3 04-Jan-2007 MinGW "Programmer's Reference Manual"
+'\" t
+.\" vim: ft=nroff
+.TH %PAGEREF% MinGW "Programmer's Reference Manual"
 .
 .SH NAME
 .
-.BR dirname ,\0 basename
+.BR \%dirname ,\0 \%basename
 \- parse path name components
 .
 .
@@ -24,9 +25,9 @@
 .SH DESCRIPTION
 .
 The
-.B dirname
+.BR \%dirname ()
 and
-.B basename
+.BR \%basename ()
 functions parse a null\-terminated path name string,
 and split it into its
 .B directory name
@@ -37,7 +38,7 @@ Splitting is performed on the basis of the location of the
 .B directory separator
 characters,
 which,
-for this MS\-Windows(\(tm) implementation,
+for this MS\-Windows implementation,
 are the characters
 .RB \(dq / \(dq
 and
@@ -52,7 +53,7 @@ is a colon
 .RB (\(dq : \(dq),
 the first two characters of
 .I path
-are interpreted as an MS\-Windows(\(tm) drive designator,
+are interpreted as an MS\-Windows drive designator,
 which will be included in the
 .B directory name
 component of
@@ -63,48 +64,48 @@ component.
 .
 .PP
 In normal usage,
-.B dirname
+.BR \%dirname ()
 returns a pointer to a string representing the path name component of
 .IR path ,
 up to but not including the rightmost directory separator,
 while
-.B basename
+.BR \%basename ()
 returns a pointer to the component following this separator.
 Any trailing directory separators present in
 .I path
 are disregarded,
 when determining the rightmost separator,
 and, in the case of the return value from
-.BR dirname ,
+.BR \%dirname (),
 any internal sequences of recurring separator characters
 are each reduced to a single such character.
 .
 .PP
 If
 .I path
-contains no MS\-Windows(\(tm) drive designator,
+contains no MS\-Windows drive designator,
 and no directory separator character,
 then
-.B dirname
+.BR \%dirname ()
 returns the string
 .RB \(dq . \(dq,
 and
-.B basename
+.BR \%basename ()
 returns a copy of
 .IR path.
 If
 .I path
-does commence with an MS\-Windows(\(tm) drive designator,
+does commence with an MS\-Windows drive designator,
 but contains no directory separators,
 then
-.B dirname
+.BR \%dirname ()
 returns the string
 .RB \(dq d:. \(dq,
 where
 .RB \(dq d: \(dq
 represents the drive designator,
 while
-.B basename
+.BR \%basename ()
 returns a copy of
 .IR path ,
 with its initial two characters,
@@ -117,9 +118,9 @@ If
 is a NULL pointer,
 or is a pointer to an empty string,
 then both
-.B dirname
+.BR \%dirname ()
 and
-.B basename
+.BR \%basename ()
 return the string
 .RB \(dq . \(dq.
 .
@@ -131,9 +132,9 @@ is the string
 or the string
 .RB \(dq \e \(dq,
 both
-.B dirname
+.BR \%dirname ()
 and
-.B basename
+.BR \%basename ()
 return the string
 .RB \(dq / \(dq,
 or the string
@@ -148,15 +149,15 @@ commences with
 two directory separator characters,
 which must be similar,
 then
-.B dirname
+.BR \%dirname ()
 will preserve these two characters in the returned path name.
 This construct does not affect the string returned by
-.BR basename ,
+.BR \%basename (),
 neither is this behaviour replicated by
-.BR dirname ,
+.BR \%dirname (),
 if
 .I path
-includes an MS\-Windows(\(tm) drive designator.
+includes an MS\-Windows drive designator.
 .
 .PP
 In the special case,
@@ -165,13 +166,13 @@ where
 is specified as
 .I exactly
 two identical directory separator characters,
-with no MS\-Windows(\(tm) drive designator,
+with no MS\-Windows drive designator,
 and no following path name,
-.B dirname
+.BR \%dirname ()
 returns
 .I path
 unchanged;
-.B basename
+.BR \%basename ()
 normalises the return string to only a single character,
 either
 .RB \(dq / \(dq
@@ -182,27 +183,27 @@ matching the characters used to specify
 .
 .PP
 Concatenating the string returned by
-.BR dirname ,
+.BR \%dirname (),
 a
 .RB \(dq / \(dq
 or a
 .RB \(dq \e \(dq,
 and the string returned by
-.B basename
+.BR \%basename ()
 yields a complete path name.
 .
 .PP
 The
-.B dirname
+.BR \%dirname ()
 and
-.B basename
+.BR \%basename ()
 functions conform generally to SUSv3,
 extended to accommodate the handling of
 .RB \(dq / \(dq
 and
 .RB \(dq \e \(dq
 as alternative directory separator characters,
-and also to accommodate the likelihood of MS\-Windows(\(tm)
+and also to accommodate the likelihood of MS\-Windows
 drive designators appearing in any path name specification.
 The example,
 which follows,
@@ -213,9 +214,9 @@ and also the effects of the extended behaviour.
 .SH EXAMPLE
 .
 To verify the behaviour of the
-.B dirname
+.BR \%dirname ()
 and
-.B basename
+.BR \%basename ()
 functions,
 the test program defines the following function:\(em
 .
@@ -241,16 +242,16 @@ void result( char *path )
 .RE
 .PP
 This illustrates the correct use of the
-.B dirname
+.BR \%dirname ()
 and the
-.B basename
+.BR \%basename ()
 functions,
 with copies of the original
 .I path
 string being passed in the function calls.
 Note that the return values from each function are used immediately,
 in the
-.B printf
+.BR printf ()
 call,
 and the temporary copies of
 .I path
@@ -260,9 +261,9 @@ before these go out of scope.
 .
 .PP
 Calling this example function illustrates the effect of each of the
-.B dirname
+.BR \%dirname ()
 and
-.B basename
+.BR \%basename ()
 functions,
 for various values of
 .IR path .
@@ -290,7 +291,7 @@ lw(15n) lw(10n) lw(10n).
 .
 .PP
 Similarly,
-for the case where path names are expressed using the MS\-Windows(\(tm)
+for the case where path names are expressed using the MS\-Windows
 .RB \(dq \e \(dq
 directory separator notation,
 calling the example function displays:\(em
@@ -315,7 +316,7 @@ lw(15n) lw(10n) lw(10n).
 .
 .PP
 and,
-when an MS\-Windows(\(tm) drive designator is also specified,
+when an MS\-Windows drive designator is also specified,
 this becomes:\(em
 .RS
 .TS
@@ -344,7 +345,7 @@ the special handling of path names which begin with
 two directory separator characters,
 and also that this special handling is suppressed
 when these two characters are dissimilar,
-or when an MS\-Windows(\(tm) drive designator is specified:\(em
+or when an MS\-Windows drive designator is specified:\(em
 .RS
 .TS
 tab(!);
@@ -369,7 +370,7 @@ lw(15n) lw(10n) lw(10n).
 .SH RETURN VALUE
 .
 The
-.B dirname
+.BR \%dirname ()
 function returns a pointer to a null terminated string,
 which represents the directory path component of the passed
 .I path
@@ -380,7 +381,7 @@ normalised to a single separator at each level of directory nesting.
 .
 .PP
 The
-.B basename
+.BR \%basename ()
 function
 returns a pointer to a null terminated string,
 which represents the rightmost element of the passed
@@ -389,14 +390,14 @@ string,
 with all trailing directory separator characters removed.
 .
 .PP
-If any MS\-Windows(\(tm) drive designator is specified in the input
+If any MS\-Windows drive designator is specified in the input
 .I path
 string,
 it is included in the return value of the
-.B dirname
+.BR \%dirname ()
 function,
 but not in that of the
-.B basename
+.BR \%basename ()
 function.
 .
 .
@@ -408,9 +409,9 @@ None.
 .SH CAVEATS AND BUGS
 .
 The
-.B dirname
+.BR \%dirname ()
 and
-.B basename
+.BR \%basename ()
 functions may modify the
 .I path
 string passed to them.
@@ -425,9 +426,9 @@ Also note that,
 since the
 .I path
 argument may be modified by the
-.B dirname
+.BR \%dirname ()
 or the
-.B basename
+.BR \%basename ()
 function call,
 if you wish to preserve the original content of
 .IR path ,
@@ -437,14 +438,14 @@ either function may return its result in a statically allocated buffer,
 which may be overwritten on a subsequent function call.
 .PP
 Although the
-.B dirname
+.BR \%dirname ()
 and
-.B basename
+.BR \%basename ()
 functions parse path name strings,
 they are basically just
 .I string
 functions.
-The presence of an MS\-Windows(\(tm) drive designator is determined
+The presence of an MS\-Windows drive designator is determined
 by the appearance of a colon
 .RB (\(dq : \(dq)
 as the second character of the
@@ -459,13 +460,13 @@ represents a valid path name.
 .
 .SH AUTHOR
 .
-This manpage was written for the MinGW implementation of the
-.B dirname
+This manpage was written by \%Keith\ Marshall,
+\%<kei...@us...>, to document the
+.BR \%basename ()
 and
-.B basename
-functions by Keith\ Marshall,
-<kei...@us...>.
-It may copied, modified and redistributed,
+.BR \%dirname ()
+functions as they have been implemented for the MinGW.org Project.
+It may be copied, modified and redistributed,
 without restriction of copyright,
 provided this acknowledgement of contribution by
 the original author remains unchanged.

-----------------------------------------------------------------------

Summary of changes:
 mingwrt/ChangeLog                          |   18 ++++
 mingwrt/Makefile.in                        |   26 ++++--
 mingwrt/man/{dirname.man => dirname.3.man} |  121 ++++++++++++++--------------
 3 files changed, 97 insertions(+), 68 deletions(-)
 rename mingwrt/man/{dirname.man => dirname.3.man} (82%)


hooks/post-receive
-- 
Repository: mingw-org-wsl




2000	Jan	Feb	Mar	Apr	May	Jun	Jul	Aug	Sep	Oct	Nov	Dec (12)
2001	Jan (13)	Feb (2)	Mar (1)	Apr (1)	May	Jun (38)	Jul (10)	Aug (70)	Sep (63)	Oct (61)	Nov (41)	Dec (28)
2002	Jan (43)	Feb (11)	Mar (9)	Apr (2)	May (97)	Jun (94)	Jul (13)	Aug (49)	Sep (41)	Oct (24)	Nov (55)	Dec (126)
2003	Jan (90)	Feb (75)	Mar (32)	Apr (24)	May (54)	Jun (54)	Jul (22)	Aug (4)	Sep (16)	Oct (8)	Nov (6)	Dec (13)
2004	Jan	Feb (17)	Mar (60)	Apr (21)	May (12)	Jun	Jul (13)	Aug	Sep (29)	Oct	Nov	Dec (2)
2005	Jan (22)	Feb (3)	Mar (2)	Apr (13)	May (82)	Jun (18)	Jul (30)	Aug (17)	Sep (3)	Oct (19)	Nov (4)	Dec (8)
2006	Jan (1)	Feb (6)	Mar (2)	Apr (40)	May	Jun (21)	Jul (1)	Aug (410)	Sep (3)	Oct	Nov (56)	Dec (7)
2007	Jan (19)	Feb	Mar (4)	Apr (8)	May (19)	Jun (6)	Jul (4)	Aug (6)	Sep	Oct (4)	Nov (3)	Dec (2)
2008	Jan (13)	Feb (18)	Mar (12)	Apr	May (2)	Jun	Jul	Aug (1)	Sep	Oct	Nov	Dec
2009	Jan	Feb (6)	Mar (8)	Apr (2)	May (2)	Jun	Jul	Aug (2)	Sep (11)	Oct (13)	Nov (17)	Dec (6)
2010	Jan (24)	Feb (10)	Mar (27)	Apr (20)	May (108)	Jun (8)	Jul (23)	Aug (38)	Sep (49)	Oct (17)	Nov (12)	Dec (14)
2011	Jan (17)	Feb (7)	Mar (28)	Apr (8)	May (20)	Jun (11)	Jul (7)	Aug (12)	Sep (4)	Oct (20)	Nov (19)	Dec (2)
2012	Jan (2)	Feb (6)	Mar (5)	Apr (24)	May (5)	Jun (4)	Jul (6)	Aug (18)	Sep (38)	Oct (26)	Nov (12)	Dec (6)
2013	Jan (19)	Feb (18)	Mar (44)	Apr (35)	May (18)	Jun (21)	Jul (10)	Aug (19)	Sep (44)	Oct (25)	Nov (1)	Dec (2)
2014	Jan (8)	Feb	Mar	Apr (5)	May (1)	Jun (3)	Jul	Aug (3)	Sep	Oct (4)	Nov (4)	Dec (7)
2015	Jan	Feb	Mar (1)	Apr	May (2)	Jun (4)	Jul (6)	Aug (2)	Sep (8)	Oct (2)	Nov (1)	Dec (3)
2016	Jan (7)	Feb (9)	Mar (5)	Apr (5)	May (9)	Jun (4)	Jul (20)	Aug (4)	Sep (7)	Oct (6)	Nov (9)	Dec (2)
2017	Jan (7)	Feb (7)	Mar (5)	Apr	May (1)	Jun (4)	Jul (12)	Aug (4)	Sep (1)	Oct (4)	Nov (11)	Dec (14)
2018	Jan (3)	Feb (3)	Mar	Apr	May	Jun	Jul (2)	Aug	Sep	Oct	Nov	Dec

mingw-cvs Mailing List for MinGW - Minimalist GNU for Windows

A native Windows port of the GNU Compiler Collection (GCC)

mingw-cvs — List for CVS update notification

S	M	T	W	T	F	S
					1	2
3	4	5	6 (1)	7	8	9
10	11 (1)	12 (2)	13 (1)	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28	29	30