source: archive/kde/core/kdelibs.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 6 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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