[sdk/kdesrc-build/docbook_historied_per_file] doc/kdesrc-buildrc: RecursiveFH: Support variables in include lines

Git commit 17b9fd13a5236d572d3e502811e91d1cb604477b by Andrew Shark.
Committed on 02/02/2024 at 08:07.
Pushed by ashark into branch 'docbook_historied_per_file'.

RecursiveFH: Support variables in include lines

Original commit: 399806c1
https://invent.kde.org/sdk/kdesrc-build/-/commit/399806c1efd4514b75c9f1254bb4b408f02a7221

M  +12   -0    doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/17b9fd13a5236d572d3e502811e91d1cb604477b

diff --git a/doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook b/doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook
index 0ac0cf6f..3469e11d 100644
--- a/doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook
+++ b/doc/kdesrc-buildrc/kdesrc-buildrc-overview.docbook
@@ -219,6 +219,18 @@ end global
 the file will be searched for starting from the directory containing the source
 file. This works recursively as well.</para></note>
 
+<para>You can use variables in the value of include instruction:</para>
+<programlisting>
+global
+  <replaceable>_ver</replaceable> <replaceable>6</replaceable>
+  source-dir ~/kde<replaceable>${_ver}</replaceable>/src
+  ...
+  persistent-data-file ~/kde<replaceable>${_ver}</replaceable>/persistent-options.json
+end global
+
+include ~/kde6/src/kdesrc-build/data/build-include/kf<replaceable>${_ver}</replaceable>-qt<replaceable>${_ver}</replaceable>.ksb
+
+</programlisting>
 </sect2>
 
 <sect2 id="kdesrc-buildrc-common">