This is the mail archive of the
cygwin-cvs@cygwin.com
mailing list for the Cygwin project.
[newlib-cygwin] winsup/doc: Make and install cygwin-api function manpages
- From: Jon TURNEY <jturney at sourceware dot org>
- To: cygwin-cvs at sourceware dot org
- Date: 18 Jun 2015 10:40:38 -0000
- Subject: [newlib-cygwin] winsup/doc: Make and install cygwin-api function manpages
https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=94f16969d39dfc0de3eefb75a4793367da76fe00
commit 94f16969d39dfc0de3eefb75a4793367da76fe00
Author: Jon TURNEY <jon.turney@dronecode.org.uk>
Date: Tue Jun 16 18:55:38 2015 +0100
winsup/doc: Make and install cygwin-api function manpages
Use 'xmlto man' to make manpages for utils
This will generate multiple .1 files as an output, but we don't know what they
will be called, so use a timestamp for build avoidance
2015-06-17 Jon Turney <jon.turney@dronecode.org.uk>
* Makefile.in (api2man.stamp): Add rules to build and install
manpages for cygwin-api.
Signed-off-by: Jon TURNEY <jon.turney@dronecode.org.uk>
Diff:
---
winsup/doc/ChangeLog | 5 +++++
winsup/doc/Makefile.in | 13 +++++++++++--
2 files changed, 16 insertions(+), 2 deletions(-)
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index a693b18..9e796d2 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,5 +1,10 @@
2015-06-17 Jon Turney <jon.turney@dronecode.org.uk>
+ * Makefile.in (api2man.stamp): Add rules to build and install
+ manpages for cygwin-api.
+
+2015-06-17 Jon Turney <jon.turney@dronecode.org.uk>
+
* cygwin-api.xml: Move introductory paragraph here.
* logon-funcs.xml: Convert from using a sect2 element to using a
refentry element for each function.
diff --git a/winsup/doc/Makefile.in b/winsup/doc/Makefile.in
index c9e32c8..f308ab2 100644
--- a/winsup/doc/Makefile.in
+++ b/winsup/doc/Makefile.in
@@ -18,6 +18,7 @@ docdir = @docdir@
htmldir = @htmldir@
mandir = @mandir@
man1dir = $(mandir)/man1
+man3dir = $(mandir)/man3
override INSTALL:=@INSTALL@
override INSTALL_DATA:=@INSTALL_DATA@
@@ -48,7 +49,8 @@ all: Makefile Makefile.dep \
faq/faq.body faq/faq.html \
cygwin-ug-net/cygwin-ug-net.pdf \
cygwin-api/cygwin-api.pdf \
- utils2man.stamp
+ utils2man.stamp \
+ api2man.stamp
Makefile: $(srcdir)/Makefile.in
/bin/sh ./config.status
@@ -58,6 +60,7 @@ clean:
rm -f *.html *.html.gz
rm -Rf cygwin-api cygwin-ug cygwin-ug-net faq
rm -f *.1 utils2man.stamp
+ rm -f *.3 api2man.stamp
install: install-all
@@ -75,9 +78,11 @@ install-html: cygwin-ug-net/cygwin-ug-net.html cygwin-api/cygwin-api.html
$(INSTALL_DATA) cygwin-api/*.html $(DESTDIR)$(htmldir)/cygwin-api
$(INSTALL_DATA) cygwin-api/cygwin-api.html $(DESTDIR)$(htmldir)/cygwin-api/index.html
-install-man: utils2man.stamp
+install-man: utils2man.stamp api2man.stamp
@$(MKDIRP) $(DESTDIR)$(man1dir)
$(INSTALL_DATA) *.1 $(DESTDIR)$(man1dir)
+ @$(MKDIRP) $(DESTDIR)$(man1dir)
+ $(INSTALL_DATA) *.3 $(DESTDIR)$(man3dir)
cygwin-ug-net/cygwin-ug-net-nochunks.html.gz : $(cygwin-ug-net_SOURCES) html.xsl
-$(XMLTO) html-nochunks -m $(srcdir)/html.xsl $<
@@ -102,6 +107,10 @@ cygwin-api/cygwin-api.html : $(cygwin-api_SOURCES) html.xsl
cygwin-api/cygwin-api.pdf : $(cygwin-api_SOURCES) fo.xsl
-$(XMLTO) pdf -o cygwin-api/ -m $(srcdir)/fo.xsl $<
+api2man.stamp: $(cygwin-api_SOURCES)
+ $(XMLTO) man $<
+ @touch $@
+
faq/faq.html : $(FAQ_SOURCES)
-$(XMLTO) html -o faq -m $(srcdir)/html.xsl $(srcdir)/faq.xml
-sed -i 's;<a name="id[mp][0-9]*"></a>;;g' faq/faq.html