From df66670e510bb71b64142e69c55af0882e2e0e65 Mon Sep 17 00:00:00 2001
From: Bob Stayton <bobs@sagehill.net>
Date: Sun, 2 Dec 2012 19:19:49 +0000
Subject: [PATCH] Improve the description.

---
 xsl/params/double.sided.xml      | 18 ++++++++++++++----
 xsl/params/page.margin.inner.xml |  2 ++
 xsl/params/page.margin.outer.xml |  2 ++
 xsl/params/writing.mode.xml      |  2 +-
 4 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/xsl/params/double.sided.xml b/xsl/params/double.sided.xml
index 3758f1ffc..ac40dcc1f 100644
--- a/xsl/params/double.sided.xml
+++ b/xsl/params/double.sided.xml
@@ -21,11 +21,21 @@
 
 <refsection><info><title>Description</title></info>
 
-<para>Double-sided documents are printed with a slightly wider margin
-on the binding edge of the page.
+<para>This parameter is useful when printing a document
+on both sides of the paper.</para>
+
+<para>if set to non-zero, documents are formatted using different page-masters
+for odd and even pages.  These can differ by using a slightly wider margin
+on the binding edge of the page, and alternating left-right
+positions of header or footer elements.
 </para>
-<para>FIXME: The current set of parameters does not take writing direction
-into account.</para>
+
+<para>If set to zero (the default), then only the 'odd' page masters
+are used for both even and odd numbered pages.</para>
+
+<para>See also <parameter>force.blank.pages</parameter>,
+<parameter>page.margin.inner</parameter> and
+<parameter>page.margin.outer</parameter>.</para>
 
 </refsection>
 </refentry>
diff --git a/xsl/params/page.margin.inner.xml b/xsl/params/page.margin.inner.xml
index 97782ba40..4e6593eeb 100644
--- a/xsl/params/page.margin.inner.xml
+++ b/xsl/params/page.margin.inner.xml
@@ -52,5 +52,7 @@ this bug is fixed by RenderX.  It does not affect documents
 with left-to-right text direction.</para>
 </note>
 
+<para>See also <parameter>writing.mode</parameter>.</para>
+
 </refsection>
 </refentry>
diff --git a/xsl/params/page.margin.outer.xml b/xsl/params/page.margin.outer.xml
index 61dfeb8e4..4536342bd 100644
--- a/xsl/params/page.margin.outer.xml
+++ b/xsl/params/page.margin.outer.xml
@@ -49,5 +49,7 @@ this bug is fixed by RenderX.  It does not affect documents
 with left-to-right text direction.</para>
 </note>
 
+<para>See also <parameter>writing.mode</parameter>.</para>
+
 </refsection>
 </refentry>
diff --git a/xsl/params/writing.mode.xml b/xsl/params/writing.mode.xml
index c6959333d..e0f33fcce 100644
--- a/xsl/params/writing.mode.xml
+++ b/xsl/params/writing.mode.xml
@@ -34,7 +34,7 @@
 The value is normally taken from the gentext file for the 
 lang attribute of the document's root element, using the 
 key name 'writing-mode' to look it up in the gentext file.
-But the param can also be
+But this param can also be
 set on the command line to override that gentext value.
 </para>
 <para>Accepted values are:
-- 
2.40.0