Improve the description.

diff --git a/xsl/params/double.sided.xml b/xsl/params/double.sided.xml
index 3758f1ffc5c707534e9075faeaf292e41ff9398c..ac40dcc1f05bd02b6cba82f9d87aa27ef4c6a553 100644 (file)
--- 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 97782ba40ba8b252908dd77d1198d9da57cddbab..4e6593eebf484a076f10082eab0267153a65f4e9 100644 (file)
--- 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 61dfeb8e44d9cfa660f163b82b53852561ade783..4536342bdefca6bc756f2c6bb4583e230ae680a9 100644 (file)
--- 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 c6959333d2375ec7ea02f607e19532a11d10fae9..e0f33fcce2f55ec9159056380c4e35c33d1fc0be 100644 (file)
--- 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: