source: kde/extra-cmake-modules.xml

trunk
Last change on this file was b5d7180, checked in by Thomas Trepl (Moody) <thomas@…>, 5 weeks ago

Tags for 11.2

  • Property mode set to 100644
File size: 5.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6
7 <!ENTITY extra-cmake-modules-download-http "&kf5-download-http;/extra-cmake-modules-&kf5-version;.tar.xz">
8 <!ENTITY extra-cmake-modules-download-ftp " ">
9 <!ENTITY extra-cmake-modules-md5sum "9004ad7e58f5d3ef4a68ac9d3d432c51">
10 <!ENTITY extra-cmake-modules-size "324 KB">
11 <!ENTITY extra-cmake-modules-buildsize "4.5 MB">
12 <!ENTITY extra-cmake-modules-time "less than 0.1 SBU">
13]>
14
15<sect1 id="extra-cmake-modules" xreflabel="extra-cmake-modules-&kf5-version;">
16 <?dbhtml filename="extra-cmake-modules.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>extra-cmake-modules-&kf5-version;</title>
23
24 <indexterm zone="extra-cmake-modules">
25 <primary sortas="a-extra-cmake-modules">extra-cmake-modules</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Extra Cmake Modules</title>
30
31 <para>
32 The <application>Extra Cmake Modules</application> package contains
33 extra <application>CMake</application> modules used by
34 <application>KDE Frameworks 5</application> and other packages.
35 </para>
36
37 &lfs112_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&extra-cmake-modules-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&extra-cmake-modules-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &extra-cmake-modules-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &extra-cmake-modules-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &extra-cmake-modules-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &extra-cmake-modules-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Extra Cmake Modules Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="cmake"/>
78 </para>
79
80 <bridgehead renderas="sect4">Optional</bridgehead>
81 <para role="optional">
82 <ulink url="https://pypi.org/project/PyQt5/">PyQt</ulink> (experimental
83 support for building KDE Python bindings), and
84 <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink> (for
85 building documentation)
86 </para>
87
88 <para condition="html" role="usernotes">
89 User Notes: <ulink url="&blfs-wiki;/extra-cmake-modules"/>
90 </para>
91 </sect2>
92
93 <sect2 role="installation">
94 <title>Installation of Extra Cmake Modules</title>
95
96<!-- fix for python-3.10: only needed until upgrading to 5.87 (or above)
97 <para>
98 First, fix detection of Python-3.10 modules:
99 </para>
100
101<screen><userinput>sed 's/10)/11)/' -i find-modules/FindPythonModuleGeneration.cmake</userinput></screen>
102End fix for python-3.10 -->
103
104 <para>
105 Install <application>Extra Cmake Modules</application> by running the
106 following commands:
107 </para>
108
109<screen><userinput>sed -i '/"lib64"/s/64//' kde-modules/KDEInstallDirsCommon.cmake &amp;&amp;
110
111sed -e '/PACKAGE_INIT/i set(SAVE_PACKAGE_PREFIX_DIR "${PACKAGE_PREFIX_DIR}")' \
112 -e '/^include/a set(PACKAGE_PREFIX_DIR "${SAVE_PACKAGE_PREFIX_DIR}")' \
113 -i ECMConfig.cmake.in &amp;&amp;
114
115mkdir build &amp;&amp;
116cd build &amp;&amp;
117
118cmake -DCMAKE_INSTALL_PREFIX=/usr .. &amp;&amp;
119make</userinput></screen>
120
121 <para>
122 This package does not come with a test suite.
123 </para>
124
125 <note><para>
126 Unlike other KF5 packages, this module is installed in /usr because
127 it can be used by some non-KF5 packages.
128 </para></note>
129
130 <para>
131 Now, as the <systemitem class="username">root</systemitem> user:
132 </para>
133
134<screen role="root"><userinput>make install</userinput></screen>
135
136 </sect2>
137
138 <sect2 role="commands">
139 <title>Command Explanations</title>
140
141 <para>
142 <command>sed ... Modules/KDEInstallDirs.cmake</command>:
143 This command disables applications using cmake from attempting to
144 install files in a <filename class="directory">lib64</filename>
145 sub-directory.
146 </para>
147
148 <para>
149 <command>sed ... ECMConfig.cmake.in</command>:
150 This command protects the global <application>cmake</application>
151 variable <envar>PACKAGE_PREFIX_DIR</envar> from being changed when
152 checking ECM presence: since we install ECM into <filename
153 class="directory">/usr</filename>, the check would set that variable to
154 <filename class="directory">/usr</filename>, while most KDE packages
155 expect it to be set to <filename class="directory">/opt/kf5</filename>
156 and would fail to build if it is set to something else.
157 </para>
158 </sect2>
159
160 <sect2 role="content">
161 <title>Contents</title>
162
163 <segmentedlist>
164 <segtitle>Installed Programs</segtitle>
165 <segtitle>Installed Libraries</segtitle>
166 <segtitle>Installed Directories</segtitle>
167
168 <seglistitem>
169 <seg>
170 None
171 </seg>
172 <seg>
173 None
174 </seg>
175 <seg>
176 /usr/share/ECM and
177 /usr/share/doc/ECM (if documentation was built)
178 </seg>
179 </seglistitem>
180 </segmentedlist>
181
182 </sect2>
183
184</sect1>
Note: See TracBrowser for help on using the repository browser.