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>