Clarified explanation so no one else reports bugs like #563473.

diff --git a/xsl/params/refentry.generate.name.xml b/xsl/params/refentry.generate.name.xml
index 6b2046e91fc2aaee0aee6ae60e0293597ae69318..f2b714f1f6050824c0ab20b0e98602b97c106b4d 100644 (file)
--- a/xsl/params/refentry.generate.name.xml
+++ b/xsl/params/refentry.generate.name.xml
@@ -16,7 +16,10 @@
 
 <para>If true (non-zero), a "NAME" section title is output before the list
 of 'RefName's. This parameter and
-<parameter>refentry.generate.title</parameter> are mutually exclusive.
+<parameter>refentry.generate.title</parameter> are mutually
+exclusive. This means that if you change this parameter to zero, you
+should set <parameter>refentry.generate.title</parameter> to 1 unless
+you want get quite strange output.
 </para>
 
 </refsect1>

diff --git a/xsl/params/refentry.generate.title.xml b/xsl/params/refentry.generate.title.xml
index d02fba9f8ac3ce2c041ce3ca512c15ea4d57d09d..6c3936235d30ce4f5d4a3a371821d9ad2d0e5b0b 100644 (file)
--- a/xsl/params/refentry.generate.title.xml
+++ b/xsl/params/refentry.generate.title.xml
@@ -19,7 +19,9 @@
 <para>If true (non-zero), the reference page title or first name is
 output before the list of 'RefName's. This parameter and
 <parameter>refentry.generate.name</parameter> are mutually exclusive.
-</para>
+This means that if you change this parameter to 1, you
+should set <parameter>refentry.generate.name</parameter> to 0 unless
+you want get quite strange output.</para>
 
 
 </refsect1>