← Back to branch summary

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

« back to all changes in this revision

Viewing changes to docs/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:
docs/add-applications/C/add-applications.xml
 
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
<listitem><para>Commercial</para></listitem>
 
476
</itemizedlist>
 
477
</para>
 
478
 
 
479
<para>
 
480
The rationale used to determine which software goes into which category is based
 
481
on two factors:
 
482
</para>
 
483
 
 
484
<itemizedlist>
 
485
<listitem>
 
486
<para>
 
487
The level of support software development teams provide for a program
 
488
</para>
 
489
</listitem>
 
490
 
 
491
<listitem>
 
492
<para>
 
493
The level of compliance the program has to the <ulink
 
494
url="&ubuntu-philosophy;">Free Software Philosophy</ulink>
 
495
</para>
 
496
</listitem>
 
497
</itemizedlist>
 
498
 
 
499
<para>
 
500
You can find more information about the Repositories available on the <ulink
 
501
url="http://www.ubuntu.com/ubuntu/components">Ubuntu website</ulink>.
 
502
</para>
 
503
 
 
504
<para>
 
505
The standard Kubuntu Install CD contains some software from the
 
506
<emphasis>Main</emphasis> and <emphasis>Restricted</emphasis> categories. Once
 
507
your system is made aware of the Internet-based locations for these
 
508
repositories, many more programs are made available for installation. Using the
 
509
software package management tools already installed on your system, you can
 
510
search for, install and update any piece of software directly over the Internet,
 
511
without the need for the CD.
 
512
</para>
 
513
 
 
514
</sect2>
 
515
 
 
516
 
 
517
<sect2 id="repos-addremove" status="complete">
 
518
<title>Adding or Removing Repositories</title>
 
519
 
 
520
<para>To enable extra repositories:</para>
 
521
 
 
522
<procedure>
 
523
<step>
 
524
<para>Start <application>Adept</application> by choosing &menuadept;.</para>
 
525
</step>
 
526
 
 
527
<step>
 
528
<para>
 
529
Select 
 
530
<menuchoice>
 
531
<guimenu>Adept</guimenu>
 
532
<guimenuitem>Manage Repositories</guimenuitem>
 
533
</menuchoice>
 
534
 in the <application>Adept</application> package manager window.
 
535
</para>
 
536
</step>
 
537
 
 
538
<step>
 
539
<para>
 
540
To add an extra repository, insert the repository information in the
 
541
<guilabel>New Repository:</guilabel> text box like <screen>deb
 
542
http://repository_location feisty main</screen> and then press the
 
543
<guibutton>Add</guibutton> button. To finalize your additions press the
 
544
<guibutton>Apply</guibutton> button and then the <guibutton>Close</guibutton>
 
545
button.
 
546
</para>
 
547
</step>
 
548
 
 
549
<step>
 
550
<para>
 
551
To remove a repository, select the repository you want to remove and then press
 
552
the <guibutton>Reset</guibutton> button. Once complete go ahead and press the
 
553
<guibutton>Close</guibutton> button.
 
554
</para>
 
555
</step>
 
556
</procedure>
 
557
 
 
558
</sect2>
 
559
 
 
560
</sect1>
 
561
 
 
562
<!-- UPDATES -->
 
563
<sect1 id="updating" status="complete">
 
564
<title>Updating</title>
 
565
 
 
566
<para>
 
567
Sometimes the Kubuntu developers release feature and security updates for
 
568
applications and packages within the Kubuntu system.
 
569
</para>
 
570
 
 
571
<para>
 
572
When these updates are available, Kubuntu will inform you with a red warning
 
573
icon in the system tray. To update your system, click the red button, enter your
 
574
password and click <guibutton>Fetch List of Updates</guibutton>.
 
575
</para>
 
576
 
 
577
<para>
 
578
The <application>Adept Updater</application> program will list the available
 
579
updates: to download and install these updates click <guibutton>Apply
 
580
Updates</guibutton>. Kubuntu will then download and install the available
 
581
updates from the Internet. 
 
582
</para>
 
583
 
 
584
<para>
 
585
When <application>Adept Updater</application> has finished updating your system,
 
586
close the pop-up window by clicking the <guibutton>Quit</guibutton> button.
 
587
</para>
 
588
 
 
589
<note>
 
590
<para>After installing some important updates, it may be necessary to
 
591
restart your computer. If so, Kubuntu will inform you with a pop up and an icon
 
592
in your system tray.
 
593
</para>
 
594
</note>
 
595
 
 
596
</sect1>
 
597
 
 
598
</article>