From c2f8489217c46e56481bae29f4838aec9d061c21 Mon Sep 17 00:00:00 2001
From: Bob Stayton <bobs@sagehill.net>
Date: Sun, 13 Oct 2013 21:06:50 +0000
Subject: [PATCH] Clarify that list.block.spacing is not used in nested lists.

---
 xsl/params/list.block.spacing.xml | 3 +++
 xsl/params/list.item.spacing.xml  | 4 +++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/xsl/params/list.block.spacing.xml b/xsl/params/list.block.spacing.xml
index 377e6f8a8..639baaf28 100644
--- a/xsl/params/list.block.spacing.xml
+++ b/xsl/params/list.block.spacing.xml
@@ -25,5 +25,8 @@
 </refsynopsisdiv>
 <refsection><info><title>Description</title></info>
 <para>Specify the spacing required before and after a list. It is necessary to specify the space after a list block because lists can come inside of paras.  </para>
+<para>This attribute set is not applied to nested lists, so that only the
+<paramter>list.item.spacing</paramter> attribute-set is used, which provides 
+consistent spacing.</para>
 </refsection>
 </refentry>
diff --git a/xsl/params/list.item.spacing.xml b/xsl/params/list.item.spacing.xml
index 21916520f..bdcf679eb 100644
--- a/xsl/params/list.item.spacing.xml
+++ b/xsl/params/list.item.spacing.xml
@@ -21,6 +21,8 @@
 </xsl:attribute-set></src:fragment>
 </refsynopsisdiv>
 <refsection><info><title>Description</title></info>
-<para>Specify what spacing you want between each list item.</para>
+<para>Specify what spacing you want before (and optionally after) each list item.</para>
+<para>See also <parameter>list.block.spacing</parameter>, which sets
+the spacing before and after an entire list.</para>
 </refsection>
 </refentry>
-- 
2.40.0