source: kde/core/kdelibs.xml@ 7712824

10.0 10.1 11.0 11.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 7712824 was 7712824, checked in by Randy McMurchy <randy@…>, 12 years ago

Fixed typos, thanks to Allard Welter for the report

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@8690 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.4 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 kdelibs-download-http "&kde-download-http;/kdelibs-&kde-version;.tar.bz2">
8 <!ENTITY kdelibs-download-ftp "&kde-download-ftp;/kdelibs-&kde-version;.tar.bz2">
9 <!ENTITY kdelibs-md5sum "43cd55ed15f63b5738d620ef9f9fd568">
10 <!ENTITY kdelibs-size "14.9 MB">
11 <!ENTITY kdelibs-buildsize "254 MB (additional 426 MB for API docs)">
12 <!ENTITY kdelibs-time "13.1 SBU (additional 3.0 SBU for API docs)">
13]>
14
15<sect1 id="kdelibs" xreflabel="kdelibs-&kde-version;">
16 <?dbhtml filename="kdelibs.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Kdelibs-&kde-version;</title>
24
25 <indexterm zone="kdelibs">
26 <primary sortas="a-kdelibs">Kdelibs</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Kdelibs</title>
31
32 <para>This package includes programs and libraries that are central to the
33 development and execution of a <application>KDE</application> program,
34 as well as internationalization files for these libraries, miscellaneous
35 HTML documentation, theme modules and regression tests.</para>
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing='compact'>
39 <listitem>
40 <para>Download (HTTP): <ulink url="&kdelibs-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download (FTP): <ulink url="&kdelibs-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sum: &kdelibs-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>Download size: &kdelibs-size;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated disk space required: &kdelibs-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time: &kdelibs-time;</para>
56 </listitem>
57 </itemizedlist>
58
59 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
60 <itemizedlist spacing="compact">
61 <listitem>
62 <para>Required patch: <ulink
63 url="&patch-root;/kdelibs-&kde-version;-charset-1.patch"/></para>
64 </listitem>
65 </itemizedlist>
66
67 <bridgehead renderas="sect3">Kdelibs Dependencies</bridgehead>
68
69 <bridgehead renderas="sect4">Required</bridgehead>
70 <para role="required"><xref linkend="qt"/></para>
71
72 <bridgehead renderas="sect4">Recommended</bridgehead>
73 <para role="recommended"><xref linkend="aRts"/>,
74 <xref linkend="libjpeg"/>,
75 <xref linkend="libart_lgpl"/>,
76 <xref linkend="libxml2"/>,
77 <xref linkend="libxslt"/>,
78 <xref linkend="pcre"/>,
79 <xref linkend="gamin"/>,
80 <xref linkend="openssl"/>, and
81 <xref linkend="libidn"/></para>
82
83 <bridgehead renderas="sect4">Optional</bridgehead>
84 <para role="optional"><xref linkend="libtiff"/>,
85 <xref linkend="aspell"/>,
86 <xref linkend="cups"/>,
87 <xref linkend="alsa"/>,
88 <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
89 <ulink url="http://www.openexr.com/">OpenEXR</ulink>,
90 <xref linkend="jasper"/>,
91 <ulink url="http://www.lua.org/">Lua</ulink> (version &lt; 5.1),
92 <ulink url="http://www.opensource.apple.com/darwinsource/tarballs/apsl/">mDNSResponder</ulink>,
93 <ulink url="http://sourceforge.net/projects/libthai">LibThai</ulink>,
94 <ulink url="http://www.ivrix.org.il/projects/spell-checker/">Hspell</ulink>,
95 <ulink url="ftp://oss.sgi.com/projects/xfs/cmd_tars/">libacl</ulink>
96 (requires <ulink url="ftp://oss.sgi.com/projects/xfs/cmd_tars/">libattr</ulink>),
97 <xref linkend="sudo"/>,
98 <xref linkend="graphviz"/>, and
99 <xref linkend="doxygen"/></para>
100
101 <para condition="html" role="usernotes">User Notes:
102 <ulink url="&blfs-wiki;/kdelibs"/></para>
103
104 </sect2>
105
106 <sect2 id="kdelibs-runtime-dependencies"
107 xreflabel="KDE Libraries Runtime Dependencies">
108 <title>Run-Time Dependencies</title>
109
110 <para>The <application>KDE</application> libraries access other programs at
111 run time. One additional package that has not been mentioned already is
112 <ulink url="http://packages.debian.org/unstable/source/pmount/">
113 pmount</ulink>. This enables auto-mounting of hotplugged devices at
114 /media/[device_name] for any user without any fstab modification. It is
115 needed to enable the full integration of <application>KDE</application>
116 with <xref linkend="hal"/>.</para>
117
118 </sect2>
119
120 <sect2 role="installation" id="kdelibs-install"
121 xreflabel="the installation of kdelibs">
122 <title>Installation of Kdelibs</title>
123
124 <para>Install <application>kdelibs</application> with:</para>
125
126<screen><userinput>patch -Np1 -i ../kdelibs-&kde-version;-charset-1.patch &amp;&amp;
127sed -i -e 's|linux/inotify|sys/inotify|' \
128 -e '/^static inline int inotify_init/,/^}/d' \
129 -e '/^static inline int inotify_add_watch/,/^}/d' \
130 -e '/^static inline int inotify_rm_watch/,/^}/d' \
131 kio/kio/kdirwatch.cpp &amp;&amp;
132./configure --prefix=$KDE_PREFIX \
133 --sysconfdir=/etc/kde \
134 --disable-debug \
135 --disable-dependency-tracking &amp;&amp;
136make</userinput></screen>
137
138 <note>
139
140 <para>If you wish to create the API documentation and you have
141 <application>Doxygen</application> and
142 <application>Graphviz</application> installed, it must be done before the
143 <command>make install</command>. This applies to all packages which can
144 utilize <application>Doxygen</application>.</para>
145
146 <para><emphasis>The usual building of the API documentation in this package
147 will run forever because of a bug in <application>doxygen</application>
148 versions 1.5.8 and earlier.</emphasis> There is a symbolic link in the
149 <filename class='directory'>kdeprint</filename> directory that is not
150 handled properly. To fix this, either update to the current version of
151 <application>doxygen</application> or delete the link, generate the
152 documentation, and recreate the symbolic link:</para>
153
154 <screen><userinput>rm kdeprint/kdeprint &amp;&amp;
155make apidox &amp;&amp;
156ln -s management kdeprint/kdeprint</userinput></screen>
157
158 <para>The <command>make apidox</command> command generates a lot of
159 errors and warnings. In some cases it complains that Helvetica fonts are
160 missing and substitutes a font that does not fit boxes properly. You can
161 add the font by downloading the <ulink
162 url="ftp://ftp.tug.ctan.org/pub/tex-archive/nonfree/support/ghostscript/AFPL/GhostPCL/">
163 URW Fonts </ulink> and
164 unpacking them into <filename class='directory'>~/.fonts</filename>.
165 <command>fc-cache</command> should also be run to update the font
166 properties on your system.</para>
167
168 <para>The documents generated are HTML and are found in <filename
169 class='directory'>&kde-dir;/share/doc/HTML/en/kdelibs-apidocs</filename>.
170 </para>
171 </note>
172
173 <para>This package does not come with a test suite that works with
174 <application>GCC</application>-&gcc-version;.</para>
175
176 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
177
178<screen role='root'><userinput>make install</userinput></screen>
179
180 </sect2>
181
182 <sect2 role="commands">
183 <title>Command Explanations</title>
184
185 <para><command>sed -i ... kio/kio/kdirwatch.cpp</command>: This command is
186 necessary to prevent a conflict in linux headers. The equivalent
187 instructions that are deleted are now within glibc.</para>
188
189 <para><parameter>--prefix=&kde-dir;</parameter>: This option tells the process
190 to install the package in <filename class="directory">&kde-dir;</filename>.</para>
191
192 <para><parameter>--disable-debug</parameter>: This option causes the
193 package to be compiled without debugging code.</para>
194
195 <para><parameter>--disable-dependency-tracking</parameter>: This option
196 speeds up one time builds.</para>
197
198 <para><parameter>--sysconfdir=/etc/kde</parameter>: This option places
199 configuration files in compliance with the <ulink
200 url='http://www.pathname.com/fhs/pub/fhs-2.3.html#ETCHOSTSPECIFICSYSTEMCONFIGURATION'
201 >Filesystem Hierarchy Standard</ulink>. If you omit this parameter, the
202 configuration files will be placed in <filename
203 class='directory'>$KDE_PREFIX/etc</filename> which may be desirable if
204 you have multiple versions of <application>KDE</application> installed.</para>
205
206 </sect2>
207
208 <sect2 role="content">
209 <title>Contents</title>
210
211 <segmentedlist>
212 <segtitle>Installed Programs</segtitle>
213 <segtitle>Installed Libraries</segtitle>
214 <segtitle>Installed Directories</segtitle>
215
216 <seglistitem>
217 <seg>Numerous <application>KDE</application> support programs:
218 artsmessage, checkXML, cupsdconf, cupsdoprint, dcop, dcopclient,
219 dcopfind, dcopidl, dcopidl2cpp, dcopidlng, dcopobject, dcopquit,
220 dcopref, dcopserver, dcopserver_shutdown, dcopstart, filesharelist,
221 fileshareset, imagetops, kab2kabc, kaddprinterwizard, kbuildsycoca,
222 kcmshell, kconf_update, kconfig_compiler, kcookiejar, kde-config,
223 kde-menu, kded, kdeinit, kdeinit_shutdown, kdeinit_wrapper, kdesu_stub,
224 kdontchangethehostname, kdostartupconfig, kfile, kfmexec, kgrantpty,
225 khotnewstuff, kinstalltheme, kio_http_cache_cleaner, kio_uiserver,
226 kioexec, kioslave, klauncher, kmailservice, kpac_dhcp_helper,
227 ksendbugmail, kshell, kstartupconfig, ksvgtopng, ktelnetservice,
228 ktradertest, kunittestmodrunner, kwrapper, lnusertemp,
229 make_driver_db_cups, make_driver_db_lpr, makekdewidgets, meinproc,
230 preparetips, and start_kdeinit</seg>
231 <seg>Numerous <application>KDE</application> libraries and helper
232 modules</seg>
233 <seg>/etc/kde and the following subdirectories of &kde-dir;/:
234 include/{dnssd, dom, kabc, kate, kdeprint, kdesu, khexedit, kio, kjs,
235 kmdi, kmediaplayer, knewstuff, kparts, kresources, ksettings, kspell2,
236 ktexteditor, kunittest, libkmid}, lib/kde3, and share/{applications,
237 apps, autostart, config, doc, emoticons, icons, mimelnk, services} </seg>
238 </seglistitem>
239 </segmentedlist>
240
241 <variablelist>
242 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
243 <?dbfo list-presentation="list"?>
244 <?dbhtml list-presentation="table"?>
245
246 <varlistentry id="kdelib-programs">
247 <term>KDE Support Programs</term>
248 <listitem>
249 <para>are essential support programs needed by other
250 <application>KDE</application> applications.</para>
251 <indexterm zone="kdelibs kdelib-programs">
252 <primary sortas="b-kdelib-programs">KDE Support Programs</primary>
253 </indexterm>
254 </listitem>
255 </varlistentry>
256
257 <varlistentry id="kde-libraries">
258 <term>KDE Libraries</term>
259 <listitem>
260 <para>contain essential functions that are needed by
261 <application>KDE</application> applications.</para>
262 <indexterm zone="kdelibs kde-libraries">
263 <primary sortas="c-kde-libraries">kde-libraries</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 </variablelist>
269
270 <para>The number of programs and libraries installed by
271 <application>kdelibs</application> prohibits an explanation of each one
272 in this section. Instead, see the <ulink url="http://docs.kde.org/">KDE
273 Documentation</ulink>.</para>
274
275 </sect2>
276
277</sect1>
Note: See TracBrowser for help on using the repository browser.