From 0ad52abe8d5bb8259198940ba92792604b8b2e55 Mon Sep 17 00:00:00 2001
From: Bob Stayton <bobs@sagehill.net>
Date: Tue, 14 Jun 2005 15:27:05 +0000
Subject: [PATCH] Clarified the use of this parameter with FOP.

---
 xsl/params/body.start.indent.xml | 29 +++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/xsl/params/body.start.indent.xml b/xsl/params/body.start.indent.xml
index 53242df7a..2807ca65b 100644
--- a/xsl/params/body.start.indent.xml
+++ b/xsl/params/body.start.indent.xml
@@ -10,12 +10,27 @@
 
 <refsynopsisdiv>
 <src:fragment id='body.start.indent.frag'>
-<xsl:param name="body.start.indent" select="'4pc'"/>
+<xsl:param name="body.start.indent">
+  <xsl:choose>
+    <xsl:when test="$fop.extensions != 0">0pt</xsl:when>
+    <xsl:when test="$passivetex.extensions != 0">0pt</xsl:when>
+    <xsl:otherwise>4pc</xsl:otherwise>
+  </xsl:choose>
+</xsl:param>
 </src:fragment>
 </refsynopsisdiv>
 
 <refsect1><title>Description</title>
 
+<para>This parameter provides
+one means of indenting the body text relative to
+the left page margin.
+It is used in place of the 
+<parameter>title.margin.left</parameter> for
+all XSL-FO processors except FOP.
+It enables support for side floats to appear
+in the indented margin area.
+</para>
 <para>This start-indent property is added to the fo:flow
 for certain page sequences.  Which page-sequences it is 
 applied to is determined by the template named
@@ -24,8 +39,18 @@ By default, that template adds it to the flow
 for page-sequences using the <quote>body</quote>
 master-reference, as well as appendixes and prefaces.
 </para>
+<para>If this parameter is used, section titles should have
+a start-indent value of 0pt if they are to be
+outdented relative to the body text.
+</para>
+
+<para>If you are using FOP, then set this parameter to a zero
+width value and set the <parameter>title.margin.left</parameter>
+parameter to the negative value of the desired indent.
+</para>
 
-<para>See also <parameter>body.end.indent</parameter>.
+<para>See also <parameter>body.end.indent</parameter> and
+<parameter>title.margin.left</parameter>.
 </para>
 
 </refsect1>
-- 
2.40.0