source: archive/kde/core/kdebase.xml

trunk
Last change on this file was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.
  • Property mode set to 100644
File size: 16.6 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 kdebase-download-http "&trinity-repo-http;/kdebase-&trinity-version;.tar.gz">
8 <!ENTITY kdebase-download-ftp "&trinity-repo-ftp;/kdebase-&trinity-version;.tar.gz">
9 <!ENTITY kdebase-md5sum "d1f7e1f94eeb46b981fe1ba144179840">
10 <!ENTITY kdebase-size "28.3 MB">
11 <!ENTITY kdebase-buildsize "179 MB">
12 <!ENTITY kdebase-time "6.6 SBU">
13]>
14
15<sect1 id="kdebase" xreflabel="kdebase-&trinity-version;">
16 <?dbhtml filename="kdebase.html"?>
17
18
19 <title>Kdebase-&trinity-version;</title>
20
21 <indexterm zone="kdebase">
22 <primary sortas="a-kdebase">Kdebase</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Kdebase</title>
27
28 <para><application>kdebase</application> is the last mandatory package
29 required for the <application>Trinity/KDE3 Desktop Environment</application>. It
30 provides various applications, infrastructure files and libraries.</para>
31
32 &lfs70_checked;
33
34 <bridgehead renderas="sect3">Package Information</bridgehead>
35 <itemizedlist spacing='compact'>
36 <listitem>
37 <para>Download (HTTP): <ulink url="&kdebase-download-http;"/></para>
38 </listitem>
39 <listitem>
40 <para>Download (FTP): <ulink url="&kdebase-download-ftp;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download MD5 sum: &kdebase-md5sum;</para>
44 </listitem>
45 <listitem>
46 <para>Download size: &kdebase-size;</para>
47 </listitem>
48 <listitem>
49 <para>Estimated disk space required: &kdebase-buildsize;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated build time: &kdebase-time;</para>
53 </listitem>
54 </itemizedlist>
55
56 <bridgehead renderas="sect3">Kdebase Dependencies</bridgehead>
57
58 <bridgehead renderas="sect4">Required</bridgehead>
59 <para role="required">
60 <xref linkend="kdelibs"/> and
61 <xref linkend="dbus-qt3"/>
62 </para>
63
64 <bridgehead renderas="sect4">Recommended</bridgehead>
65 <para role="recommended">
66 <xref linkend="aRts"/>,
67 <xref linkend="libart_lgpl"/>, and
68 <xref linkend="openssl"/>
69 </para>
70
71 <bridgehead renderas="sect4">Optional</bridgehead>
72 <para role="optional">
73 <xref linkend="cyrus-sasl"/>,
74 <ulink url="http://www.freedesktop.org/wiki/Software/hal">Hal</ulink>,
75 <xref linkend="libusb-compat"/>,
76 <xref linkend="linux-pam"/>,
77 <xref linkend="openldap"/>,
78 <xref linkend="samba"/>,
79 <xref linkend="sudo"/>,
80 <ulink url="http://www.openexr.com/">OpenEXR</ulink>, and
81 <ulink url="http://sourceforge.net/projects/libraw1394/">libraw1394</ulink>
82 </para>
83
84 <bridgehead renderas="sect4">Optional (for api documentation)</bridgehead>
85 <para role="optional">
86 <xref linkend="libxml2"/>,
87 <xref linkend="graphviz"/>, and
88 <xref linkend="doxygen"/>
89 </para>
90
91 <para condition="html" role="usernotes">User Notes:
92 <ulink url="&blfs-wiki;/kdebase"/></para>
93
94 </sect2>
95
96 <sect2 id="kdebase-runtime-dependencies"
97 xreflabel="KDE Base Runtime Dependencies">
98 <title>Run-Time Dependencies</title>
99
100 <para>Note that there are two additional packages you can install that
101 are used at run-time for <command>konqueror</command> ioslave protocols.
102 You can install the <ulink
103 url="http://mtools.linux.lu/?power-to-the-parliament">Mtools</ulink>
104 package to enable the <quote>floppy</quote> ioslave protocol. This will
105 allow easy access to the floppy disk drives on your system. The <ulink
106 url="http://packages.debian.org/stable/source/hfsplus">hfsplus</ulink>
107 package can be installed to access HFS+ partitions on a Mac OS system
108 using the <quote>mac</quote> ioslave.</para>
109
110 <para>One additional package that can be used at run time is <xref
111 linkend="pciutils"/>. This enables the <application>KDE Info
112 Center</application> to use <application>lspci</application> for its "pci"
113 info section.</para>
114
115 <para>Another package usable at run time is <ulink
116 url="http://www.htdig.org">htdig</ulink>. The enables <command>
117 khelpcenter</command> to create a search index for the KDE application
118 manuals.</para>
119 </sect2>
120
121 <sect2 role="installation">
122 <title>Installation of Kdebase</title>
123
124 <para>Install <application>kdebase</application> with:</para>
125
126<screen><userinput>MAKEDIR=/tmp/buildbase &amp;&amp;
127KDEBASE=`pwd` &amp;&amp;
128rm -rf $MAKEDIR &amp;&amp;
129mkdir -p $MAKEDIR &amp;&amp;
130cd $MAKEDIR &amp;&amp;
131
132cmake -DCMAKE_INSTALL_PREFIX=$TRINITY_PREFIX \
133 -DCMAKE_VERBOSE_MAKEFILE=ON \
134 -DWITH_ARTS=ON \
135 -DWITH_SHADOW=ON \
136 -DWITH_XCURSOR=ON \
137 -DWITH_XFIXES=ON \
138 -DWITH_XRANDR=ON \
139 -DWITH_XRENDER=ON \
140 -DWITH_XDAMAGE=ON \
141 -DWITH_XEXT=ON \
142 -DWITH_XDMCP=ON \
143 -DWITH_XINERAMA=ON \
144 -DWITH_SAMBA=ON \
145 -DWITH_LIBUSB=ON \
146 -DWITH_SUDO_KDESU_BACKEND=ON \
147 -DBUILD_ALL=ON \
148 -DWITH_XCOMPOSITE=ON \
149 $KDEBASE &amp;&amp;
150
151unset KDEBASE MAKEDIR</userinput></screen>
152
153 <para>Some of the optional support programs for <application>kdebase</application>
154 must be specified by the user. The option is in the form "-DWITH_PKG=ON" and
155 the following options are recognozed for 'PKG': , SAMBA, LIBUSB,
156 SUDO_KDESU_BACKEND, LDAP, OPENEXR, SASL, LIBRAW1394, HAL, PAM, and I8K (Dell
157 Laptop Extensions).</para>
158
159 <para>The <userinput>cmake</userinput> step does not pick up all the required
160 libraries and paths. One special problem is that libtirpc.so is required
161 for nfs and is not detected. Fix these problems with:</para>
162
163<screen><userinput>export LIBRARY_PATH=$XORG_PREFIX/lib:/lib &amp;&amp;
164find -name link.txt -exec sed -i -e "s@-lICE@&amp; -lX11 -lXrender -ltirpc@" {} \;</userinput></screen>
165
166 <para>Now, continue with the build:</para>
167
168<screen><userinput>make</userinput></screen>
169
170 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
171 href="../../xincludes/kde-apidocs.xml"/>
172
173 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
174
175<screen role='root'><userinput>make install</userinput></screen>
176
177 </sect2>
178
179 <sect2 role="configuration">
180 <title>Configuring Kdebase</title>
181
182 <sect3><title>Configuration Information</title>
183
184 <para>There is no real configuration necessary for this package other
185 than to ensure you follow the steps outlined in the last section of
186 this chapter, <xref linkend="kde-core-config"/>.</para>
187
188 </sect3>
189
190 </sect2>
191
192 <sect2 role="content">
193 <title>Contents</title>
194
195 <segmentedlist>
196 <segtitle>Installed Programs</segtitle>
197 <segtitle>Installed Libraries</segtitle>
198 <segtitle>Installed Directories</segtitle>
199
200 <seglistitem>
201 <seg>appletproxy, drkonqi, extensionproxy, genkdmconf, kaccess,
202 kappfinder, kapplymousetheme, kasbar, kate, kblankscrn.kss,
203 kbookmarkmerger, kcheckpass, kcheckrunning, kcminit, kcminit_startup,
204 kcontrol, kcontroledit, kdcop, kdebugdialog, kdeeject, kdeinstallktheme,
205 kdepasswd, kdeprintfax, kdesktop, kdesktop_lock, kdesu, kdesud, kdialog,
206 kdm, kdm_config, kdm_greet, kdmctl, keditbookmarks, keditfiletype,
207 kfind, kfmclient, kfontinst, kfontview, khc_docbookdig.pl, khc_htdig.pl,
208 khc_htsearch.pl, khc_indexbuilder, khc_mansearch.pl, khelpcenter,
209 khotkeys, kicker, kinfocenter (link to kcontrol), kio_media_mounthelper,
210 kio_system_documenthelper, kjobviewer, klipper,
211 klocaldomainurifilterhelper, kmenuedit, knetattach, kompmgr, konqueror,
212 konsole, kpager, kpersonalizer, kpm, kprinter, krandom.kss, krandrtray,
213 krdb, kreadconfig, krootimage, ksmserver, ksplash, ksplashsimple, kstart,
214 ksysguard, ksysguardd, ksystraycmd, ktip, ktrash, kwebdesktop, kwin,
215 kwin_killer_helper, kwin_rules_dialog, kwrite, kwriteconfig, kxkb,
216 nspluginscan, nspluginviewer, and startkde</seg>
217 <seg>Numerous KDE support libraries, helper modules, and kioslaves</seg>
218 <seg>/etc/xdg/menus/applications-merged and the following subdirectories
219 of &kde-dir;/: include/{kate, ksgrd, ksplash, kwin},
220 lib/kconf_update_bin, share/{applnk, apps/{too many to list},
221 config, config.kcfg, desktop-directories, doc/kdm, fonts,
222 /mimelnk/{fonts, media, print}, services/{searchproviders,
223 useragentstrings}, sounds, templates, wallpapers, and /var/lib/kdm</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="kate">
233 <term><command>kate</command></term>
234 <listitem>
235 <para> is a programmer's text editor for <application>KDE</application>.</para>
236 <indexterm zone="kdebase kate">
237 <primary sortas="b-kate">kate</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="kcontrol">
243 <term><command>kcontrol</command></term>
244 <listitem>
245 <para> is the <application>KDE</application> Control Center.</para>
246 <indexterm zone="kdebase kcontrol">
247 <primary sortas="b-kcontrol">kcontrol</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="kdebugdialog">
253 <term><command>kdebugdialog</command></term>
254 <listitem>
255 <para>is a dialog box for managing diagnostic messages at runtime.</para>
256 <indexterm zone="kdebase kdebugdialog">
257 <primary sortas="b-kdebugdialog">kdebugdialog</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="kdesu">
263 <term><command>kdesu</command></term>
264 <listitem>
265 <para>is a graphical front end for the Unix
266 <command>su</command> command.</para>
267 <indexterm zone="kdebase kdesu">
268 <primary sortas="b-kdesu">kdesu</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="kdm">
274 <term><command>kdm</command></term>
275 <listitem>
276 <para>is the <application>KDE</application> display manager
277 (a replacement for <command>xdm</command>).</para>
278 <indexterm zone="kdebase kdm">
279 <primary sortas="b-kdm">kdm</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="kfind">
285 <term><command>kfind</command></term>
286 <listitem>
287 <para>is a utility to find files.</para>
288 <indexterm zone="kdebase kfind">
289 <primary sortas="b-kfind">kfind</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="khelpcenter">
295 <term><command>khelpcenter</command></term>
296 <listitem>
297 <para>is the <application>KDE</application> help tool.</para>
298 <indexterm zone="kdebase khelpcenter">
299 <primary sortas="b-khelpcenter">khelpcenter</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="kicker">
305 <term><command>kicker</command></term>
306 <listitem>
307 <para>is the <application>KDE</application> control panel.</para>
308 <indexterm zone="kdebase kicker">
309 <primary sortas="b-kicker">kicker</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="kinfocenter">
315 <term><command>kinfocenter</command></term>
316 <listitem>
317 <para>provides a centralized and convenient overview of your
318 <application>KDE</application> and system settings.</para>
319 <indexterm zone="kdebase kinfocenter">
320 <primary sortas="b-kinfocenter">kinfocenter</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="kioslaves">
326 <term>kioslaves</term>
327 <listitem>
328 <para>are support modules designed to be intimately familiar with a
329 certain protocol, so that a standard interface (most often these are
330 used by <command>konqueror</command>) can be used to get at data from
331 any number of places. Examples are the http and ftp kioslaves,
332 which will retrieve data from an http or ftp server respectively.</para>
333 <indexterm zone="kdebase kioslaves">
334 <primary sortas="c-kioslaves">kioslaves</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 <varlistentry id="klipper">
340 <term><command>klipper</command></term>
341 <listitem>
342 <para> is a clipboard utility.</para>
343 <indexterm zone="kdebase klipper">
344 <primary sortas="b-klipper">klipper</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="kmenuedit">
350 <term><command>kmenuedit</command></term>
351 <listitem>
352 <para>is a utility to rearrange or add items to the K-menu.</para>
353 <indexterm zone="kdebase kmenuedit">
354 <primary sortas="b-kmenuedit">kmenuedit</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="konqueror">
360 <term><command>konqueror</command></term>
361 <listitem>
362 <para>is a filesystem and web browser.</para>
363 <indexterm zone="kdebase konqueror">
364 <primary sortas="b-konqueror">konqueror</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="konsole">
370 <term><command>konsole</command></term>
371 <listitem>
372 <para>is a highly configurable <application>X</application>
373 terminal emulator.</para>
374 <indexterm zone="kdebase konsole">
375 <primary sortas="b-konsole">konsole</primary>
376 </indexterm>
377 </listitem>
378 </varlistentry>
379
380 <varlistentry id="kpager">
381 <term><command>kpager</command></term>
382 <listitem>
383 <para>provides a thumbnail view of all virtual desktops.</para>
384 <indexterm zone="kdebase kpager">
385 <primary sortas="b-kpager">kpager</primary>
386 </indexterm>
387 </listitem>
388 </varlistentry>
389
390 <varlistentry id="kprinter">
391 <term><command>kprinter</command></term>
392 <listitem>
393 <para>is the printing module in <application>KDE</application>. It
394 manages the actual printing from <application>KDE</application>
395 applications. It handles print job administration and handles printer and
396 print system management.</para>
397 <indexterm zone="kdebase kprinter">
398 <primary sortas="b-kprinter">kprinter</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 <varlistentry id="ksplash">
404 <term><command>ksplash</command></term>
405 <listitem>
406 <para>is a splash screen that shows the progress of an application
407 that is loading.</para>
408 <indexterm zone="kdebase ksplash">
409 <primary sortas="b-ksplash">ksplash</primary>
410 </indexterm>
411 </listitem>
412 </varlistentry>
413
414 <varlistentry id="ksysguard">
415 <term><command>ksysguard</command></term>
416 <listitem>
417 <para>is a network enabled task manager and system monitor application,
418 with the additional functionality of <command>top</command>.</para>
419 <indexterm zone="kdebase ksysguard">
420 <primary sortas="b-ksysguard">ksysguard</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="kwrite">
426 <term><command>kwrite</command></term>
427 <listitem>
428 <para>is a text editor for <application>KDE</application>.</para>
429 <indexterm zone="kdebase kwrite">
430 <primary sortas="b-kwrite">kwrite</primary>
431 </indexterm>
432 </listitem>
433 </varlistentry>
434
435 <varlistentry id="kxkb">
436 <term><command>kxkb</command></term>
437 <listitem>
438 <para>is a keyboard layout switching utility based on the X11 xkb
439 extension.</para>
440 <indexterm zone="kdebase kxkb">
441 <primary sortas="b-kxkb">kxkb</primary>
442 </indexterm>
443 </listitem>
444 </varlistentry>
445
446 </variablelist>
447
448 </sect2>
449
450</sect1>
Note: See TracBrowser for help on using the repository browser.