From b71f70281302324049eb336c61047df68e9a8307 Mon Sep 17 00:00:00 2001
From: Frank Steimke <fsteimke.hb@gmail.com>
Date: Thu, 18 Jan 2024 06:13:12 +0100
Subject: [PATCH] A new note admonition in section 2.1 informs that you must
 enable xinclude processing in case of modular DocBook files.

---
 src/guide/xml/ch02.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/guide/xml/ch02.xml b/src/guide/xml/ch02.xml
index 4bf48f7af..1b75292ca 100755
--- a/src/guide/xml/ch02.xml
+++ b/src/guide/xml/ch02.xml
@@ -168,6 +168,11 @@ the <filename>xslt/docbook.xsl</filename> stylesheet will be used automatically.
 </listitem>
 </varlistentry>
 </variablelist>
+    <note>
+      <title>Processing modular DocBook files</title>
+      <para>Please note that in the case of modular DocBook documents, you must explicitly enable
+        xi:include processing by using the <code>-xi:on</code> parameter.</para>
+    </note>
 </section>
 
 <section xml:id="python-script">