[sdk/kdesrc-build] doc: doc: kde-cmake - separate docbook

[Andrew Shark]

Git commit 3e5fffc88db32f4fe3d0fb7f2f9e364f03ab0d91 by Andrew Shark.
Committed on 05/01/2024 at 19:59.
Pushed by ashark into branch 'master'.

doc: kde-cmake - separate docbook

M  +2    -29   doc/index.docbook
A  +29   -0    doc/kde-cmake.docbook

https://invent.kde.org/sdk/kdesrc-build/-/commit/3e5fffc88db32f4fe3d0fb7f2f9e364f03ab0d91

diff --git a/doc/index.docbook b/doc/index.docbook
index 39d821d5..d17b5b80 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -83,6 +83,7 @@
   <!ENTITY getting-started SYSTEM "getting-started.docbook">
   <!ENTITY intro-toc SYSTEM "intro-toc.docbook">
   <!ENTITY introduction SYSTEM "introduction.docbook">
+  <!ENTITY kde-cmake SYSTEM "kde-cmake.docbook">
 ]>
 
 <book id="kdesrc-build" lang="&language;">
@@ -555,35 +556,7 @@ end global
 
 </chapter>
 
-<chapter id="kde-cmake">
-<title>&cmake;, the &kde; build system</title>
-
-<sect1 id="kde-cmake-intro">
-<title>Introduction to &cmake;</title>
-
-<para>In March 2006, the &cmake; program
-beat out several competitors and was selected to be the build system for &kde; 4, replacing the
-autotools-based system that &kde; had used from the beginning.</para>
-
-<para>A introduction to &cmake; page is available on the <ulink
-url="https://community.kde.org/Guidelines_HOWTOs/CMake">&kde; Community Wiki</ulink>.
-Basically, instead of running <userinput><command>make</command> <option>-f</option>
-<filename>Makefile.cvs</filename></userinput>, then <command>configure</command>,
-then &make;, we simply run &cmake; and then &make;.
-</para>
-
-<para>&kdesrc-build; has support for &cmake;. A few features of &kdesrc-build;
-were really features of the underlying buildsystem, including
-<link linkend="conf-configure-flags">configure-flags</link>
-and <link linkend="conf-do-not-compile">do-not-compile</link>. When equivalent
-features are available, they are provided. For instance, the equivalent to the
-configure-flags option is <link linkend="conf-cmake-options">cmake-options</link>, and the
-<link linkend="conf-do-not-compile">do-not-compile</link> option is also supported for &cmake;
-as of &kdesrc-build; version 1.6.3.
-</para>
-
-</sect1>
-</chapter>
+&kde-cmake;
 
 &credits-and-license;
 
diff --git a/doc/kde-cmake.docbook b/doc/kde-cmake.docbook
new file mode 100644
index 00000000..9c818591
--- /dev/null
+++ b/doc/kde-cmake.docbook
@@ -0,0 +1,29 @@
+<chapter id="kde-cmake">
+<title>&cmake;, the &kde; build system</title>
+
+<sect1 id="kde-cmake-intro">
+<title>Introduction to &cmake;</title>
+
+<para>In March 2006, the &cmake; program
+beat out several competitors and was selected to be the build system for &kde; 4, replacing the
+autotools-based system that &kde; had used from the beginning.</para>
+
+<para>A introduction to &cmake; page is available on the <ulink
+url="https://community.kde.org/Guidelines_HOWTOs/CMake">&kde; Community Wiki</ulink>.
+Basically, instead of running <userinput><command>make</command> <option>-f</option>
+<filename>Makefile.cvs</filename></userinput>, then <command>configure</command>,
+then &make;, we simply run &cmake; and then &make;.
+</para>
+
+<para>&kdesrc-build; has support for &cmake;. A few features of &kdesrc-build;
+were really features of the underlying buildsystem, including
+<link linkend="conf-configure-flags">configure-flags</link>
+and <link linkend="conf-do-not-compile">do-not-compile</link>. When equivalent
+features are available, they are provided. For instance, the equivalent to the
+configure-flags option is <link linkend="conf-cmake-options">cmake-options</link>, and the
+<link linkend="conf-do-not-compile">do-not-compile</link> option is also supported for &cmake;
+as of &kdesrc-build; version 1.6.3.
+</para>
+
+</sect1>
+</chapter>