From: Jon TURNEY <jon.turney@dronecode.org.uk>
To: cygwin-patches@cygwin.com
Cc: Jon TURNEY <jon.turney@dronecode.org.uk>
Subject: [PATCH 5/5] winsup/doc: Add man.xsl customization stylesheet
Date: Wed, 17 Jun 2015 12:37:00 -0000 [thread overview]
Message-ID: <1434544626-2516-6-git-send-email-jon.turney@dronecode.org.uk> (raw)
In-Reply-To: <1434544626-2516-1-git-send-email-jon.turney@dronecode.org.uk>
2015-06-17 Jon Turney <jon.turney@dronecode.org.uk>
* man.xsl: New file.
* Makefile.in (utils2man.stamp, api2man.stamp): Use it.
Signed-off-by: Jon TURNEY <jon.turney@dronecode.org.uk>
---
winsup/doc/ChangeLog | 5 +++++
winsup/doc/Makefile.in | 8 ++++----
winsup/doc/man.xsl | 13 +++++++++++++
3 files changed, 22 insertions(+), 4 deletions(-)
create mode 100644 winsup/doc/man.xsl
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 4c464b2..3693516 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,5 +1,10 @@
2015-06-17 Jon Turney <jon.turney@dronecode.org.uk>
+ * man.xsl: New file.
+ * Makefile.in (utils2man.stamp, api2man.stamp): Use it.
+
+2015-06-17 Jon Turney <jon.turney@dronecode.org.uk>
+
* Makefile.in (api2man.stamp): Add rules to build and install
manpages for cygwin-api.
diff --git a/winsup/doc/Makefile.in b/winsup/doc/Makefile.in
index f308ab2..60b375a 100644
--- a/winsup/doc/Makefile.in
+++ b/winsup/doc/Makefile.in
@@ -97,8 +97,8 @@ cygwin-ug-net/cygwin-ug-net.html : $(cygwin-ug-net_SOURCES) html.xsl
cygwin-ug-net/cygwin-ug-net.pdf : $(cygwin-ug-net_SOURCES) fo.xsl
-$(XMLTO) pdf -o cygwin-ug-net/ -m $(srcdir)/fo.xsl $<
-utils2man.stamp: $(cygwin-ug-net_SOURCES)
- $(XMLTO) man $<
+utils2man.stamp: $(cygwin-ug-net_SOURCES) man.xsl
+ $(XMLTO) man -m ${srcdir}/man.xsl $<
@touch $@
cygwin-api/cygwin-api.html : $(cygwin-api_SOURCES) html.xsl
@@ -107,8 +107,8 @@ 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 $<
+api2man.stamp: $(cygwin-api_SOURCES) man.xsl
+ $(XMLTO) man -m ${srcdir}/man.xsl $<
@touch $@
faq/faq.html : $(FAQ_SOURCES)
diff --git a/winsup/doc/man.xsl b/winsup/doc/man.xsl
new file mode 100644
index 0000000..22e624f
--- /dev/null
+++ b/winsup/doc/man.xsl
@@ -0,0 +1,13 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'>
+
+<!-- don't truncate manpage titles for long function names -->
+<xsl:param name="man.th.title.max.length" select="33" />
+
+<!-- don't moan about missing metadata -->
+<xsl:param name="refentry.meta.get.quietly" select="1" />
+
+<!-- base URL for relative links -->
+<xsl:param name="man.base.url.for.relative.links">https://cygwin.com/cygwin-ug-net/</xsl:param>
+
+</xsl:stylesheet>
--
2.1.4
next prev parent reply other threads:[~2015-06-17 12:37 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-06-17 12:37 [PATCH 0/5] Generate cygwin-api manpages Jon TURNEY
2015-06-17 12:37 ` Jon TURNEY [this message]
2015-06-17 12:37 ` [PATCH 4/5] winsup/doc: Make and install cygwin-api function manpages Jon TURNEY
2015-06-19 14:05 ` Jon TURNEY
2015-06-17 12:37 ` [PATCH 2/5] winsup/doc: Generate ANSI rather than K&R style function prototypes Jon TURNEY
2015-06-17 12:37 ` [PATCH 1/5] winsup/doc: Rename cygwin.xsl as html.xsl Jon TURNEY
2015-06-17 12:37 ` [PATCH 3/5] winsup/doc: Convert cygwin-api function documentation to refentry elements Jon TURNEY
2015-06-17 13:49 ` [PATCH 0/5] Generate cygwin-api manpages Corinna Vinschen
2015-06-17 15:59 ` Jon TURNEY
2015-06-17 16:28 ` Corinna Vinschen
2015-06-18 10:46 ` Jon TURNEY
2015-06-18 20:05 ` Corinna Vinschen
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1434544626-2516-6-git-send-email-jon.turney@dronecode.org.uk \
--to=jon.turney@dronecode.org.uk \
--cc=cygwin-patches@cygwin.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).