[sdk/kdesrc-build/docbook_historied_per_file] doc/getting-started: doc: Improvements to system setup section.
Michael Pyne
null at kde.org
Fri May 10 10:15:57 BST 2024
Git commit c35613966fec3c30d84e7dcdf3c98e3aec95c8ba by Michael Pyne.
Committed on 03/06/2012 at 17:48.
Pushed by ashark into branch 'docbook_historied_per_file'.
doc: Improvements to system setup section.
Original commit: ab3ac943
https://invent.kde.org/sdk/kdesrc-build/-/commit/ab3ac9436093d7d0f2cffd2ce1617e161f9a5054
M +48 -20 doc/getting-started/before-building.docbook
M +1 -1 doc/getting-started/index.docbook
M +5 -0 doc/getting-started/kde-modules-and-selection.docbook
https://invent.kde.org/sdk/kdesrc-build/-/commit/c35613966fec3c30d84e7dcdf3c98e3aec95c8ba
diff --git a/doc/getting-started/before-building.docbook b/doc/getting-started/before-building.docbook
index 67a2ec3a..9cf6f142 100644
--- a/doc/getting-started/before-building.docbook
+++ b/doc/getting-started/before-building.docbook
@@ -30,8 +30,9 @@ in order to prepare and use the system installation correctly.
<para>Before using the &kdesrc-build; script (or any other building
strategy) you must install the development tools and libraries needed for &kde;.
-The complete list of required tools can be found from
-the <ulink url="http://techbase.kde.org/">KDE TechBase</ulink>.
+The nearly complete list of required tools can be found from
+the <ulink url="http://techbase.kde.org/Getting_Started/Build/Requirements">KDE
+TechBase Build Requirements</ulink> page.
</para>
<para>Here is a list of some of the things you will need:</para>
@@ -39,20 +40,43 @@ the <ulink url="http://techbase.kde.org/">KDE TechBase</ulink>.
<listitem><para>You will need &cmake;. The required version will vary
depending on what version of &kde; 4 you are building, see TechBase for
-specifics.</para></listitem>
+specifics, however a good bet is to have the most recent available version.
+&cmake; is the program used by &kdesrc-build; to handle the actual
+configuration and build steps for the vast majority of &kde; software.
+</para></listitem>
+
+<listitem><para>You must also install the client software used to checkout
+the &kde; source code. This means you need at least the following:</para>
-<listitem><para>Also needed is the &subversion; client program. You can check
+<itemizedlist>
+<listitem><para>&subversion;, which used to be the only source code manager in use, and is still
+used for some modules with large data files. You can check
if you have it by running <userinput><command>svn
-<option>--version</option></command></userinput>. </para></listitem>
+<option>--version</option></command></userinput>.</para></listitem>
-<listitem><para>You will also need the <ulink url="http://gitscm.org/">Git
+<listitem><para>You will need the <ulink url="http://gitscm.org/">Git
source control manager</ulink> installed as well, for &kde;'s <ulink
url="http://projects.kde.org/">git-based projects.</ulink>
.</para></listitem>
-<listitem><para>You will need a C++ development environment. GCC 4.6 or
+<listitem><para>Although it is not required, the <ulink
+url="http://bazaar.canonical.com/">Bazaar</ulink> source control manager is
+used for a single module (libdbusmenu-qt) that is required for the &kde;
+libraries. Most users can install this library through their distribution
+packages but &kdesrc-build; supports building it as well if you desire. But to
+build libdbusmenu-qt, you must have Bazaar installed.</para></listitem>
+
+</itemizedlist></listitem>
+
+<listitem><para>You will need a full C++ development environment. GCC 4.6 or
later is recommended.</para></listitem>
+<listitem><para>Finally, you will need a <quote>make</quote> tool. GNU Make is
+recommended and should be available through your package manager. After
+<command>cmake</command> has been run by &kdesrc-build;,
+<command>make</command> handles actually running the build process, which is
+why it is required.</para></listitem>
+
</itemizedlist>
<note><para>Most operating system distributions include a method of easily
@@ -76,8 +100,13 @@ to use the &Qt; copy, you need to do these things:</para>
<listitem>
<para>Change the setting of the <link linkend="conf-qtdir">qtdir</link>
option in your <link linkend="configure-data">configuration file</link> to
- point to your system &Qt;. This is normally equal to the setting of
- $<envar>QTDIR</envar> for your system.</para>
+ point to your system &Qt;. The location of your system &Qt; can be found
+ by running <userinput><command>qmake</command> <option>-query</option>
+ <option>QT_INSTALL_PREFIX</option></userinput>.</para>
+
+ <note><para>The <command>qmake</command> command might be called
+ <command>qmake4</command> or <command>qmake-qt4</command> on your
+ distribution.</para></note>
</listitem>
<listitem>
@@ -87,17 +116,16 @@ to use the &Qt; copy, you need to do these things:</para>
</listitem>
</itemizedlist>
-<para>
-Some of these packages are divided into libraries (or programs or utilities), and
-development packages. You will need at least the program or library and
-its development package. If in doubt, install all. The libraries you need
-will change depending on the modules you intend to build, as each module
-has its own requirements. The
-<ulink url="http://techbase.kde.org/Getting_Started/Build/KDE4#Required_packages_from_your_distribution">&kde;
-TechBase</ulink> has more details
-about the specific tools and techniques used to install and find the
-required software.
-</para>
+<important><para>
+Some of these packages are divided into libraries (or programs or utilities),
+and development packages. You will need at least the program or library
+<emphasis>and</emphasis> its development package. The libraries you need will
+change depending on the modules you intend to build, as each module has its own
+requirements. The <ulink
+url="http://techbase.kde.org/Getting_Started/Build/KDE4#Required_packages_from_your_distribution">&kde;
+TechBase</ulink> has more details about the specific tools and techniques used
+to install and find the required software.
+</para></important>
</sect2>
diff --git a/doc/getting-started/index.docbook b/doc/getting-started/index.docbook
index 0a9f0763..855c3175 100644
--- a/doc/getting-started/index.docbook
+++ b/doc/getting-started/index.docbook
@@ -4,7 +4,7 @@
<para>
In this chapter, we show how to use the &kdesrc-build; to checkout modules from
the &kde; repository and build them. We also provide a basic explanation of the
-&kde; &subversion; structure and the steps you have to perform before running
+&kde; source code structure and the steps you have to perform before running
the script.
</para>
diff --git a/doc/getting-started/kde-modules-and-selection.docbook b/doc/getting-started/kde-modules-and-selection.docbook
index 54948cb6..9d2eee73 100644
--- a/doc/getting-started/kde-modules-and-selection.docbook
+++ b/doc/getting-started/kde-modules-and-selection.docbook
@@ -290,6 +290,11 @@ because &kdesrc-build; will not perform dependency handling.
</para></listitem>
</orderedlist>
+<note><para>It is worth nothing that &kdesrc-build; will try to build modules
+in the right order, but this depends on other databases being kept up-to-date.
+You can manually do the right thing if necessary by using the technique
+described above.
+</para></note>
</sect2>
</sect1>
More information about the kde-doc-english
mailing list