source: kde/extra-cmake-modules.xml

trunk
Last change on this file was c6d0653, checked in by Bruce Dubbs <bdubbs@…>, 12 days ago

Fix several md5sums

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