public inbox for cygwin-patches@cygwin.com
 help / color / mirror / Atom feed
From: Jon TURNEY <jon.turney@dronecode.org.uk>
To: cygwin-patches@cygwin.com
Cc: Jon TURNEY <jon.turney@dronecode.org.uk>
Subject: [PATCH 2/5] winsup/doc: Generate ANSI rather than K&R style function prototypes
Date: Wed, 17 Jun 2015 12:37:00 -0000	[thread overview]
Message-ID: <1434544626-2516-3-git-send-email-jon.turney@dronecode.org.uk> (raw)
In-Reply-To: <1434544626-2516-1-git-send-email-jon.turney@dronecode.org.uk>

Since K&R style prototypes appear to be the default for HTML and FO, customize
the stylesheets rendering of funcsynopsis elements to generate ANSI style
prototypes instead.

2015-06-17  Jon Turney  <jon.turney@dronecode.org.uk>

	* fo.xsl: Render funcsynopsis elements as ANSI style function
	prototypes.
	* html.xsl: Ditto.

Signed-off-by: Jon TURNEY <jon.turney@dronecode.org.uk>
---
 winsup/doc/ChangeLog | 6 ++++++
 winsup/doc/fo.xsl    | 3 +++
 winsup/doc/html.xsl  | 3 +++
 3 files changed, 12 insertions(+)

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 453de70..347adcb 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,5 +1,11 @@
 2015-06-17  Jon Turney  <jon.turney@dronecode.org.uk>
 
+	* fo.xsl: Render funcsynopsis elements as ANSI style function
+	prototypes.
+	* html.xsl: Ditto.
+
+2015-06-17  Jon Turney  <jon.turney@dronecode.org.uk>
+
 	* html.xsl: Renamed from cygwin.xsl.
 
 2015-06-17  Corinna Vinschen  <corinna@vinschen.de>
diff --git a/winsup/doc/fo.xsl b/winsup/doc/fo.xsl
index ba8e191..f3fee0b 100644
--- a/winsup/doc/fo.xsl
+++ b/winsup/doc/fo.xsl
@@ -65,4 +65,7 @@
   </xsl:if>
 </xsl:template>
 
+	<!-- generate ansi rather than k&r style function synopses -->
+	<xsl:param name="funcsynopsis.style" select="ansi" />
+
 </xsl:stylesheet>
diff --git a/winsup/doc/html.xsl b/winsup/doc/html.xsl
index 2b02ea8..59b7735 100644
--- a/winsup/doc/html.xsl
+++ b/winsup/doc/html.xsl
@@ -23,4 +23,7 @@
 <!-- suppress refentry in toc being annotated with refpurpose -->
 <xsl:param name="annotate.toc" select="0" />
 
+<!-- generate ansi rather than k&r style function synopses -->
+<xsl:param name="funcsynopsis.style" select="ansi" />
+
 </xsl:stylesheet>
-- 
2.1.4

  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 ` [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 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 5/5] winsup/doc: Add man.xsl customization stylesheet 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-3-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).