This is the mail archive of the
cygwin-patches
mailing list for the Cygwin project.
[PATCH 4/5] winsup/doc: Make and install cygwin-api function manpages
- From: Jon TURNEY <jon dot turney at dronecode dot org dot uk>
- To: cygwin-patches at cygwin dot com
- Cc: Jon TURNEY <jon dot turney at dronecode dot org dot uk>
- Date: Wed, 17 Jun 2015 13:37:05 +0100
- Subject: [PATCH 4/5] winsup/doc: Make and install cygwin-api function manpages
- Authentication-results: sourceware.org; auth=none
- References: <1434544626-2516-1-git-send-email-jon dot turney at dronecode dot org dot uk>
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>
---
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 ddee4e9..4c464b2 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
--
2.1.4