~ubuntu-branches/ubuntu/maverick/kubuntu-docs/maverick

« back to all changes in this revision

Viewing changes to kubuntu/add-applications/C/add-applications.xml

  • Committer: Bazaar Package Importer
  • Author(s): Richard A. Johnson
  • Date: 2008-08-18 10:49:14 UTC
  • Revision ID: james.westby@ubuntu.com-20080818104914-83r2er2hsmdp2o0l
Tags: 8.10-2
* Restructured kubuntu documentation package
  - Refer to the NEWS text located in the root directory of the package
* Removed the Firefox start page files
* debian/rules: updated to remove firefox files
* debian/control: removed perl deps due to removal of firefox files, bumped
  version to 3.8.0, updated kdelibs-data dep to kdelibs5-data

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<?xml version="1.0" encoding="UTF-8"?>
2
 
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 
3
 
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4
 
<!ENTITY % globalent SYSTEM "../../../libs/global.ent">
5
 
%globalent;
6
 
<!ENTITY % cdo-C SYSTEM "../../../libs/cdo-C.ent">
7
 
%cdo-C;
8
 
<!ENTITY % kde SYSTEM "../../libs/kde.ent">
9
 
%kde;
10
 
<!ENTITY % kde-menus-C SYSTEM "../../libs/kde-menus-C.ent">
11
 
%kde-menus-C;
12
 
<!ENTITY % kde-general SYSTEM "/usr/share/apps/ksgmltools2/customization/obsolete/general.entities">
13
 
%kde-general;
14
 
<!ENTITY % xinclude SYSTEM "../../../libs/xinclude.mod">
15
 
%xinclude;
16
 
<!ENTITY language "en">
17
 
]>
18
 
<article id="add-applications" status="complete">
19
 
<articleinfo>
20
 
<title>Adding, Removing and Updating Applications</title>
21
 
&klegalnotice;
22
 
<abstract>
23
 
<para>
24
 
This chapter is a complete guide to adding, removing and updating
25
 
applications on a Kubuntu system.
26
 
</para>
27
 
</abstract>
28
 
</articleinfo>
29
 
 
30
 
<note>
31
 
<title>Universe and Multiverse Repositories by Default</title>
32
 
<para>
33
 
Now with Kubuntu &distro-rev; the <emphasis>Universe</emphasis> and
34
 
<emphasis>Multiverse</emphasis> repositories are enabled by default.
35
 
</para>
36
 
</note>
37
 
 
38
 
<!-- INTRODUCTION -->
39
 
<sect1 id="intro" status="complete">
40
 
<title>Introduction</title>
41
 
 
42
 
<para>
43
 
There are several ways to manage your applications in Kubuntu. In
44
 
order to add or remove applications you need to use a
45
 
<emphasis>package manager</emphasis>. The following package
46
 
managers are described in this chapter:
47
 
</para>
48
 
 
49
 
<variablelist>
50
 
<title>Graphical Clients</title>
51
 
<varlistentry>
52
 
<term><application>Add/Remove Programs</application></term>
53
 
<listitem>
54
 
<para>
55
 
(&menuar;) - The simplest way to add or remove programs.
56
 
</para>
57
 
</listitem>
58
 
</varlistentry>
59
 
 
60
 
<varlistentry>
61
 
<term><application>Adept</application></term>
62
 
<listitem>
63
 
<para>
64
 
(&menuadept;) -  A graphical program providing an advanced way of managing
65
 
programs.
66
 
</para>
67
 
</listitem>
68
 
</varlistentry>
69
 
</variablelist>
70
 
 
71
 
<variablelist>
72
 
<title>Command Line Utilities</title>
73
 
<varlistentry>
74
 
<term><application>apt</application></term>
75
 
<listitem>
76
 
<para>
77
 
(Advanced Package Tool) is a management system for software packages.
78
 
</para>
79
 
</listitem>
80
 
</varlistentry>
81
 
 
82
 
<varlistentry>
83
 
<term><application>Aptitude</application></term>
84
 
<listitem>
85
 
<para>
86
 
A text-based, high-level interface to <application>apt</application>.
87
 
</para>
88
 
</listitem>
89
 
</varlistentry>
90
 
</variablelist>
91
 
 
92
 
<para>
93
 
You may also wish to increase the number of programs available to
94
 
install through your package managers. Not all the programs that exist for
95
 
Kubuntu are installed by default.
96
 
</para>
97
 
 
98
 
<para>
99
 
Finally, this chapter explains how to update your system.
100
 
</para>
101
 
 
102
 
<note>
103
 
<para>
104
 
You can only have one package management application running at a time. For
105
 
example, if you are running <application>Add/Remove Programs</application> and
106
 
try to launch <application>Adept</application>, it will fail with an error.
107
 
Close the running application before you relaunch the new one.
108
 
</para>
109
 
</note>
110
 
 
111
 
</sect1>
112
 
 
113
 
<!-- ADD/REMOVE PROGRAMS -->
114
 
<sect1 id="addremove" status="complete">
115
 
<title>Add/Remove Programs</title>
116
 
 
117
 
<para>
118
 
<application>Add/Remove Programs</application> is a simple graphical way of
119
 
installing and removing applications in Kubuntu. To launch
120
 
<application>Add/Remove Programs</application>, choose &menuar; from the desktop
121
 
menu system.
122
 
</para>
123
 
 
124
 
<note>
125
 
<para>
126
 
Running <application>Add/Remove Programs</application> requires administrative
127
 
privileges.
128
 
</para>
129
 
</note>
130
 
 
131
 
<para>
132
 
To install new applications select the category on the left, then check the box
133
 
of the applications you want to install. Click <guimenu>Apply</guimenu> and your
134
 
chosen programs will be downloaded and installed automatically, as well as
135
 
installing any additional applications that are required. The default selection
136
 
is restricted to the KDE suite, but GNOME applications can be installed by
137
 
selecting them from the dropdown menu at the top. 
138
 
</para>
139
 
 
140
 
<para>
141
 
Alternatively, if you know the name of the program you want, use the
142
 
<guibutton>Search</guibutton> tool at the top.
143
 
</para>
144
 
 
145
 
</sect1>
146
 
 
147
 
<!-- ADEPT -->
148
 
<sect1 id="adept" status="complete">
149
 
<title>Adept Package Manager</title>
150
 
 
151
 
<para>
152
 
&appshort; is a graphical frontend to the <application>APT</application> package
153
 
management system for the K Desktop Environment (KDE).  &appshort; provides an
154
 
easy-to-use interface with which users can perform software management
155
 
operations.
156
 
</para>
157
 
 
158
 
<variablelist>
159
 
<title>Starting &appshort;</title>
160
 
<varlistentry><term>From KMenu</term>
161
 
<listitem>
162
 
<para>
163
 
Go to &menuadept;. When prompted for a password type your user password and
164
 
press <guibutton>OK</guibutton>.
165
 
</para>
166
 
</listitem>
167
 
</varlistentry>
168
 
 
169
 
<varlistentry><term>From the command line</term>
170
 
<listitem>
171
 
<para>
172
 
From the command line type <userinput>kdesu adept_manager</userinput> and press
173
 
<keycap>Enter</keycap>. When prompted for a password type your user password
174
 
and press <guibutton>OK</guibutton>.
175
 
</para>
176
 
</listitem>
177
 
</varlistentry>
178
 
</variablelist>
179
 
 
180
 
<para>
181
 
Both methods require that you enter your password. This will run &appshort; with
182
 
root privileges which will be required in order to perform the requested
183
 
operations. It is therefore advised that you use &appshort; with caution since
184
 
improper usage could lead to the removal, deletion, or corruption of software
185
 
packages that are required to preserve system integrity.
186
 
</para>
187
 
 
188
 
<procedure>
189
 
<title>Installing an application using the Adept Manager</title>
190
 
<step>
191
 
<para>
192
 
From within the <application>Adept Manager</application> utilize the
193
 
<guilabel>Search</guilabel> text box underneath the toolbar by typing in what
194
 
you are searching for.
195
 
</para>
196
 
</step>
197
 
 
198
 
<step>
199
 
<para>
200
 
Once you have located the application you wish to install, select the package
201
 
and press the <guibutton>Request Install</guibutton> button. You can also
202
 
<mousebutton>right</mousebutton> click on the package and select
203
 
<guilabel>Request Install</guilabel> from the menu.
204
 
</para>
205
 
</step>
206
 
 
207
 
<step>
208
 
<para>
209
 
When you have the application(s) selected for installation, press the
210
 
<guibutton>Apply Changes</guibutton> button in the toolbar.
211
 
</para>
212
 
</step>
213
 
 
214
 
<step>
215
 
<para>
216
 
After installation has completed close <application>Adept Manager</application>.
217
 
</para>
218
 
</step>
219
 
</procedure>
220
 
 
221
 
</sect1>
222
 
 
223
 
<!-- APT -->
224
 
<sect1 id="apt" status="complete">
225
 
<title>APT</title>
226
 
 
227
 
<para>
228
 
<application>APT</application> (Advanced Packaging Tool) is a powerful package
229
 
management system, on which the graphical programs <application>Add/Remove
230
 
Programs</application> and <application>Adept</application> are based.
231
 
<application>APT</application> automatically handles dependencies and performs
232
 
other operations on system packages to allow the installation of the desired
233
 
packages.
234
 
</para>
235
 
 
236
 
<note>
237
 
<para>
238
 
Running <application>APT</application> requires administrative privileges.
239
 
</para>
240
 
</note>
241
 
 
242
 
<para>
243
 
Some common commands that can be used with <application>APT</application>:
244
 
</para>
245
 
 
246
 
<itemizedlist>
247
 
<listitem>
248
 
<para>
249
 
Install packages:
250
 
<screen>sudo apt-get install <emphasis>packagename</emphasis></screen>
251
 
</para>
252
 
</listitem>
253
 
 
254
 
<listitem>
255
 
<para>
256
 
Remove packages:
257
 
<screen>sudo apt-get remove <emphasis>packagename</emphasis></screen>
258
 
</para>
259
 
</listitem>
260
 
 
261
 
<listitem>
262
 
<para>
263
 
Search for packages:
264
 
<screen>apt-cache search <emphasis>keyword</emphasis></screen>
265
 
</para>
266
 
</listitem>
267
 
 
268
 
<listitem>
269
 
<para>
270
 
Retrieve new lists of available packages:
271
 
<screen>sudo apt-get update</screen>
272
 
</para>
273
 
</listitem>
274
 
 
275
 
<listitem>
276
 
<para>
277
 
Upgrade system with available updates:
278
 
<screen>sudo apt-get dist-upgrade</screen>
279
 
</para>
280
 
</listitem>
281
 
 
282
 
<listitem>
283
 
<para>
284
 
List further commands and options:
285
 
<screen>apt-get help</screen>
286
 
</para>
287
 
</listitem>
288
 
</itemizedlist>
289
 
 
290
 
<tip>
291
 
<para>
292
 
For further information about the use of <application>APT</application>, you can
293
 
read the comprehensive <ulink url="&debian-apt;">Debian APT User Manual</ulink>.
294
 
</para>
295
 
</tip>
296
 
 
297
 
</sect1>
298
 
 
299
 
<!-- APTITUDE -->
300
 
<sect1 id="aptitude" status="complete">
301
 
<title>Aptitude</title>
302
 
 
303
 
<para>
304
 
<application>Aptitude</application> is another command line front end to
305
 
<application>apt</application>. <application>Aptitude</application> allows you
306
 
to interactively choose packages for removal or installation from a list of
307
 
available packages. <application>Aptitude</application> allows for a more
308
 
advanced approach and at times a more functional approach to managing
309
 
applications via the command line.
310
 
</para>
311
 
 
312
 
</sect1>
313
 
 
314
 
<!-- MANUAL INSTALLATION -->
315
 
<sect1 id="manual-install" status="complete">
316
 
<title>Manual Installation</title>
317
 
 
318
 
<para>
319
 
Although the preferred method of installing programs is via the package managers
320
 
described in <xref linkend="add-applications"/>, you can also download and
321
 
install individual package files containing software. There are many different
322
 
kinds of Linux package files. Most of these are associated with the package
323
 
managers of specific Linux distributions. 
324
 
</para>
325
 
 
326
 
<para>
327
 
If you find a packaged application that you wish to install, it is recommended
328
 
that you check if there is a native Kubuntu package of the application available
329
 
through a package manager, and that you install that version instead. This
330
 
guarantees that the program is completely compatible with your system. If there
331
 
is no package available through the package manager, you can install it
332
 
manually. The installation procedure depends on the type of package file.
333
 
</para>
334
 
 
335
 
<sect2 id="debfile-install" status="complete">
336
 
<title>Install/Uninstall .deb files</title>
337
 
 
338
 
<para>
339
 
The package files associated with Kubuntu have the <emphasis>.deb</emphasis>
340
 
suffix because of Kubuntu's close relation to the Debian GNU/Linux distribution.
341
 
You can download and install individual <emphasis>.deb</emphasis> files. You
342
 
will need administrative privileges to do this.
343
 
</para>
344
 
 
345
 
<para>
346
 
To install a .deb file, simply <mousebutton>Left</mousebutton> click on the
347
 
.deb file to initiate the installation process. You will be prompted for your
348
 
password in order to gain the necessary privileges.
349
 
</para>
350
 
 
351
 
</sect2>
352
 
 
353
 
<sect2 id="alien" status="complete">
354
 
<title>Convert .rpm files to .deb files</title>
355
 
 
356
 
<para>
357
 
Another type of package files is Red Hat Package
358
 
Manager Files which have the <emphasis>.rpm</emphasis>
359
 
suffix. It is not recommended to install these on an
360
 
Kubuntu system. In almost all cases, a native Kubuntu
361
 
<emphasis>.deb</emphasis> package is available.
362
 
However, if absolutely necessary, an
363
 
<emphasis>.rpm</emphasis> file can be converted to a
364
 
<emphasis>.deb</emphasis> package using the program
365
 
<application>alien</application>.
366
 
</para>
367
 
 
368
 
<procedure>
369
 
<title>Installation of Alien</title>
370
 
<step>
371
 
<para>
372
 
Open <application>Adept Manager</application> by going to &menuadept;.
373
 
</para>
374
 
</step>
375
 
 
376
 
<step>
377
 
<para>
378
 
When prompted to enter a password, enter your user password and press
379
 
<guibutton>OK</guibutton>.
380
 
</para>
381
 
</step>
382
 
 
383
 
<step>
384
 
<para>
385
 
Locate the <guilabel>Search</guilabel> box just under the buttons at the top of
386
 
the window and type <userinput>alien</userinput>.
387
 
</para>
388
 
</step>
389
 
 
390
 
<step>
391
 
<para>
392
 
Locate the package named <application>alien</application> and
393
 
select it. Press the <guibutton>Request Install</guibutton> button.
394
 
</para>
395
 
</step>
396
 
 
397
 
<step>
398
 
<para>
399
 
Locate the the <guibutton>Apply Changes</guibutton> button in the top toolbar
400
 
and press it.
401
 
</para>
402
 
</step>
403
 
 
404
 
<step>
405
 
<para>
406
 
Once the installation has completed close <application>Adept
407
 
Manager</application>.
408
 
</para>
409
 
</step>
410
 
</procedure>
411
 
 
412
 
<procedure>
413
 
<title>Using alien</title>
414
 
 
415
 
<step>
416
 
<para>
417
 
Open <application>Konsole</application> by going to &menukonsole;.
418
 
</para>
419
 
</step>
420
 
 
421
 
<step>
422
 
<para>
423
 
At the command prompt type <userinput>sudo alien package_file.rpm</userinput>
424
 
and press the <keycap>Enter</keycap> key.
425
 
</para>
426
 
</step>
427
 
 
428
 
<step>
429
 
<para>
430
 
For more information on <application>alien</application>, type <userinput>man
431
 
alien</userinput> at the command prompt. When complete, press
432
 
<keycap>q</keycap>.
433
 
</para>
434
 
</step>
435
 
</procedure>
436
 
 
437
 
</sect2>
438
 
 
439
 
<sect2 id="tarball-install" status="complete">
440
 
<title>Install from Source</title>
441
 
 
442
 
<para>
443
 
Files with the <emphasis>.tar.gz</emphasis> or <emphasis>.tar.bz2</emphasis>
444
 
suffix are package files known as <emphasis>tarballs</emphasis> or
445
 
<emphasis>source</emphasis> packages which are widely used in Linux. If there is
446
 
no native Kubuntu package available in any of the Kubuntu repositories, you can
447
 
try to compile the package from source. For tips on compiling software, look at
448
 
the <ulink url="https://wiki.ubuntu.com/CompilingSoftware">Compiling
449
 
Software</ulink> page on the Ubuntu Wiki.
450
 
</para>
451
 
 
452
 
</sect2>
453
 
</sect1>
454
 
 
455
 
<!-- EXTRA REPOSITORIES -->
456
 
<sect1 id="repos" status="complete">
457
 
<title>Managing Repositories</title>
458
 
 
459
 
<sect2 id="repos-info" status="complete">
460
 
<title>What are Repositories?</title>
461
 
 
462
 
<para>
463
 
There are thousands of programs freely available to install on Kubuntu. These
464
 
programs are stored in software archives (<emphasis>repositories</emphasis>) and
465
 
are made available for installation over the Internet. This makes it very easy
466
 
to install new programs in Kubuntu, and it is also very secure, because each
467
 
program you install is built specially for Kubuntu and checked before it is
468
 
installed. To organize the software, Kubuntu repositories are categorized
469
 
into four groups:
470
 
<itemizedlist>
471
 
<listitem><para>Main</para></listitem>
472
 
<listitem><para>Restricted</para></listitem>
473
 
<listitem><para>Universe</para></listitem>
474
 
<listitem><para>Multiverse</para></listitem>
475
 
</itemizedlist>
476
 
</para>
477
 
 
478
 
<para>
479
 
The rationale used to determine which software goes into which category is based
480
 
on two factors:
481
 
</para>
482
 
 
483
 
<itemizedlist>
484
 
<listitem>
485
 
<para>
486
 
The level of support software development teams provide for a program
487
 
</para>
488
 
</listitem>
489
 
 
490
 
<listitem>
491
 
<para>
492
 
The level of compliance the program has to the <ulink
493
 
url="&ubuntu-philosophy;">Free Software Philosophy</ulink>
494
 
</para>
495
 
</listitem>
496
 
</itemizedlist>
497
 
 
498
 
<para>
499
 
You can find more information about the Repositories available on the <ulink
500
 
url="http://www.ubuntu.com/ubuntu/components">Ubuntu website</ulink>.
501
 
</para>
502
 
 
503
 
<para>
504
 
The standard Kubuntu Install CD contains some software from the
505
 
<emphasis>Main</emphasis> and <emphasis>Restricted</emphasis> categories. Once
506
 
your system is made aware of the Internet-based locations for these
507
 
repositories, many more programs are made available for installation. Using the
508
 
software package management tools already installed on your system, you can
509
 
search for, install and update any piece of software directly over the Internet,
510
 
without the need for the CD.
511
 
</para>
512
 
 
513
 
</sect2>
514
 
 
515
 
 
516
 
<sect2 id="repos-addremove" status="complete">
517
 
<title>Adding or Removing Repositories</title>
518
 
 
519
 
<para>To enable extra repositories:</para>
520
 
 
521
 
<procedure>
522
 
<step>
523
 
<para>Start <application>Adept</application> by choosing &menuadept;.</para>
524
 
</step>
525
 
 
526
 
<step>
527
 
<para>
528
 
Select 
529
 
<menuchoice>
530
 
<guimenu>Adept</guimenu>
531
 
<guimenuitem>Manage Repositories</guimenuitem>
532
 
</menuchoice>
533
 
 in the <application>Adept</application> package manager window.
534
 
</para>
535
 
</step>
536
 
 
537
 
<step>
538
 
<para>
539
 
To add an extra repository, insert the repository information in the
540
 
<guilabel>New Repository:</guilabel> text box like <screen>deb
541
 
http://repository_location feisty main</screen> and then press the
542
 
<guibutton>Add</guibutton> button. To finalize your additions press the
543
 
<guibutton>Apply</guibutton> button and then the <guibutton>Close</guibutton>
544
 
button.
545
 
</para>
546
 
</step>
547
 
 
548
 
<step>
549
 
<para>
550
 
To remove a repository, select the repository you want to remove and then press
551
 
the <guibutton>Reset</guibutton> button. Once complete go ahead and press the
552
 
<guibutton>Close</guibutton> button.
553
 
</para>
554
 
</step>
555
 
</procedure>
556
 
 
557
 
</sect2>
558
 
 
559
 
</sect1>
560
 
 
561
 
<!-- UPDATES -->
562
 
<sect1 id="updating" status="complete">
563
 
<title>Updating</title>
564
 
 
565
 
<para>
566
 
Sometimes the Kubuntu developers release feature and security updates for
567
 
applications and packages within the Kubuntu system.
568
 
</para>
569
 
 
570
 
<para>
571
 
When these updates are available, Kubuntu will inform you with a red warning
572
 
icon in the system tray. To update your system, click the red button, enter your
573
 
password and click <guibutton>Fetch List of Updates</guibutton>.
574
 
</para>
575
 
 
576
 
<para>
577
 
The <application>Adept Updater</application> program will list the available
578
 
updates: to download and install these updates click <guibutton>Apply
579
 
Updates</guibutton>. Kubuntu will then download and install the available
580
 
updates from the Internet. 
581
 
</para>
582
 
 
583
 
<para>
584
 
When <application>Adept Updater</application> has finished updating your system,
585
 
close the pop-up window by clicking the <guibutton>Quit</guibutton> button.
586
 
</para>
587
 
 
588
 
<note>
589
 
<para>After installing some important updates, it may be necessary to
590
 
restart your computer. If so, Kubuntu will inform you with a pop up and an icon
591
 
in your system tray.
592
 
</para>
593
 
</note>
594
 
 
595
 
</sect1>
596
 
 
597
 
</article>