← Back to branch summary

~ubuntu-core-dev/synaptic/ubuntu

« back to all changes in this revision

Viewing changes to help/C/synaptic.xml

  • Committer: Michael Terry
  • Date: 2011-09-26 16:30:35 UTC
  • Revision ID: michael.terry@canonical.com-20110926163035-bck8ol261ksu1gmi
move to lp:ubuntu/synaptic

Show diffs side-by-side

added added

removed removed

Lines of Context:
help/C/synaptic.xml
1
 
<?xml version="1.0"?>
2
 
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
3
 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4
 
<!ENTITY legal SYSTEM "gpl.xml">
5
 
<!ENTITY appversion "0.53">
6
 
<!ENTITY app "<application>Synaptic Package Manager</application>">
7
 
<!ENTITY manrevision "0.1.2">
8
 
<!ENTITY date "October 2003">
9
 
]>
10
 
<!-- =============Document Header ============================= -->
11
 
<article id="index" lang="en">
12
 
<!-- please do not change the id; for translations, change lang to -->
13
 
<!-- appropriate code -->
14
 
<articleinfo> 
15
 
<title>&app; Manual V&manrevision;</title>       
16
 
 
17
 
<copyright> 
18
 
        <year>2003,2004</year> 
19
 
        <holder>Sebastian Heinlein</holder> 
20
 
</copyright>
21
 
 
22
 
        <!-- translators: uncomment this:
23
 
 
24
 
<copyright>
25
 
        <year>2002</year>
26
 
        <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
27
 
</copyright>
28
 
 
29
 
-->
30
 
 
31
 
<authorgroup> 
32
 
        <author> 
33
 
                <firstname>Sebastian</firstname> 
34
 
                <surname>Heinlein</surname> 
35
 
        </author>
36
 
</authorgroup>
37
 
 
38
 
<releaseinfo>
39
 
        This manual describes version &appversion; 
40
 
        of Synaptic Package Manager.
41
 
</releaseinfo> 
42
 
 
43
 
<legalnotice>
44
 
        <title>Legal Notice</title>     
45
 
        <para> 
46
 
                This document is distributed under the terms of the GNU
47
 
                Public license as published by the Free Software; either version 2 of the License, 
48
 
                or (at your option) later version. A copy of this license can be found in
49
 
                , or in the file included with 
50
 
                the source code of this program. 
51
 
        </para>
52
 
</legalnotice>
53
 
 
54
 
<legalnotice> 
55
 
        <title>Feedback</title>
56
 
        <para>
57
 
                To report a bug or make a suggestion regarding 
58
 
                the &app; or this manual, use the bug report 
59
 
                system at <ulink url="http://www.nongnu.org/synaptic" 
60
 
                type="http">Synaptic Web</ulink>, contact the mailing list 
61
 
                <email>synaptic-devel@nongnu.org</email>
62
 
                join the IRC channel #synaptic on irc.freenode.org.
63
 
        </para>
64
 
        <!-- Translators may also add here feedback address for translation -->
65
 
 
66
 
</legalnotice> 
67
 
</articleinfo> 
68
 
 
69
 
<indexterm zone="index"> 
70
 
        <primary>Synaptic Package Manager</primary> 
71
 
</indexterm> 
72
 
<indexterm zone="index"> 
73
 
        <primary>Packages</primary>
74
 
</indexterm>
75
 
<indexterm zone="index"> 
76
 
        <primary>Software</primary>
77
 
</indexterm>
78
 
 
79
 
<sect1 id="synaptic-introduction"> 
80
 
        <title>Introduction</title> 
81
 
        <para>
82
 
                The &app; enables you to install software onto your computer and to manage the software, that is 
83
 
                already installed. The software is bundled in so called <emphasis>packages</emphasis>. A single 
84
 
                application can even exist of several packages: e.g. the <application>Mozilla Internet Suite</application> is packaged 
85
 
                to <emphasis>mozilla-browser</emphasis>, that contains the actual browser, and <emphasis>mozilla-mail
86
 
                </emphasis>, that contains the mail client (this example refers to Debian GNU/Linux and can be 
87
 
                different on your distribution). 
88
 
        </para>
89
 
        <para>
90
 
                Nearly all applications reuse the functionality of other applications or libraries 
91
 
                (libraries only provide functions to other libraries or applications and are no stand alone 
92
 
                applications) to avoid doubled efforts. So the most packages depend on other packages. The &app; resolves the <emphasis>
93
 
                dependencies</emphasis> for you automatically. 
94
 
        </para>
95
 
        <para>
96
 
                Technically the &app; is based on the package manager <application>APT</application> and provides functions, that are 
97
 
                similar to the ones of the command line tool <command>apt-get</command> in a graphical environment.
98
 
        </para>
99
 
        <para>
100
 
                In detail &app; provides the following features: 
101
 
 
102
 
                <itemizedlist>
103
 
                        <listitem>
104
 
                                <para>
105
 
                                        Install, remove, configure, upgrade and downgrade single and multiple packages.
106
 
                                </para>
107
 
                        </listitem>
108
 
                        <listitem>
109
 
                                <para>
110
 
                                        Upgrade your whole system.
111
 
                                </para>
112
 
                        </listitem>
113
 
                        <listitem>
114
 
                                <para>
115
 
                                        Manage package repositories.
116
 
                                </para>
117
 
                        </listitem>
118
 
                        <listitem>
119
 
                                <para>
120
 
                                        Search packages by name, description and several other attributes.
121
 
                                </para>
122
 
                        </listitem>
123
 
                        <listitem>
124
 
                                <para>
125
 
                                        Select packages by status, section, name or a custom filter.
126
 
                                </para>
127
 
                        </listitem>
128
 
                        <listitem>
129
 
                                <para>
130
 
                                         Sort packages by name, status, size or version.
131
 
                                </para>
132
 
                        </listitem>
133
 
                        <listitem>
134
 
                                <para>
135
 
                                        Browse all available online documentation related to a package.
136
 
                                </para>
137
 
                        </listitem>
138
 
                        <listitem>
139
 
                                <para>
140
 
                                        Lock packages to the current version.
141
 
                                </para>
142
 
                        </listitem>
143
 
                        <listitem>
144
 
                                <para>
145
 
                                        Force the installation of a specific package version.
146
 
                                </para>
147
 
                        </listitem>
148
 
                </itemizedlist>
149
 
        </para>
150
 
        <note>
151
 
                <para>
152
 
                        You need root rights to install or remove software packages on your computer.
153
 
                </para>
154
 
        </note>
155
 
 
156
 
        <para>
157
 
                You can start <application>&app;</application> in the 
158
 
                following ways:
159
 
 
160
 
        <variablelist>
161
 
                <varlistentry>
162
 
                        <term>
163
 
                                <guimenu>GNOME Applications</guimenu> menu
164
 
                        </term>
165
 
                        <listitem>
166
 
                                <para>
167
 
                                        Choose 
168
 
                                        <menuchoice>
169
 
                                        <guisubmenu>System Tools</guisubmenu>
170
 
                                        <guimenuitem>Synaptic Package Manager</guimenuitem>
171
 
                                        </menuchoice>. 
172
 
                                </para>
173
 
                        </listitem>
174
 
                </varlistentry>
175
 
                <varlistentry>
176
 
                        <term>KDE menu</term>
177
 
                        <listitem>
178
 
                                <para>
179
 
                                        Choose 
180
 
                                        <menuchoice>
181
 
                                        <guisubmenu>Settings</guisubmenu>
182
 
                                        <guisubmenu>Extra</guisubmenu>
183
 
                                        <guimenuitem>Synaptic Package Manager</guimenuitem>
184
 
                                        </menuchoice>. 
185
 
                                </para>
186
 
                        </listitem>
187
 
                </varlistentry>
188
 
                <varlistentry>
189
 
                        <term>Command line</term>
190
 
                        <listitem>
191
 
                                <para>
192
 
                                        To start <application>&app;
193
 
                                        </application>from a command line type the 
194
 
                                        following , then press <keycap>Return</keycap>:
195
 
                                </para>
196
 
                                <para> 
197
 
                                        <command>synaptic</command> 
198
 
                                </para> 
199
 
                        </listitem>
200
 
                </varlistentry>
201
 
        </variablelist>
202
 
        </para> 
203
 
 
204
 
        <caution>
205
 
                <para>
206
 
                        You can render your system unusable.
207
 
                </para>
208
 
                <para>
209
 
                        Synaptic allows you to perform changes on the core of your system.
210
 
                </para>
211
 
                <para>
212
 
                        Always use &app; with care.
213
 
                </para>
214
 
        </caution>
215
 
 
216
 
</sect1>
217
 
 
218
 
<sect1 id="synatpic-win"> 
219
 
        <title>Main Window</title> 
220
 
 
221
 
<sect2 id="synaptic-win-overview">
222
 
        <title>Overview</title>
223
 
        <para>
224
 
                When you start <application>&app;</application>, the 
225
 
                following window is displayed.
226
 
        </para>
227
 
 
228
 
        <figure id="mainwindow-fig"> 
229
 
                <title>&app; Start Up Window</title> 
230
 
                <screenshot> 
231
 
                        <mediaobject>
232
 
                                <imageobject>
233
 
                                        <imagedata fileref="figures/synaptic-start.png" 
234
 
                                        format="PNG"/> 
235
 
                                </imageobject>
236
 
                                <textobject> 
237
 
                                        <phrase>
238
 
                                        Shows &app; main window. Contains titlebar, 
239
 
                                        menubar, toolbar, display area, and
240
 
                                        scrollbars. Menubar contains File, View, 
241
 
                                        Settings, and Help menus. 
242
 
                                        </phrase> 
243
 
                                </textobject> 
244
 
                          </mediaobject> 
245
 
                </screenshot> 
246
 
        </figure>
247
 
 
248
 
        <table frame="topbot" id="table-synaptic-main">
249
 
                <title>&app; Window Components</title>
250
 
                <tgroup cols="2" colsep="0" rowsep="0">
251
 
                        <colspec colname="COLSPEC0" colwidth="30*"/>
252
 
                        <colspec colname="COLSPEC1" colwidth="70*"/>
253
 
                        <thead>
254
 
                                <row rowsep="1">
255
 
                                        <entry valign="top" align="left">
256
 
                                                Component
257
 
                                        </entry>
258
 
                                        <entry valign="top" align="left">
259
 
                                                Description
260
 
                                        </entry>
261
 
                                </row>
262
 
                        </thead>
263
 
                        <tbody>
264
 
                                <row>
265
 
                                        <entry valign="top">
266
 
                                                Menubar
267
 
                                        </entry>
268
 
                                        <entry valign="top">
269
 
                                                Contains menus that you can use to perform actions
270
 
                                                in &app;.
271
 
                                        </entry>
272
 
                                </row>
273
 
                                <row>
274
 
                                        <entry valign="top">
275
 
                                                Toolbar
276
 
                                        </entry>
277
 
                                        <entry valign="top">
278
 
                                                Provides main actions.
279
 
                                        </entry>
280
 
                                </row>
281
 
                                <row>
282
 
                                        <entry valign="top">Category selector</entry>
283
 
                                        <entry valign="top">
284
 
                                                Provides categories to narrow down the list of shown
285
 
                                                listed packages.
286
 
                                        </entry>
287
 
                                </row>
288
 
                                <row>
289
 
                                        <entry valign="top">Package list</entry>
290
 
                                        <entry valign="top">
291
 
                                                Lists known packages. The list
292
 
                                                can be narrowed down by using filters and categories.
293
 
                                        </entry>
294
 
                                </row>
295
 
                                <row>
296
 
                                        <entry valign="top">Description field</entry>
297
 
                                        <entry valign="top">
298
 
                                                Shows the description of the selected package.
299
 
                                        </entry>
300
 
                                </row>
301
 
                                <row>
302
 
                                        <entry valign="top">Statusbar</entry>
303
 
                                        <entry valign="top">
304
 
                                                Displays global informations about the status 
305
 
                                                of &app;.
306
 
                                        </entry>
307
 
                                </row>
308
 
                        </tbody>
309
 
                </tgroup>
310
 
        </table>
311
 
</sect2>
312
 
 
313
 
<sect2 id="synaptic-win-toolbar">
314
 
        <title>Toolbar</title>
315
 
        
316
 
        <figure>
317
 
                <title>&app; toolbar</title> 
318
 
                <screenshot> 
319
 
                        <mediaobject> 
320
 
                                <imageobject>
321
 
                                        <imagedata fileref="figures/synaptic-toolbar.png" 
322
 
                                                format="PNG"/> 
323
 
                                </imageobject>
324
 
                                <textobject> 
325
 
                                        <phrase>
326
 
                                                Shows the toolbar of the &app; main window
327
 
                                        </phrase>
328
 
                                </textobject> 
329
 
                        </mediaobject> 
330
 
                </screenshot> 
331
 
        </figure>
332
 
 
333
 
        <para>
334
 
                The toolbar provides the following actions:
335
 
        
336
 
                <variablelist>
337
 
                        <varlistentry>
338
 
                                <term>
339
 
                                        Reload
340
 
                                </term>
341
 
                                <listitem>
342
 
                                        <para>
343
 
                                                Reload the list of known packages.
344
 
                                        </para>
345
 
                                </listitem>
346
 
                        </varlistentry>
347
 
                        <varlistentry>
348
 
                                <term>
349
 
                                        Mark all Upgrades
350
 
                                </term>
351
 
                                <listitem>
352
 
                                        <para>
353
 
                                                Mark all possible and available upgrades.
354
 
                                        </para>
355
 
                                </listitem>
356
 
                        </varlistentry>
357
 
                        <varlistentry>
358
 
                                <term>
359
 
                                        Apply
360
 
                                </term>
361
 
                                <listitem>
362
 
                                        <para>
363
 
                                                Apply all marked changes.
364
 
                                        </para>
365
 
                                </listitem>
366
 
                        </varlistentry>
367
 
                        <varlistentry>
368
 
                                <term>
369
 
                                        Properties
370
 
                                </term>
371
 
                                <listitem>
372
 
                                        <para>
373
 
                                                Open the <xref linkend="synaptic-win-properties"/> dialog of the selected package.
374
 
                                        </para>
375
 
                                </listitem>
376
 
                        </varlistentry>
377
 
                        <varlistentry>
378
 
                                <term>
379
 
                                        Search
380
 
                                </term>
381
 
                                <listitem>
382
 
                                        <para>
383
 
                                                Open the package search dialog.
384
 
                                        </para>
385
 
                                </listitem>
386
 
                        </varlistentry>
387
 
                </variablelist>
388
 
        </para>
389
 
</sect2>
390
 
 
391
 
<sect2 id="synaptic-win-selector" xreflabel="category selector">
392
 
        <title>Category Selector</title>
393
 
        
394
 
        <para>
395
 
                The selector on the left side allows you to narrow down the packages, that are shown in the <xref linkend="synaptic-win-list"/>
396
 
                by categories.
397
 
        </para>
398
 
 
399
 
        <figure>
400
 
                <title>Category Selector</title> 
401
 
                <screenshot> 
402
 
                        <mediaobject> 
403
 
                                <imageobject>
404
 
                                        <imagedata fileref="figures/synaptic-categories.png" 
405
 
                                                format="PNG"/> 
406
 
                                </imageobject>
407
 
                                <textobject> 
408
 
                                        <phrase>
409
 
                                                Shows the category selector in the &app; main window.
410
 
                                        </phrase>
411
 
                                </textobject> 
412
 
                        </mediaobject> 
413
 
                </screenshot> 
414
 
        </figure>
415
 
 
416
 
        <para>
417
 
                The following categories are available:
418
 
                
419
 
                <variablelist>
420
 
                        <varlistentry>
421
 
                                <term>
422
 
                                        Sections
423
 
                                </term>
424
 
                                <listitem>
425
 
                                        <para>
426
 
                                                Show packages belonging to the
427
 
                                                selected section, only.
428
 
                                        </para>
429
 
                                </listitem>
430
 
                        </varlistentry>
431
 
                        <varlistentry>
432
 
                                <term>
433
 
                                        Status
434
 
                                </term>
435
 
                                <listitem>
436
 
                                        <para>
437
 
                                                Show packages of the
438
 
                                                selected status, only.
439
 
                                        </para>
440
 
                                </listitem>
441
 
                        </varlistentry>
442
 
                        <varlistentry>
443
 
                                <term>
444
 
                                        Alphabet
445
 
                                </term>
446
 
                                <listitem>
447
 
                                        <para>
448
 
                                                Show packages with the
449
 
                                                selected initial letter, only.
450
 
                                        </para>
451
 
                                </listitem>
452
 
                        </varlistentry>
453
 
                        <varlistentry>
454
 
                                <term>
455
 
                                        Filter
456
 
                                </term>
457
 
                                <listitem>
458
 
                                        <para>
459
 
                                                Show packages that fit to
460
 
                                                the selected custom criteria, only.
461
 
                                        </para>
462
 
                                </listitem>
463
 
                        </varlistentry>
464
 
                        <varlistentry>
465
 
                                <term>
466
 
                                        Search history
467
 
                                </term>
468
 
                                <listitem>
469
 
                                        <para>
470
 
                                                Show the results of the
471
 
                                                selected search, only.
472
 
                                        </para>
473
 
                                </listitem>
474
 
                        </varlistentry>
475
 
                </variablelist>
476
 
        </para>
477
 
</sect2>
478
 
 
479
 
 
480
 
<sect2 id="synaptic-win-list" xreflabel="package list">
481
 
        <title>Package List</title>
482
 
 
483
 
        <para>
484
 
                The package list shows the packages of the selected category.
485
 
        </para>
486
 
 
487
 
        <figure>
488
 
                <title>Package List</title> 
489
 
                <screenshot> 
490
 
                        <mediaobject> 
491
 
                                <imageobject>
492
 
                                        <imagedata fileref="figures/synaptic-packagelist.png" 
493
 
                                                format="PNG"/> 
494
 
                                </imageobject>
495
 
                                <textobject> 
496
 
                                        <phrase>
497
 
                                                Shows the package list in the &app; main window.
498
 
                                        </phrase>
499
 
                                </textobject> 
500
 
                        </mediaobject> 
501
 
                </screenshot> 
502
 
        </figure>
503
 
 
504
 
        <tip>
505
 
                <para>
506
 
                        The used status icons are explained in the icon legend. To open the legend choose 
507
 
                        <menuchoice><guimenu>Help</guimenu><guimenuitem>Icon Legend</guimenuitem></menuchoice>
508
 
                        from the menu.
509
 
                </para>
510
 
        </tip>
511
 
 
512
 
 
513
 
        <tip>
514
 
                <para>
515
 
                        The column order and the used colors can be changed in the preferences.
516
 
                </para> 
517
 
        </tip>
518
 
</sect2>
519
 
 
520
 
 
521
 
<sect2 id="synaptic-win-properties" xreflabel="properties">
522
 
        <title>Package Properties</title>
523
 
 
524
 
        <para>
525
 
                To open the properties dialog of a selected package:
526
 
                
527
 
                <itemizedlist>
528
 
                        <listitem>
529
 
                                <para>
530
 
                                        Choose <menuchoice><guimenu>Package</guimenu><guimenuitem>Properties</guimenuitem></menuchoice>
531
 
                                        from the menu
532
 
                                </para>
533
 
                        </listitem>
534
 
                        <listitem>
535
 
                                <para>
536
 
                                        Click on <guibutton>Properties</guibutton> in the toolbar
537
 
                                </para>
538
 
                        </listitem>
539
 
                        <listitem>
540
 
                                <para>
541
 
                                        Press the key combination <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>
542
 
                                </para>
543
 
                        </listitem>
544
 
                </itemizedlist>
545
 
        </para>
546
 
                
547
 
 
548
 
        <figure>
549
 
                <title>Package Properties Dialog</title> 
550
 
                <screenshot> 
551
 
                        <mediaobject> 
552
 
                                <imageobject>
553
 
                                        <imagedata fileref="figures/synaptic-packagedetails.png" 
554
 
                                                format="PNG"/> 
555
 
                                </imageobject>
556
 
                                <textobject> 
557
 
                                        <phrase>
558
 
                                                Shows the package details in the &app; main window.
559
 
                                        </phrase>
560
 
                                </textobject> 
561
 
                        </mediaobject> 
562
 
                </screenshot> 
563
 
        </figure>
564
 
 
565
 
        <para>
566
 
                The notebook provides the following tabs:
567
 
 
568
 
                <table frame="topbot" id="table-synaptic-propertiestabs">
569
 
                        <title>Tabs in the properties dialog</title>
570
 
                        <tgroup cols="2" colsep="0" rowsep="0">
571
 
                                <colspec colname="COLSPEC0" colwidth="30*"/>
572
 
                                <colspec colname="COLSPEC1" colwidth="70*"/>
573
 
                                <thead>
574
 
                                        <row rowsep="1">
575
 
                                                <entry valign="top" align="left">
576
 
                                                        Tab
577
 
                                                </entry>
578
 
                                                <entry valign="top" align="left">
579
 
                                                        Description
580
 
                                                </entry>
581
 
                                        </row>
582
 
                                </thead>
583
 
                                <tbody>
584
 
                                        <row>
585
 
                                                <entry valign="top">
586
 
                                                        Common
587
 
                                                </entry>
588
 
                                                <entry valign="top">
589
 
                                                        Shows basic information of the package: name, short description, maintainer, 
590
 
                                                        status, priority, tags <emphasis>(if supported)</emphasis> and version.
591
 
                                                </entry>
592
 
                                        </row>
593
 
                                        <row>
594
 
                                                <entry valign="top">
595
 
                                                        Description
596
 
                                                </entry>
597
 
                                                <entry valign="top">
598
 
                                                        Shows a long description of the package.
599
 
                                                </entry>
600
 
                                        </row>
601
 
                                        <row>
602
 
                                                <entry valign="top">
603
 
                                                        Dependencies
604
 
                                                </entry>
605
 
                                                <entry valign="top">
606
 
                                                        Lists required, depending, provided, suggested and recommended packages.
607
 
                                                </entry>
608
 
                                        </row>
609
 
                                </tbody>
610
 
                        </tgroup>
611
 
                </table>
612
 
        </para>
613
 
</sect2>
614
 
 
615
 
</sect1>
616
 
 
617
 
 
618
 
<!-- sect1 id="synaptic-browsefind"> 
619
 
 
620
 
NEEDS A REWRITE - SO DISABLED FOR 0.53
621
 
        <title>Browsing and Searching for Packages</title> 
622
 
 
623
 
        
624
 
<sect2 id="synaptic-browse">
625
 
        <title>
626
 
                To Browse the List of Known Packages (FIXME)
627
 
        </title>
628
 
        
629
 
        <para>
630
 
                &app; provides you with a central list of all known packages. This includes packages that are available, 
631
 
                installed or even broken. Because the most distributions contain many thousands packages, you can
632
 
                narrow down the list of shown packages. The following methods allow you to browse through the list
633
 
                of known packages:
634
 
        </para>
635
 
        
636
 
        <variablelist>
637
 
                <varlistentry>
638
 
                        <term>
639
 
                                The browser list
640
 
                        </term>
641
 
                        <listitem>
642
 
                                <para>
643
 
                                </para>
644
 
                        </listitem>
645
 
                </varlistentry>
646
 
                <varlistentry>
647
 
                        <term>
648
 
                                The filter
649
 
                        </term>
650
 
                        <listitem>
651
 
                                <para>
652
 
                                </para>
653
 
                        </listitem>
654
 
                </varlistentry>
655
 
                <varlistentry>
656
 
                        <term>
657
 
                                The find field
658
 
                        </term>
659
 
                        <listitem>
660
 
                                <para>
661
 
                                </para>
662
 
                        </listitem>
663
 
                </varlistentry>
664
 
        </variablelist>
665
 
</sect2>
666
 
 
667
 
 
668
 
<sect2 id="synaptic-find"> 
669
 
        <title>To Find and Browse Packages (FIXME)</title> 
670
 
 
671
 
        <anchor id="anchor-find" xreflabel="found"/>
672
 
 
673
 
 
674
 
<variablelist>
675
 
<varlistentry id="synaptic-pkg-find-quicksearch">
676
 
        <term>  
677
 
                To find a specific package
678
 
        </term>
679
 
        <listitem>
680
 
        <para>
681
 
                To find a specific package follow these steps:
682
 
        </para>
683
 
        <para>
684
 
        <orderedlist>
685
 
                <listitem>
686
 
                        <para>
687
 
                                Open the find dialog:
688
 
                                <itemizedlist>
689
 
                                        <listitem>
690
 
                                                <para>
691
 
                                                        Press the key combination
692
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>f</keycap>
693
 
                                                        </keycombo>.
694
 
                                                </para>
695
 
                                        </listitem>
696
 
                                        <listitem>
697
 
                                                <para>
698
 
                                                        Click on
699
 
                                                        <guilabel>Find</guilabel> in the toolbar.
700
 
                                                </para>
701
 
                                        </listitem>
702
 
                                        <listitem>
703
 
                                                <para>
704
 
                                                        Choose
705
 
                                                        <menuchoice><guimenu>Edit</guimenu><guimenuitem>Find</guimenuitem>
706
 
                                                        </menuchoice> from the menu.
707
 
                                                </para>
708
 
                                        </listitem>
709
 
                                </itemizedlist>
710
 
                        </para>
711
 
                </listitem>
712
 
                <listitem>
713
 
                        <para>
714
 
                                Enter the search expression into the
715
 
                                <guilabel>Find</guilabel> field. E.g. "music
716
 
                                player" if you want to search for music player.
717
 
                        </para>
718
 
                </listitem>
719
 
                <listitem>
720
 
                        <para>
721
 
                                Select the fields in which to look. 
722
 
                        </para>
723
 
                </listitem>
724
 
                <listitem>
725
 
                        <para>
726
 
                                Click on <guilabel>Find</guilabel> to start
727
 
                                the search. This can take some time on low machines and wide
728
 
                                search criteria.
729
 
                        </para>
730
 
                </listitem>
731
 
                <listitem>
732
 
                        <para>
733
 
                                After the pro FIXME
734
 
                        </para>
735
 
                </listitem>
736
 
        </orderedlist>
737
 
        </para>
738
 
        </listitem>
739
 
</varlistentry>
740
 
 
741
 
<varlistentry id="synaptic-pkg-find-advsearch">
742
 
                <term>
743
 
                        Showing only searched packages
744
 
                </term>
745
 
        
746
 
                <listitem>
747
 
                        <para>
748
 
                                To only show matching packages in the package list perform the following steps:
749
 
                        </para>
750
 
                        <para>
751
 
                <orderedlist>
752
 
                        <listitem>
753
 
                                <para>
754
 
                                        Open the search dialog <menuchoice><guimenu>Package</guimenu>
755
 
                                        <guimenuitem>Find...</guimenuitem>
756
 
                                        </menuchoice> from the menu or press <keycombo><keycap>Ctrl</keycap>
757
 
                                        <keycap>F</keycap></keycombo>.
758
 
                                </para>
759
 
                        </listitem>
760
 
                        <listitem>
761
 
                                <para>
762
 
                                        Type the search expression into the find field, e.g. "mp3 ogg player".
763
 
                                </para>
764
 
                        </listitem>
765
 
                        <listitem>
766
 
                                <para>
767
 
                                        Select the fields that you want to search in, e.g. "name" and "description"
768
 
                                </para>
769
 
                        </listitem>
770
 
                        <listitem>
771
 
                                <para>
772
 
                                        Click on <guibutton>Find</guibutton> to 
773
 
                                        start the search. In our example only music players and related packages will be listed.
774
 
                                </para>
775
 
                        </listitem>
776
 
                </orderedlist>
777
 
                </para>
778
 
                <para>
779
 
                <tip>
780
 
                        <para>
781
 
                                You can create more complex filters with the 
782
 
                                <xref linkend="synaptic-filter-edit"></xref>.
783
 
                        </para>
784
 
                </tip>
785
 
                </para>
786
 
                </listitem>
787
 
        </varlistentry>
788
 
</variablelist>
789
 
</sect2>
790
 
</sect1 -->
791
 
<sect1 id="synaptic-single"> 
792
 
        <title>Managing Packages</title> 
793
 
 
794
 
        <para>
795
 
                This chapter covers the basic actions <xref linkend="anchor-installing"/>,
796
 
                <xref linkend="anchor-removing"/> and <xref linkend="anchor-upgrading"/>
797
 
                of packages.
798
 
        </para>
799
 
        <para>
800
 
                Furthermore performing a <xref linkend="anchor-dist-upgrade"/>,
801
 
                <xref linkend="anchor-dwww"/> the online documentation, 
802
 
                <xref linkend="anchor-changelog"/> the changelog        and the advanced actions
803
 
                <xref linkend="anchor-force"/> the installation of a specific package version,
804
 
                <xref linkend="anchor-lock"/> a package to the current version are described.
805
 
        </para>  
806
 
 
807
 
<sect2 id="synaptic-pkg-install"> 
808
 
        <title>To Install Packages</title>
809
 
 
810
 
        <anchor id="anchor-installing" xreflabel="installing"/>
811
 
 
812
 
        <note>
813
 
                <para>
814
 
                        If different version of the same package are available &app;  will select the most 
815
 
                        applicable by default. To force the installation of a specific version that is different 
816
 
                        to the default one, see <xref linkend="synaptic-pkg-force"/>.
817
 
                </para>
818
 
        </note>
819
 
 
820
 
        <para>
821
 
                If you want to install a package perform the following steps:
822
 
        </para>
823
 
        <orderedlist>
824
 
                <listitem>
825
 
                        <para>
826
 
                                Reload the package information to be aware of the latest versions available:
827
 
 
828
 
                        <itemizedlist>
829
 
                                <listitem>
830
 
                                        <para>
831
 
                                                Choose <menuchoice><guimenu>Edit</guimenu>
832
 
                                                <guimenuitem>Reload Package Information</guimenuitem>
833
 
                                                </menuchoice> from the menu.
834
 
                                        </para>
835
 
                                </listitem>
836
 
                                <listitem>
837
 
                                        <para>
838
 
                                                Click on <guibutton>Reload</guibutton> in the toolbar.
839
 
                                        </para>
840
 
                                </listitem>
841
 
                                <listitem>
842
 
                                        <para>
843
 
                                                Press the key combination 
844
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.
845
 
                                        </para>
846
 
                                </listitem>
847
 
                        </itemizedlist>
848
 
                        </para>
849
 
                </listitem>
850
 
                <listitem>
851
 
                        <para>
852
 
                                Mark the package for installation:
853
 
 
854
 
                                <itemizedlist>
855
 
                                        <listitem>
856
 
                                                <para>
857
 
                                                        Double click on the name of the package in the
858
 
                                                        <xref linkend="synaptic-win-list"/>.
859
 
                                                </para>
860
 
                                        </listitem>
861
 
                                        <listitem>
862
 
                                                <para>
863
 
                                                        Click on the status icon of the package and choose <guimenuitem>
864
 
                                                        Mark for Installation</guimenuitem> from the menu.
865
 
                                                </para>
866
 
                                        </listitem>
867
 
                                        <listitem>
868
 
                                                <para>
869
 
                                                        Right click on the package and choose <guimenuitem>
870
 
                                                        Mark for Installation</guimenuitem> from the
871
 
                                                        context menu.
872
 
                                                </para>
873
 
                                        </listitem>
874
 
                                        <listitem>
875
 
                                                <para>
876
 
                                                        Select the package and
877
 
                                                        choose <menuchoice><guimenu>Package</guimenu>
878
 
                                                        <guimenuitem>Mark for Installation</guimenuitem>
879
 
                                                        </menuchoice> from the menu.
880
 
                                                </para>
881
 
                                        </listitem>
882
 
                                        <listitem>
883
 
                                                <para>
884
 
                                                        Select the package and
885
 
                                                        press the key combination <keycombo>
886
 
                                                        <keycap>Ctrl</keycap><keycap>I</keycap></keycombo>.
887
 
                                                </para>
888
 
                                        </listitem>
889
 
                                </itemizedlist>
890
 
                        </para>
891
 
                        <para>
892
 
                                If the installation of the package(s) requires additional changes, you will be asked 
893
 
                                for confirmation. To also mark the additional changes click on the button <guibutton>Mark
894
 
                                </guibutton>.
895
 
                        </para>
896
 
                </listitem>
897
 
                <listitem>
898
 
                        <para>
899
 
                                Apply the marked changes to actually install the package:
900
 
 
901
 
                                <itemizedlist>
902
 
                                        <listitem>
903
 
                                                <para>
904
 
                                                        Click on <guibutton>Apply</guibutton> in the toolbar.   
905
 
                                        </para>
906
 
                                        </listitem>
907
 
                                        <listitem>
908
 
                                                <para>
909
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
910
 
                                                        <guimenuitem>Apply Marked Changes</guimenuitem>
911
 
                                                        </menuchoice> from the menu.
912
 
                                                </para>
913
 
                                        </listitem>
914
 
                                        <listitem>
915
 
                                                <para>
916
 
                                                        Press the key combination 
917
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
918
 
                                                </para>
919
 
                                        </listitem>
920
 
                                </itemizedlist>
921
 
                        </para>
922
 
                </listitem>
923
 
                <listitem>
924
 
                        <para>
925
 
                                You will be asked for confirmation. Check the summarized changes that will be applied. 
926
 
                                To continue with the actual installation confirm the changes click on <guibutton>Apply</guibutton>.
927
 
                        </para>
928
 
                </listitem>
929
 
                <listitem>
930
 
                        <para>
931
 
                                During the processing of the changes you will see a progressbar. Wait until
932
 
                                the changes have been applied. This can take some time depending on the number
933
 
                                of changes. Afterwards you will be returned to the main window.
934
 
                        </para>                         
935
 
                        <note>
936
 
                                <para>
937
 
                                        The progressbar is not available on Debian system. Instead you will
938
 
                                        see a detailed terminal output.
939
 
                                 </para>
940
 
                        </note>
941
 
                </listitem>
942
 
        </orderedlist>
943
 
</sect2>
944
 
 
945
 
<sect2 id="synaptic-pkg-remove"> 
946
 
        <title>To Remove Packages</title>
947
 
        <anchor id="anchor-removing" xreflabel="removing"/>
948
 
 
949
 
        <para>
950
 
                <note>
951
 
                        <para>
952
 
                                Configuration files and user created data (e.g. a website in "/var/www") are not removed
953
 
                                from the system by default.
954
 
                        </para>
955
 
                        <para>
956
 
                                <emphasis>Debian only:</emphasis> You can change the default behavior in the preferences.
957
 
                        </para>
958
 
                        <para>
959
 
                                <emphasis>Debian only:</emphasis> To remove all files related to the package
960
 
                                choose <menuchoice><guimenuitem>Mark for
961
 
                                Complete Removal</guimenuitem></menuchoice> instead of 
962
 
                                <menuchoice><guimenuitem>Mark for Removal</guimenuitem></menuchoice>.
963
 
                        </para>
964
 
                </note>
965
 
        </para>
966
 
        <!-- para>
967
 
                <note>
968
 
                        <para>
969
 
                                <emphasis>Debian only:</emphasis> To also remove packages that are only installed as dependency 
970
 
                                of the to be removed 
971
 
                                package(s) and that would be no longer needed (orphaned) afterwards, choose 
972
 
                                <menuchoice><guimenuitem>Remove Including Orphaned Dependecies</guimenuitem>
973
 
                                </menuchoice> instead of <menuchoice><guimenuitem>Remove</guimenuitem></menuchoice>.
974
 
                        </para>
975
 
                </note>
976
 
        </para -->
977
 
        <para>
978
 
                To remove a packages follow these steps:
979
 
        </para>
980
 
        <orderedlist>
981
 
                <listitem>
982
 
                        <para>
983
 
                                Mark the package for removal:
984
 
                                <itemizedlist>
985
 
                                        <listitem>
986
 
                                                <para>
987
 
                                                        Double click on the name of the installed package in the
988
 
                                                        <xref linkend="synaptic-win-list"/>.
989
 
                                                </para>
990
 
                                        </listitem>
991
 
                                        <listitem>
992
 
                                                <para>
993
 
                                                        Click on the status icon of the package and choose <guimenuitem>
994
 
                                                        Mark for Removal</guimenuitem> from the menu.
995
 
                                                </para>
996
 
                                        </listitem>
997
 
                                        <listitem>
998
 
                                                <para>
999
 
                                                        Right click on the package and choose <guimenuitem>
1000
 
                                                        Remove</guimenuitem> from the context menu.
1001
 
                                                </para>
1002
 
                                        </listitem>
1003
 
                                        <listitem>
1004
 
                                                <para>
1005
 
                                                        Select the package and
1006
 
                                                        choose <menuchoice><guimenu>Package</guimenu>
1007
 
                                                        <guimenuitem>Mark for Removal</guimenuitem>
1008
 
                                                        </menuchoice> from the menu.
1009
 
                                                </para>
1010
 
                                        </listitem>
1011
 
                                        <listitem>
1012
 
                                                <para>
1013
 
                                                        Select the package and
1014
 
                                                        press the key <keycap>Delete</keycap>.
1015
 
                                                </para>
1016
 
                                        </listitem>
1017
 
                                </itemizedlist>
1018
 
                        </para>
1019
 
                        <para>
1020
 
                                If the removal of the package(s) requires additional changes, you will be asked 
1021
 
                                for confirmation. To also mark the additional changes click on the button <guibutton>Mark
1022
 
                                </guibutton>.
1023
 
                        </para>
1024
 
                </listitem>
1025
 
                <listitem>
1026
 
                        <para>
1027
 
                                Apply the marked changes to actually remove the package(s):
1028
 
 
1029
 
                                <itemizedlist>
1030
 
                                        <listitem>
1031
 
                                                <para>
1032
 
                                                        Click on <guibutton>Apply</guibutton> in the toolbar.
1033
 
                                                </para>
1034
 
                                        </listitem>
1035
 
                                        <listitem>
1036
 
                                                <para>
1037
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
1038
 
                                                        <guimenuitem>Apply Marked Changes</guimenuitem>
1039
 
                                                        </menuchoice> from the menu.
1040
 
                                                </para>
1041
 
                                        </listitem>
1042
 
                                        <listitem>
1043
 
                                                <para>
1044
 
                                                        Press the key combination 
1045
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
1046
 
                                                </para>
1047
 
                                        </listitem>
1048
 
                                </itemizedlist>
1049
 
                        </para>
1050
 
                </listitem>
1051
 
                <listitem>
1052
 
                        <para>
1053
 
                                You are asked for confirmation. Check the summarized changes that will be applied. 
1054
 
                                To continue with the actual removal confirm the changes click on <guibutton>Apply</guibutton>.
1055
 
                        </para>
1056
 
                </listitem>
1057
 
                <listitem>
1058
 
                        <para>
1059
 
                                During the processing of the changes you will see a progressbar. Wait until
1060
 
                                the changes have been applied. This can take some time depending on the number
1061
 
                                of changes. Afterwards you will be returned to the main window.
1062
 
                        </para>                         
1063
 
                        <note>
1064
 
                                <para>
1065
 
                                        The progressbar is not available on Debian system. Instead you will
1066
 
                                        see a detailed terminal output.
1067
 
                                </para>
1068
 
                        </note>
1069
 
                </listitem>
1070
 
        </orderedlist>
1071
 
</sect2>
1072
 
<sect2 id="synaptic-pkg-upgrade"> 
1073
 
        <title>To Upgrade Packages</title>
1074
 
 
1075
 
        <anchor id="anchor-upgrading" xreflabel="upgrading"/>
1076
 
 
1077
 
        <para>
1078
 
                To upgrade a package follow these steps:
1079
 
        </para>
1080
 
        <orderedlist>
1081
 
                <listitem>
1082
 
                        <para>
1083
 
                                Reload the package information to be aware of the latest versions available:
1084
 
 
1085
 
                                <itemizedlist>
1086
 
                                        <listitem>
1087
 
                                                <para>
1088
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
1089
 
                                                        <guimenuitem>Reload Package Information</guimenuitem></menuchoice> 
1090
 
                                                        from the menu.
1091
 
                                                </para>
1092
 
                                        </listitem>
1093
 
                                        <listitem>
1094
 
                                                <para>
1095
 
                                                        Click on <guibutton>Reload</guibutton> in the toolbar.
1096
 
                                                </para>
1097
 
                                        </listitem>
1098
 
                                        <listitem>
1099
 
                                                <para>
1100
 
                                                        Press the key combination 
1101
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.
1102
 
                                                </para>
1103
 
                                        </listitem>
1104
 
                                </itemizedlist>
1105
 
                        </para>
1106
 
                </listitem>
1107
 
 
1108
 
                <listitem>
1109
 
                        <para>
1110
 
                                Mark the package for upgrade:
1111
 
 
1112
 
                                <itemizedlist>
1113
 
                                        <listitem>
1114
 
                                                <para>
1115
 
                                                        Double click on the name of the package with a later version available
1116
 
                                                        in the <xref linkend="synaptic-win-list"/>.
1117
 
                                                </para>
1118
 
                                        </listitem>
1119
 
                                        <listitem>
1120
 
                                                <para>
1121
 
                                                        Click on the status icon of the package and choose <guimenuitem>
1122
 
                                                        Mark for Upgrade</guimenuitem> from the menu.
1123
 
                                                </para>
1124
 
                                        </listitem>
1125
 
                                        <listitem>
1126
 
                                                <para>
1127
 
                                                        Right click on the package and choose <guimenuitem>
1128
 
                                                        Mark for Upgrade</guimenuitem> from the
1129
 
                                                        context menu.
1130
 
                                                </para>
1131
 
                                        </listitem>
1132
 
                                        <listitem>
1133
 
                                                <para>
1134
 
                                                        Select the package and
1135
 
                                                        choose <menuchoice><guimenu>Package</guimenu>
1136
 
                                                        <guimenuitem>Mark for Upgrade</guimenuitem>
1137
 
                                                        </menuchoice> from the menu.
1138
 
                                                </para>
1139
 
                                        </listitem>
1140
 
                                        <listitem>
1141
 
                                                <para>
1142
 
                                                        Select the package and
1143
 
                                                        press the key combination 
1144
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
1145
 
                                                </para>
1146
 
                                        </listitem>
1147
 
                                </itemizedlist>
1148
 
                        </para>
1149
 
                        <para>
1150
 
                                If the upgrade of the package(s) requires additional changes, you will be asked 
1151
 
                                for confirmation. To also mark the additional changes click on the button <guibutton>Mark
1152
 
                                </guibutton>.
1153
 
                        </para>
1154
 
                </listitem>
1155
 
                <listitem>
1156
 
                        <para>
1157
 
                                Apply the marked changes to actually upgrade the package:
1158
 
                        </para>
1159
 
                        <itemizedlist>
1160
 
                                <listitem>
1161
 
                                        <para>
1162
 
                                                Click on <guibutton>Apply</guibutton> in the toolbar.
1163
 
                                        </para>
1164
 
                                </listitem>
1165
 
                                <listitem>
1166
 
                                        <para>
1167
 
                                                Choose <menuchoice><guimenu>Edit</guimenu>
1168
 
                                                <guimenuitem>Apply Marked Changes</guimenuitem></menuchoice> from the menu.
1169
 
                                        </para>
1170
 
                                </listitem>
1171
 
                                <listitem>
1172
 
                                        <para>
1173
 
                                                Press the key combination 
1174
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
1175
 
                                        </para>
1176
 
                                </listitem>
1177
 
                        </itemizedlist>
1178
 
                </listitem>
1179
 
                <listitem>
1180
 
                        <para>
1181
 
                                You are asked for confirmation. Check the summarized changes that will be applied. 
1182
 
                                To continue with the actual upgrade confirm the changes click on <guibutton>Apply</guibutton>.
1183
 
                        </para>
1184
 
                </listitem>
1185
 
                <listitem>
1186
 
                        <para>
1187
 
                                During the processing of the changes you will see a progressbar. Wait until
1188
 
                                the changes have been applied. This can take some time depending on the number
1189
 
                                of changes. Afterwards you will be returned to the main window.
1190
 
                        </para>                         
1191
 
                        <note>
1192
 
                                <para>
1193
 
                                        The progressbar is not available on Debian system. Instead you will
1194
 
                                        see a detailed terminal output.
1195
 
                                </para>
1196
 
                        </note>
1197
 
                </listitem>
1198
 
        </orderedlist>
1199
 
        <tip>
1200
 
                <para>
1201
 
                        To upgrade all installed packages to the latest version,
1202
 
                        see <xref linkend="synaptic-pkg-upgradesystem"/>.
1203
 
                </para>
1204
 
        </tip>
1205
 
</sect2>
1206
 
 
1207
 
 
1208
 
<sect2 id="synaptic-pkg-upgradesystem"> 
1209
 
        <title>To Upgrade the Whole System</title>
1210
 
 
1211
 
        <anchor id="anchor-dist-upgrade" xreflabel="system upgrade"/>
1212
 
        
1213
 
        <para>
1214
 
                &app; provides two methods for marking packages for upgrade:
1215
 
                <variablelist>
1216
 
                        <varlistentry>
1217
 
                                <term>
1218
 
                                        Default Upgrade
1219
 
                                </term>
1220
 
                                <listitem>
1221
 
                                        <para> 
1222
 
                                                The default upgrade method marks upgrades of installed packages only. 
1223
 
                                                If the later version of a package depends on not installed packages 
1224
 
                                                or conflicts with an already installed package, 
1225
 
                                                the upgrade will not be marked.
1226
 
                                        </para>
1227
 
                                </listitem>
1228
 
                        </varlistentry>
1229
 
                        <varlistentry>
1230
 
                                <term>
1231
 
                                        Smart Upgrade (Dist-Upgrade)
1232
 
                                </term>
1233
 
                                <listitem>
1234
 
                                        <para>
1235
 
                                                The smart upgrade method tries to resolve package conflicts intelligently. This includes
1236
 
                                                installing additional required packages and preferring packages with
1237
 
                                                higher priority.
1238
 
                                        </para>
1239
 
                                        <para>
1240
 
                                                Smart upgrade is also known as <emphasis>dist-upgrade</emphasis> in the console tool apt-get.
1241
 
                                        </para>
1242
 
                                </listitem>
1243
 
                        </varlistentry>
1244
 
                </variablelist>
1245
 
 
1246
 
                <note>
1247
 
                        <para>
1248
 
                                Upgrades to a later operating system major releases have to be performed with the 
1249
 
                                smart upgrade method, e.g. from Conectiva 9 to Conectiva 10 or from 
1250
 
                                Debian Woody to Debian Sarge.
1251
 
                        </para>
1252
 
                </note>
1253
 
        </para>
1254
 
 
1255
 
        <para>
1256
 
                To upgrade your system to the latest version follow these steps:
1257
 
        </para>
1258
 
        <orderedlist>
1259
 
                <listitem>
1260
 
                        <para>
1261
 
                                 Reload the package information to be aware of the latest versions available:
1262
 
 
1263
 
                                <itemizedlist>
1264
 
                                        <listitem>
1265
 
                                                <para>
1266
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
1267
 
                                                        <guimenuitem>Reload Package Information</guimenuitem></menuchoice> from the menu.
1268
 
                                                </para>
1269
 
                                        </listitem>
1270
 
                                        <listitem>
1271
 
                                                <para>
1272
 
                                                        Click on <guibutton>Reload</guibutton> in the toolbar.
1273
 
                                                </para>
1274
 
                                        </listitem>
1275
 
                                        <listitem>
1276
 
                                                <para>
1277
 
                                                        Press the key combination <keycombo>
1278
 
                                                        <keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.
1279
 
                                                </para>
1280
 
                                        </listitem>
1281
 
                                </itemizedlist>
1282
 
                        </para>
1283
 
                </listitem>
1284
 
 
1285
 
                <listitem>
1286
 
                        <para>
1287
 
                                Mark all possible upgrades: 
1288
 
 
1289
 
                                <itemizedlist>
1290
 
                                        <listitem>
1291
 
                                                <para>
1292
 
                                                        Click on <guibutton>Mark all Upgrades
1293
 
                                                        </guibutton> in the toolbar.
1294
 
                                                </para>
1295
 
                                        </listitem>
1296
 
                                        <listitem>
1297
 
                                                <para>
1298
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
1299
 
                                                        <guimenuitem>Mark all Upgrades</guimenuitem>
1300
 
                                                        </menuchoice> from the menu.
1301
 
                                                </para>
1302
 
                                        </listitem>
1303
 
                                        <listitem>
1304
 
                                                <para>
1305
 
                                                        Press the key combination <keycombo>
1306
 
                                                        <keycap>Ctrl</keycap><keycap>G</keycap></keycombo>.
1307
 
                                                </para>
1308
 
                                        </listitem>
1309
 
                                </itemizedlist>
1310
 
                        </para>
1311
 
                </listitem>
1312
 
                
1313
 
                <listitem>
1314
 
                        <para>
1315
 
                                Choose the upgrade method. Smart upgrade is recommended.
1316
 
                        </para>
1317
 
                </listitem>
1318
 
                <listitem>
1319
 
                        <para>
1320
 
                                Apply the marked changes to actually upgrade the package(s):
1321
 
 
1322
 
                                <itemizedlist>
1323
 
                                        <listitem>
1324
 
                                                <para>
1325
 
                                                        Click on <guibutton>Apply</guibutton> in the toolbar.
1326
 
                                                </para>
1327
 
                                        </listitem>
1328
 
                                        <listitem>
1329
 
                                                <para>
1330
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
1331
 
                                                        <guimenuitem>Apply Marked Changes</guimenuitem></menuchoice> 
1332
 
                                                        from the menu.
1333
 
                                                </para>
1334
 
                                        </listitem>
1335
 
                                        <listitem>
1336
 
                                                <para>
1337
 
                                                        Press the key combination 
1338
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
1339
 
                                                </para>
1340
 
                                        </listitem>
1341
 
                                </itemizedlist>
1342
 
                        </para>
1343
 
                </listitem>
1344
 
                <listitem>
1345
 
                        <para>
1346
 
                                You are asked for confirmation. Check the summarized changes that will be applied. 
1347
 
                                To continue with the actual upgrade confirm the changes click on <guibutton>Apply</guibutton>.
1348
 
                        </para>
1349
 
                </listitem>
1350
 
                <listitem>
1351
 
                        <para>
1352
 
                                During the processing of the changes you will see a progressbar. Wait until
1353
 
                                the changes have been applied. This can take some time depending on the number
1354
 
                                of changes. Afterwards you will be returned to the main window.
1355
 
                        </para>                         
1356
 
                        <note>
1357
 
                                <para>
1358
 
                                        The progressbar is not available on Debian system. Instead you will
1359
 
                                        see a detailed terminal output.
1360
 
                                </para>
1361
 
                        </note>
1362
 
                </listitem>
1363
 
        </orderedlist>
1364
 
 
1365
 
        <tip>
1366
 
                <para>
1367
 
                        You can change the default upgrade method for further upgrade in the preferences
1368
 
                        <!-- xref linkend="synaptic-prefs-actions"/-->.
1369
 
                </para>
1370
 
        </tip>
1371
 
</sect2>
1372
 
 
1373
 
<!-- sect2 id="synaptic-pkg-downgrade"> 
1374
 
        <title>To Downgrade Packages</title> 
1375
 
 
1376
 
        <caution>
1377
 
                <para>
1378
 
                        This may render your package system unusable!
1379
 
                </para>
1380
 
                <para>
1381
 
                        Downgrading packages is a broken feature, since apt and &app; can only handle
1382
 
                        conflicts and dependency resolution of upgrades. 
1383
 
                </para>
1384
 
                <para>
1385
 
                        You may need this feature in some rare circumstances, but it is not recommended to use. 
1386
 
                </para>
1387
 
        </caution>
1388
 
 
1389
 
        <para>
1390
 
                To downgrade a package you have to mark a specific version of the package:
1391
 
        </para>
1392
 
        <orderedlist>
1393
 
                <listitem>
1394
 
                        <para>
1395
 
                                Select the package that you wish to downgrade in the 
1396
 
                                <xref linkend="synaptic-win-list"/>.
1397
 
                        </para>
1398
 
                </listitem>
1399
 
                <listitem>
1400
 
                        <para>
1401
 
                                Open the Properties dialog of the package:
1402
 
 
1403
 
                                <itemizedlist>
1404
 
                                        <listitem>
1405
 
                                                <para>
1406
 
                                                        Click on <guibutton>Properties</guibutton> in the toolbar.
1407
 
                                                </para>
1408
 
                                        </listitem>
1409
 
                                        <listitem>
1410
 
                                                <para>
1411
 
                                                        Choose <menuchoice><guimenu>Package</guimenu>
1412
 
                                                        <guimenuitem>Properties</guimenuitem></menuchoice> 
1413
 
                                                        from the menu.
1414
 
                                                </para>
1415
 
                                        </listitem>
1416
 
                                        <listitem>
1417
 
                                                <para>
1418
 
                                                        Press the key combination 
1419
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
1420
 
                                                </para>
1421
 
                                        </listitem>
1422
 
                                </itemizedlist>
1423
 
                        </para>
1424
 
                </listitem>
1425
 
                <listitem>
1426
 
                        <para>
1427
 
                                Activate the <guibutton>Expert</guibutton> tab in the properties dialog. You will
1428
 
                                see a list of all available version of the package.
1429
 
                        </para>
1430
 
                </listitem>
1431
 
                <listitem>
1432
 
                        <para>
1433
 
                                Choose the version to be installed from the list and close the Properties dialog.
1434
 
                        </para>
1435
 
                </listitem>
1436
 
                <listitem>
1437
 
                        <para>
1438
 
                                Apply the marked changes to actually downgrade the package(s):
1439
 
 
1440
 
                                <itemizedlist>
1441
 
                                        <listitem>
1442
 
                                                <para>
1443
 
                                                        Click on <guibutton>Apply Changes</guibutton> in the toolbar.
1444
 
                                                </para>
1445
 
                                        </listitem>
1446
 
                                        <listitem>
1447
 
                                                <para>
1448
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
1449
 
                                                        <guimenuitem>Apply Marked Changes</guimenuitem></menuchoice> 
1450
 
                                                        from the menu.
1451
 
                                                </para>
1452
 
                                        </listitem>
1453
 
                                        <listitem>
1454
 
                                                <para>
1455
 
                                                        Press the key combination 
1456
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
1457
 
                                                </para>
1458
 
                                        </listitem>
1459
 
                                </itemizedlist>
1460
 
                        </para>
1461
 
                </listitem>
1462
 
        </orderedlist>
1463
 
</sect2 -->
1464
 
 
1465
 
<sect2 id="synaptic-pkg-apply">
1466
 
        <title>To Apply Marked Changes</title>
1467
 
 
1468
 
        <tip>
1469
 
                <para>
1470
 
                        To show packages that are marked for a status change
1471
 
                        only choose the "Marked Changes" filter, see 
1472
 
                        <xref linkend="synaptic-filter-apply"/>.
1473
 
                </para>
1474
 
        </tip>
1475
 
 
1476
 
        <para>
1477
 
                To apply marked changes:
1478
 
 
1479
 
                <itemizedlist>
1480
 
                        <listitem>
1481
 
                                <para>
1482
 
                                        Click on <guibutton>Apply</guibutton> in the toolbar.
1483
 
                                </para>
1484
 
                        </listitem>
1485
 
                        <listitem>
1486
 
                                <para>
1487
 
                                        Choose <menuchoice><guimenu>Edit</guimenu>
1488
 
                                        <guimenuitem>Apply Marked Changes</guimenuitem></menuchoice> from the menu.
1489
 
                                </para>
1490
 
                        </listitem>
1491
 
                        <listitem>
1492
 
                                <para>
1493
 
                                        Press the key combination 
1494
 
                                        <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
1495
 
                                </para>
1496
 
                        </listitem>
1497
 
                </itemizedlist>
1498
 
        </para>
1499
 
        <para>
1500
 
                You are asked for confirmation. Check the summarized changes that will be applied. 
1501
 
                To confirm the changes click on the button <guibutton>Apply</guibutton>.
1502
 
        </para>
1503
 
        <para>
1504
 
                During the processing of the changes you will see a progressbar. Wait until
1505
 
                the changes have been applied. This can take some time depending on the number
1506
 
                of changes. Afterwards you will be returned to the main window.
1507
 
        </para>                         
1508
 
        <note>
1509
 
                <para>
1510
 
                        The progressbar is not available on Debian system. Instead you will
1511
 
                        see a detailed terminal output.
1512
 
                </para>
1513
 
        </note>
1514
 
</sect2>
1515
 
 
1516
 
<sect2 id="synaptic-pkg-undo">
1517
 
        <title>To Unmark Changes</title>
1518
 
 
1519
 
        <para>
1520
 
                The following ways allow you to unmark changes:
1521
 
        </para>
1522
 
        
1523
 
        <variablelist>
1524
 
                <varlistentry>
1525
 
                        <term>
1526
 
                                To undo the marking of specific packages
1527
 
                        </term>
1528
 
                        <listitem>
1529
 
                                <itemizedlist>
1530
 
                                        <listitem>
1531
 
                                                <para>
1532
 
                                                        Right click on the package and choose <menuchoice>
1533
 
                                                        <guimenuitem>Unmark</guimenuitem></menuchoice> from 
1534
 
                                                        the context menu.
1535
 
                                                </para>
1536
 
                                        </listitem>
1537
 
                                        <listitem>
1538
 
                                                <para>
1539
 
                                                        Select the package(s) and choose <menuchoice>
1540
 
                                                        <guimenu>Package</guimenu><guimenuitem>Unmark</guimenuitem>
1541
 
                                                        </menuchoice>.
1542
 
                                                </para>
1543
 
                                        </listitem>
1544
 
                                        <listitem>
1545
 
                                                <para>
1546
 
                                                        Select the package(s) and press <keycombo><keycap>Ctrl</keycap>
1547
 
                                                        <keycap>N</keycap></keycombo>.
1548
 
                                                </para>
1549
 
                                        </listitem>
1550
 
                                </itemizedlist>
1551
 
                        </listitem>
1552
 
                </varlistentry>
1553
 
                <varlistentry>
1554
 
                        <term>
1555
 
                                To undo all markings
1556
 
                        </term>
1557
 
                        <listitem>
1558
 
                                <para>
1559
 
                                        Choose <menuchoice><guimenu>Edit</guimenu>
1560
 
                                        <guimenuitem>Unmark All</guimenuitem></menuchoice>
1561
 
                                        from the menu.
1562
 
                                </para>
1563
 
                        </listitem>
1564
 
                </varlistentry>
1565
 
                <varlistentry>
1566
 
                        <term>
1567
 
                                To undo the last marking
1568
 
                        </term>
1569
 
                        <listitem>
1570
 
                                <para>
1571
 
                                        Choose <menuchoice><guimenu>Edit</guimenu>
1572
 
                                        <guimenuitem>Undo</guimenuitem></menuchoice>
1573
 
                                        from the menu.
1574
 
                                </para>
1575
 
                                <para>
1576
 
                                        This step can be repeated. The maxmium number of undo operations can be set
1577
 
                                        in the preferences. FIX link
1578
 
                                </para>
1579
 
                        </listitem>
1580
 
                </varlistentry>
1581
 
        </variablelist>
1582
 
</sect2>
1583
 
 
1584
 
<sect2 id="synaptic-pkg-config">
1585
 
        <title>To Configure Packages (Debian only)</title>
1586
 
 
1587
 
        <para>
1588
 
                <note>
1589
 
                        <para>
1590
 
                                To use this feature you have to install the package
1591
 
                                <emphasis>libgnome2-perl</emphasis>.
1592
 
                        </para>
1593
 
                </note>
1594
 
        </para> 
1595
 
 
1596
 
        <para>
1597
 
                Debian provides a unified method, called <emphasis>debconf</emphasis>, to configure software packages. This feature
1598
 
                is not supported by all packages. If a package supports this feature the configuration can be done 
1599
 
                through an assistant.
1600
 
        </para>
1601
 
 
1602
 
        <para>
1603
 
                To configure a supported package:
1604
 
        </para>
1605
 
        <orderedlist>
1606
 
                <listitem>
1607
 
                        <para>
1608
 
                                Select the package that you wish to configure in the 
1609
 
                                <xref linkend="synaptic-win-list"/>.
1610
 
                        </para>
1611
 
                </listitem>
1612
 
                <listitem>
1613
 
                        <para>
1614
 
                                Choose <menuchoice><guimenu>Package</guimenu>
1615
 
                                <guimenuitem>Configure...</guimenuitem></menuchoice> from the menu.
1616
 
                        </para>
1617
 
                </listitem>
1618
 
        </orderedlist>
1619
 
        <tip>
1620
 
                <para>
1621
 
                        To get a list of all configurable packages choose the <emphasis>Configurable Packages</emphasis> filter.
1622
 
                </para>
1623
 
        </tip>
1624
 
</sect2>
1625
 
 
1626
 
<sect2 id="synaptic-pkg-docu">
1627
 
        <title>To View Documentation for Packages (Debian only)</title>
1628
 
 
1629
 
        <anchor id="anchor-dwww" xreflabel="browsing"/>
1630
 
 
1631
 
 
1632
 
        <note>
1633
 
                <para>
1634
 
                        To use this feature you have to install the package <emphasis>dwww</emphasis>.
1635
 
                </para>
1636
 
        </note>
1637
 
        
1638
 
        <para>
1639
 
                Dwww provides access to all the installed documentation
1640
 
                related to package with a web browser. The whole documentation is
1641
 
                hosted via a local HTTP server.
1642
 
        </para>
1643
 
 
1644
 
        <orderedlist>
1645
 
                <listitem>
1646
 
                        <para>
1647
 
                                Select the package about that you wish to read additional documentation 
1648
 
                                in the <xref linkend="synaptic-win-list"/>.
1649
 
                        </para>
1650
 
                </listitem>
1651
 
                <listitem>
1652
 
                        <para>
1653
 
                                Choose <menuchoice><guimenu>Package</guimenu>
1654
 
                                <guimenuitem>Browse Documentation</guimenuitem></menuchoice>.
1655
 
                        </para>
1656
 
                </listitem>
1657
 
        </orderedlist>
1658
 
 
1659
 
</sect2>
1660
 
<sect2 id="synaptic-pkg-changelog">
1661
 
        <title>To View the Changelog of a Package (Debian only)</title>
1662
 
 
1663
 
        <anchor id="anchor-changelog" xreflabel="reading"/>
1664
 
 
1665
 
        <note>
1666
 
                <para>
1667
 
                        The changelog of native Debian packages can be viewed, only.
1668
 
                </para>
1669
 
        </note>
1670
 
        
1671
 
        <para>
1672
 
                To view the changelog of a native Debian package perform the following steps:
1673
 
        </para>
1674
 
 
1675
 
        <orderedlist>
1676
 
                <listitem>
1677
 
                        <para>
1678
 
                                Select the package in the <xref linkend="synaptic-win-list"/>.
1679
 
                        </para>
1680
 
                </listitem>
1681
 
                <listitem>
1682
 
                        <para>
1683
 
                                Choose <menuchoice><guimenu>Package</guimenu>
1684
 
                                <guimenuitem>Download Changelog</guimenuitem></menuchoice>.
1685
 
                        </para>
1686
 
                </listitem>
1687
 
        </orderedlist>
1688
 
</sect2>
1689
 
 
1690
 
<sect2 id="synaptic-pkg-lock">
1691
 
        <title>To Lock a Package to the Current Version (Debian only)</title>
1692
 
 
1693
 
        <anchor id="anchor-lock" xreflabel="locking"/>
1694
 
 
1695
 
        <para>
1696
 
                To lock a package to the current version follow these steps:
1697
 
        </para>
1698
 
        <orderedlist>
1699
 
                <listitem>
1700
 
                        <para>
1701
 
                                Select the package that you want to lock in the <xref linkend="synaptic-win-list"/>.
1702
 
                        </para>
1703
 
                </listitem>
1704
 
                <listitem>
1705
 
                        <para>
1706
 
                                Choose <menuchoice><guimenu>Package</guimenu>
1707
 
                                <guimenuitem>Lock Version</guimenuitem></menuchoice>.
1708
 
                        </para>
1709
 
                        <para>
1710
 
                                The &app; will reload the package information. You should now see, that the menu item <menuchoice>
1711
 
                                <guimenu>Package</guimenu><guimenuitem>Lock Version</guimenuitem></menuchoice> is checked.
1712
 
                                Furthermore all actions in the menu <guimenu>Package</guimenu> are disabled now.
1713
 
                        </para>
1714
 
                </listitem>
1715
 
        </orderedlist>
1716
 
        <para>
1717
 
                To unlock the package uncheck <menuchoice><guimenu>Package</guimenu><guimenuitem>Lock Version</guimenuitem>
1718
 
                </menuchoice>.
1719
 
        </para>
1720
 
</sect2>
1721
 
 
1722
 
 
1723
 
 
1724
 
<sect2 id="synaptic-pkg-force">
1725
 
        <title>To Force the Installation of a Specific Version</title>
1726
 
 
1727
 
        <anchor id="anchor-force" xreflabel="forcing"/>
1728
 
 
1729
 
        <warning>
1730
 
                <para>
1731
 
                        The &app; always selects the most applicable version available. If you force a 
1732
 
                        different version from the default one, errors in the dependency handling
1733
 
                        can occur.
1734
 
                </para>
1735
 
        </warning>
1736
 
 
1737
 
        <para>
1738
 
                To force the installation of a version of package different to the default one 
1739
 
                perform the following steps:
1740
 
        </para>
1741
 
        <orderedlist>
1742
 
                <listitem>
1743
 
                        <para>
1744
 
                                Reload the package information to be aware of the latest versions available:
1745
 
 
1746
 
                        <itemizedlist>
1747
 
                                <listitem>
1748
 
                                        <para>
1749
 
                                                Choose <menuchoice><guimenu>Edit</guimenu>
1750
 
                                                <guimenuitem>Reload Package Information</guimenuitem>
1751
 
                                                </menuchoice> from the menu.
1752
 
                                        </para>
1753
 
                                </listitem>
1754
 
                                <listitem>
1755
 
                                        <para>
1756
 
                                                Click on <guibutton>Reload</guibutton> in the toolbar.
1757
 
                                        </para>
1758
 
                                </listitem>
1759
 
                                <listitem>
1760
 
                                        <para>
1761
 
                                                Press the key combination 
1762
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.
1763
 
                                        </para>
1764
 
                                </listitem>
1765
 
                        </itemizedlist>
1766
 
                        </para>
1767
 
                </listitem>
1768
 
                <listitem>
1769
 
                        <para>
1770
 
                                Select the package in the <xref linkend="synaptic-win-list"/>.
1771
 
                        </para>
1772
 
                </listitem>
1773
 
                <listitem>
1774
 
                        <para>
1775
 
                                Choose <menuchoice><guimenu>Package</guimenu><guimenuitem>Force Version...</guimenuitem>
1776
 
                                </menuchoice> from the menu to open a dialog with all available versions of the package.
1777
 
                        </para>
1778
 
                </listitem>
1779
 
                <listitem>
1780
 
                        <para>
1781
 
                                Select the version that should be marked for installation. To confirm your 
1782
 
                                decision click on the button <guibutton>Force</guibutton>.
1783
 
                        </para>
1784
 
                </listitem>
1785
 
                <listitem>
1786
 
                        <para>
1787
 
                                Apply the marked changes to actually install the forced package version:
1788
 
 
1789
 
                                <itemizedlist>
1790
 
                                        <listitem>
1791
 
                                                <para>
1792
 
                                                        Click on <guibutton>Apply</guibutton> in the toolbar.   
1793
 
                                        </para>
1794
 
                                        </listitem>
1795
 
                                        <listitem>
1796
 
                                                <para>
1797
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
1798
 
                                                        <guimenuitem>Apply Marked Changes</guimenuitem>
1799
 
                                                        </menuchoice> from the menu.
1800
 
                                                </para>
1801
 
                                        </listitem>
1802
 
                                        <listitem>
1803
 
                                                <para>
1804
 
                                                        Press the key combination 
1805
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.
1806
 
                                                </para>
1807
 
                                        </listitem>
1808
 
                                </itemizedlist>
1809
 
                        </para>
1810
 
                </listitem>
1811
 
                <listitem>
1812
 
                        <para>
1813
 
                                You will be asked for confirmation. Check the summarized changes that will be applied. 
1814
 
                                To continue with the actual installation confirm the changes click on <guibutton>Apply</guibutton>
1815
 
                        </para>
1816
 
                </listitem>
1817
 
                <listitem>
1818
 
                        <para>
1819
 
                                During the processing of the changes you will see a progressbar. Wait until
1820
 
                                the changes have been applied. This can take some time depending on the number
1821
 
                                of changes. Afterwards you will be returned to the main window.
1822
 
                        </para>                         
1823
 
                        <note>
1824
 
                                <para>
1825
 
                                        The progressbar is not available on Debian system. Instead you will
1826
 
                                        see a detailed terminal output.
1827
 
                                 </para>
1828
 
                        </note>
1829
 
                </listitem>
1830
 
        </orderedlist>
1831
 
</sect2>
1832
 
<sect2 id="synaptic-pkg-fix">
1833
 
        <title>To Fix Broken Packages</title>
1834
 
        
1835
 
        <para>
1836
 
                &app; will not allow any further changes to the system before all broken packages are fixed.
1837
 
        </para>
1838
 
        <tip>
1839
 
                <para>
1840
 
                        To show all broken packages choose the <emphasis>Broken</emphasis> filter.
1841
 
                </para>
1842
 
        </tip>
1843
 
 
1844
 
        <para>
1845
 
                To correct the broken packages perform the following steps:
1846
 
                choose <menuchoice><guimenu>Edit</guimenu>
1847
 
                <guimenuitem>Fix Broken Packages</guimenuitem></menuchoice> from the menu.
1848
 
        </para>
1849
 
 
1850
 
        <orderedlist>
1851
 
                <listitem>
1852
 
                        <para>
1853
 
                                Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Fix Broken Packages</guimenuitem>
1854
 
                                </menuchoice> from the menu.
1855
 
                        </para>
1856
 
                </listitem>
1857
 
                <listitem>
1858
 
                        <para>
1859
 
                                Apply the marked changes to actually fix the packages:
1860
 
 
1861
 
                                <itemizedlist>
1862
 
                                        <listitem>
1863
 
                                                <para>
1864
 
                                                        Click on <guibutton>Apply</guibutton> in the toolbar.   
1865
 
                                        </para>
1866
 
                                        </listitem>
1867
 
                                        <listitem>
1868
 
                                                <para>
1869
 
                                                        Choose <menuchoice><guimenu>Edit</guimenu>
1870
 
                                                        <guimenuitem>Apply Marked Changes</guimenuitem>
1871
 
                                                        </menuchoice> from the menu.
1872
 
                                                </para>
1873
 
                                        </listitem>
1874
 
                                        <listitem>
1875
 
                                                <para>
1876
 
                                                        Press the key combination 
1877
 
                                                        <keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>.
1878
 
                                                </para>
1879
 
                                        </listitem>
1880
 
                                </itemizedlist>
1881
 
                        </para>
1882
 
                </listitem>
1883
 
                <listitem>
1884
 
                        <para>
1885
 
                                You will be asked for confirmation. Check the summarized changes that will be applied. 
1886
 
                                To continue with the actual repair confirm the changes click on <guibutton>Apply</guibutton>
1887
 
                        </para>
1888
 
                </listitem>
1889
 
                <listitem>
1890
 
                        <para>
1891
 
                                During the processing of the changes you will see a progressbar. Wait until
1892
 
                                the changes have been applied. This can take some time depending on the number
1893
 
                                of changes. Afterwards you will be returned to the main window.
1894
 
                        </para>                         
1895
 
                        <note>
1896
 
                                <para>
1897
 
                                        The progressbar is not available on Debian system. Instead you will
1898
 
                                        see a detailed terminal output.
1899
 
                                </para>
1900
 
                        </note>
1901
 
                </listitem>
1902
 
        </orderedlist>
1903
 
</sect2>
1904
 
 
1905
 
 
1906
 
</sect1>
1907
 
 
1908
 
<sect1 id="synaptic-repo">
1909
 
        <title>Repositories</title>
1910
 
 
1911
 
        <para>
1912
 
                Packages are made available through so called <emphasis>repositories</emphasis>. The repository contains the
1913
 
                packages and an index which includes some basic information about the packages, e.g. required dependencies      
1914
 
                or a short description.
1915
 
        </para>
1916
 
        <para>
1917
 
                Repositories can be located on many medias: CD-Rom/DVD, local hard disk, the Web (http,ftp) 
1918
 
                or remote file system (nfs).
1919
 
        </para>
1920
 
 
1921
 
 
1922
 
<sect2 id="synaptic-repo-update"> 
1923
 
        <title>To Reload the Package Information</title> 
1924
 
        <para>
1925
 
                To collect the list of all available packages from the repositories choose one of the following
1926
 
                methods:
1927
 
        </para>
1928
 
        <itemizedlist>
1929
 
                <listitem>
1930
 
                        <para>
1931
 
                                Choose <menuchoice><guimenu>Edit</guimenu>
1932
 
                                <guimenuitem>Reload Package Information</guimenuitem></menuchoice> from the menu.
1933
 
                        </para>
1934
 
                </listitem>
1935
 
                <listitem>
1936
 
                        <para>
1937
 
                                Click on <guibutton>Reload</guibutton> in the toolbar.
1938
 
                        </para>
1939
 
                </listitem>
1940
 
        </itemizedlist>
1941
 
</sect2>
1942
 
 
1943
 
<sect2 id="synaptic-repo-manage"> 
1944
 
        <title>To Edit, Add or Remove Repositories</title> 
1945
 
        <para>
1946
 
                You can edit, add or delete repositories in the repository preferences.
1947
 
        </para>
1948
 
        <para>
1949
 
                Open the repository editor with <menuchoice><guimenu>Settings</guimenu>
1950
 
                <guimenuitem>Repositories</guimenuitem></menuchoice> from the menu.
1951
 
        </para>
1952
 
 
1953
 
        <figure>
1954
 
                <title>Repository Preferences</title>
1955
 
                <screenshot> 
1956
 
                        <mediaobject> 
1957
 
                                <imageobject>
1958
 
                                        <imagedata fileref="figures/synaptic-repositories.png" 
1959
 
                                                format="PNG"/> 
1960
 
                                </imageobject>
1961
 
                                <textobject> 
1962
 
                                        <phrase>
1963
 
                                                Shows the repository preferences
1964
 
                                        </phrase>
1965
 
                                </textobject> 
1966
 
                        </mediaobject> 
1967
 
                </screenshot> 
1968
 
        </figure>
1969
 
 
1970
 
</sect2>
1971
 
 
1972
 
<sect2 id="synaptic-repo-cdrom"> 
1973
 
        <title>To Add Repositories From CD-ROM</title> 
1974
 
        <para> 
1975
 
                Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Add CD...</guimenuitem></menuchoice>
1976
 
                from the menu.
1977
 
        </para>
1978
 
</sect2>
1979
 
 
1980
 
<sect2 id="synaptic-repo-aptline"> 
1981
 
        <title>The Syntax of the APT line</title> 
1982
 
        <para> 
1983
 
                The package manager stores all available repositories in a text based configuration file. 
1984
 
                Each line describes the type, location and content of one repository.
1985
 
        </para>
1986
 
 
1987
 
        <table frame="topbot" id="table-synaptic-aptline-syntax">
1988
 
                <title>Syntax of an APT line e.g. <emphasis>deb http://ftp.debian.org sarge main</emphasis></title>
1989
 
                <tgroup cols="2" colsep="0" rowsep="0">
1990
 
                        <colspec colname="COLSPEC0" colwidth="30*"/>
1991
 
                        <colspec colname="COLSPEC1" colwidth="70*"/>
1992
 
                        <thead>
1993
 
                                <row rowsep="1">
1994
 
                                        <entry valign="top" align="left">
1995
 
                                                Element
1996
 
                                        </entry>
1997
 
                                        <entry valign="top" align="left">
1998
 
                                                Description
1999
 
                                        </entry>
2000
 
                                </row>
2001
 
                        </thead>
2002
 
                        <tbody>
2003
 
                                <row>
2004
 
                                        <entry valign="top">
2005
 
                                                deb
2006
 
                                        </entry>
2007
 
                                        <entry valign="top">
2008
 
                                                The first elements describes the type of the repository.
2009
 
                                                Possible values are <emphasis>deb</emphasis> (Debian binary packages), <emphasis>deb-src
2010
 
                                                </emphasis>(Debian source packages), <emphasis>rpm</emphasis> (RPM binary packages), 
2011
 
                                                <emphasis>rpm-src</emphasis> (Redhat source packages), <emphasis>rpmdir</emphasis>
2012
 
                                                (folder that contains RPM binary packages) and <emphasis>rpmdir-src</emphasis> 
2013
 
                                                (folder that contains RPM source packages).
2014
 
                                        </entry>
2015
 
                                </row>
2016
 
                                <row>
2017
 
                                        <entry valign="top">
2018
 
                                                http://ftp.debian.org
2019
 
                                        </entry>
2020
 
                                        <entry valign="top">
2021
 
                                                The second element is the location of the repository.
2022
 
                                                The repository can be accessed by the protocols HTTP and 
2023
 
                                                FTP, or locally on a CD, DVD or hard disk.
2024
 
                                        </entry>
2025
 
                                </row>
2026
 
                                <row>
2027
 
                                        <entry valign="top">
2028
 
                                                sarge
2029
 
                                        </entry>
2030
 
                                        <entry valign="top">
2031
 
                                                The third element describes the distribution for which the 
2032
 
                                                packages are made for, see the <ulink 
2033
 
                                                url="http://www.debian.org/doc/packaging-manuals/developers-reference/ch-resources.en.html#s4.6.4">
2034
 
                                                Debian Developer's Reference</ulink> for more details on distributions of Debian.
2035
 
                                        </entry>
2036
 
                                </row>
2037
 
                                <row>
2038
 
                                        <entry valign="top">
2039
 
                                                main
2040
 
                                        </entry>
2041
 
                                        <entry valign="top">
2042
 
                                                The forth element describes sections of the 
2043
 
                                                repository that should be included. By default official Debian repositories are
2044
 
                                                separated into the sections <emphasis>main</emphasis>, <emphasis>
2045
 
                                                contrib</emphasis> and <emphasis>non-free</emphasis>, see the 
2046
 
                                                <ulink
2047
 
                                                 url="http://www.debian.org/doc/packaging-manuals/developers-reference/ch-resources.en.html#s4.6.1">
2048
 
                                                 Debian Developer's Reference</ulink> for more details on sections of Debian.
2049
 
                                        </entry>
2050
 
                                </row>
2051
 
                        </tbody>
2052
 
                </tgroup>
2053
 
        </table>
2054
 
        <para>
2055
 
                <note><para>The distribution and section element are not required for each type.</para></note>
2056
 
        </para>
2057
 
</sect2>
2058
 
 
2059
 
</sect1>
2060
 
 
2061
 
<sect1 id="synaptic-filter">
2062
 
        <title>Custom Filters</title>
2063
 
        <para>
2064
 
                Filters enable you to narrow down the list of shown packages by a variety of package attributes.
2065
 
        </para>
2066
 
        <para>
2067
 
                &app; comes with a set of predefined filters.
2068
 
        </para>
2069
 
 
2070
 
        <table frame="topbot" id="table-synaptic-filters">
2071
 
                <title>Predefined Filters</title>
2072
 
                <tgroup cols="2" colsep="0" rowsep="0">
2073
 
                        <colspec colname="COLSPEC0" colwidth="30*"/>
2074
 
                        <colspec colname="COLSPEC1" colwidth="70*"/>
2075
 
                        <thead>
2076
 
                                <row rowsep="1">
2077
 
                                        <entry valign="top" align="left">
2078
 
                                                Filter
2079
 
                                        </entry>
2080
 
                                        <entry valign="top" align="left">
2081
 
                                                Description
2082
 
                                        </entry>
2083
 
                                </row>
2084
 
                        </thead>
2085
 
                        <tbody>
2086
 
                                <row>
2087
 
                                        <entry valign="top">All packages</entry>
2088
 
                                        <entry valign="top">
2089
 
                                                Display all known packages.
2090
 
                                        </entry>
2091
 
                                </row>
2092
 
                                <row>
2093
 
                                        <entry valign="top">Marked Changes</entry>
2094
 
                                        <entry valign="top">
2095
 
                                                Display all packages that are marked for a status change.
2096
 
                                        </entry>
2097
 
                                </row>
2098
 
                                <row>
2099
 
                                        <entry valign="top">Pkg with Debconf</entry>
2100
 
                                        <entry valign="top">
2101
 
                                                Display all packages that can be configured through debconf
2102
 
                                                (Debian only).
2103
 
                                        </entry>
2104
 
                                </row>
2105
 
                                <row>
2106
 
                                        <entry valign="top">Broken</entry>
2107
 
                                        <entry valign="top">
2108
 
                                                Display only packages with broken dependencies.
2109
 
                                        </entry>
2110
 
                                </row>
2111
 
                                <row>
2112
 
                                        <entry valign="top">Upgradable (upstream)</entry>
2113
 
                                        <entry valign="top">
2114
 
                                                Display all packages that can be upgraded to a later 
2115
 
                                                upstream version.
2116
 
                                        </entry>
2117
 
                                </row>
2118
 
                        </tbody>
2119
 
                </tgroup>
2120
 
        </table>
2121
 
 
2122
 
 
2123
 
        <para>
2124
 
                Because of some interface changes the set of predefined filters changed, too.
2125
 
                The old and deprecated filters are not removed automatically by Synaptic. 
2126
 
        </para>
2127
 
 
2128
 
        <table frame="topbot" id="table-synaptic-filters-deprecated">
2129
 
                <title>Deprecated Filters</title>
2130
 
                <tgroup cols="2" colsep="0" rowsep="0">
2131
 
                        <colspec colname="COLSPEC0" colwidth="30*"/>
2132
 
                        <colspec colname="COLSPEC1" colwidth="70*"/>
2133
 
                        <thead>
2134
 
                                <row rowsep="1">
2135
 
                                        <entry valign="top" align="left">
2136
 
                                                Filter
2137
 
                                        </entry>
2138
 
                                        <entry valign="top" align="left">
2139
 
                                                Description
2140
 
                                        </entry>
2141
 
                                </row>
2142
 
                        </thead>
2143
 
                        <tbody>
2144
 
                                <row>
2145
 
                                        <entry valign="top">Install</entry>
2146
 
                                        <entry valign="top">
2147
 
                                                Display only currently installed packages.
2148
 
                                        </entry>
2149
 
                                </row>
2150
 
                                <row>
2151
 
                                        <entry valign="top">Not installed</entry>
2152
 
                                        <entry valign="top">
2153
 
                                                Display only currently not installed packages.
2154
 
                                        </entry>
2155
 
                                </row>
2156
 
                                <row>
2157
 
                                        <entry valign="top">Upgradable</entry>
2158
 
                                        <entry valign="top">
2159
 
                                                Display only packages with a later version available.
2160
 
                                        </entry>
2161
 
                                </row>
2162
 
                                <row>
2163
 
                                        <entry valign="top">Broken</entry>
2164
 
                                        <entry valign="top">
2165
 
                                                Display only packages with broken dependencies.
2166
 
                                        </entry>
2167
 
                                </row>
2168
 
                                <row>
2169
 
                                        <entry valign="top">Programmed Changes</entry>
2170
 
                                        <entry valign="top">
2171
 
                                                Display only packages marked to be modified.
2172
 
                                        </entry>
2173
 
                                </row>
2174
 
                                <row>
2175
 
                                        <entry valign="top">New in archive</entry>
2176
 
                                        <entry valign="top">
2177
 
                                                Display only new packages since the last 
2178
 
                                                repository update.
2179
 
                                        </entry>
2180
 
                                </row>
2181
 
                                <row>
2182
 
                                        <entry valign="top">Residual</entry>
2183
 
                                        <entry valign="top">
2184
 
                                                Display only former installed packages that left
2185
 
                                                data or configuration files on the system.
2186
 
                                        </entry>
2187
 
                                </row>
2188
 
                                <row>
2189
 
                                        <entry valign="top">Pkg with Debconf</entry>
2190
 
                                        <entry valign="top">
2191
 
                                                Display only packages that can be configured through
2192
 
                                                the debian package configuration system, so called debconf.
2193
 
                                        </entry>
2194
 
                                </row>
2195
 
                                <row>
2196
 
                                        <entry valign="top">Obsolete or locally installed</entry>
2197
 
                                        <entry valign="top">
2198
 
                                                Display only packages that are not (for longer)
2199
 
                                                included in one of the specified repositories.
2200
 
                                        </entry>
2201
 
                                </row>
2202
 
                                <row>
2203
 
                                        <entry valign="top">Search Filter</entry>
2204
 
                                        <entry valign="top">
2205
 
                                                Display the results of the last package search.
2206
 
                                        </entry>
2207
 
                                </row>
2208
 
                        </tbody>
2209
 
                </tgroup>
2210
 
        </table>
2211
 
 
2212
 
<sect2 id="synaptic-filter-apply"> 
2213
 
        <title>To Apply Filters</title> 
2214
 
        <para>
2215
 
                To apply a filter follow these steps:
2216
 
        </para>
2217
 
        <orderedlist>
2218
 
                <listitem>
2219
 
                        <para>
2220
 
                                Choose <guibutton>Custom Filters</guibutton> from the category combobox in 
2221
 
                                the main window.
2222
 
                        </para> 
2223
 
                </listitem>
2224
 
                <listitem>
2225
 
                        <para>
2226
 
                                Choose the wished filter from the <xref linkend="synaptic-win-selector"/>.
2227
 
                        </para>
2228
 
                </listitem>
2229
 
        </orderedlist>
2230
 
</sect2>
2231
 
 
2232
 
<sect2 id="synaptic-filter-edit" xreflabel="filter editor"> 
2233
 
        <title>To Edit or Create Custom Filters</title> 
2234
 
 
2235
 
        <para>
2236
 
                Filters can be created, deleted and modified in the filter editor:
2237
 
        </para>
2238
 
 
2239
 
        <para>
2240
 
                Choose <menuchoice><guimenu>Settings</guimenu><guimenuitem>
2241
 
                Filters</guimenuitem></menuchoice> from the menu.
2242
 
        </para>
2243
 
 
2244
 
        <figure>
2245
 
                <title>Edit Filters</title> 
2246
 
                <screenshot> 
2247
 
                        <mediaobject> 
2248
 
                                <imageobject>
2249
 
                                        <imagedata fileref="figures/synaptic-filter.png" 
2250
 
                                                format="PNG"/> 
2251
 
                                </imageobject>
2252
 
                                <textobject> 
2253
 
                                        <phrase>
2254
 
                                                Shows the filter editor.
2255
 
                                        </phrase>
2256
 
                                </textobject> 
2257
 
                        </mediaobject> 
2258
 
                </screenshot> 
2259
 
        </figure>
2260
 
 
2261
 
        <para>
2262
 
                The filter editor contains the following components:
2263
 
        </para>
2264
 
        
2265
 
        <variablelist>
2266
 
                <varlistentry>
2267
 
                        <term>
2268
 
                                List of Filter
2269
 
                        </term>
2270
 
                        <listitem>
2271
 
                                <para>
2272
 
                                        Shows a list of available filters.
2273
 
                                </para>
2274
 
                        </listitem>
2275
 
                </varlistentry>
2276
 
                <varlistentry>
2277
 
                        <term>
2278
 
                                Rules
2279
 
                        </term>
2280
 
                        <listitem>
2281
 
                                <para>
2282
 
                                        Rules allow you to define which packages should be shown in the list.
2283
 
                                        A package has to fulfill all selected criteria.
2284
 
                                </para>
2285
 
                                <variablelist>
2286
 
                                        <varlistentry>
2287
 
                                                <term>
2288
 
                                                        Status
2289
 
                                                </term>
2290
 
                                                <listitem>
2291
 
                                                        <para>
2292
 
                                                                Allows you to search packages by status.
2293
 
                                                        </para>
2294
 
                                                </listitem>
2295
 
                                        </varlistentry>
2296
 
                                        <varlistentry>
2297
 
                                                <term>
2298
 
                                                        Section
2299
 
                                                </term>
2300
 
                                                <listitem>
2301
 
                                                        <para>
2302
 
                                                                Allows you to search packages by section.
2303
 
                                                        </para>
2304
 
                                                </listitem>
2305
 
                                        </varlistentry>
2306
 
                                        <varlistentry>
2307
 
                                                <term>
2308
 
                                                        Properties
2309
 
                                                </term>
2310
 
                                                <listitem>
2311
 
                                                        <para>
2312
 
                                                                Allows you to search packages by a variety of
2313
 
                                                                attributes e.g. name, dependencies or origin.
2314
 
                                                        </para>
2315
 
                                                </listitem>
2316
 
                                        </varlistentry>
2317
 
                                        <varlistentry>
2318
 
                                                <term>
2319
 
                                                        Keywords
2320
 
                                                </term>
2321
 
                                                <listitem>
2322
 
                                                        <para>
2323
 
                                                                Keywords are based on debtags. Only Debian GNU/Linux 
2324
 
                                                                with installed "debtags" supports this feature.
2325
 
                                                        </para>
2326
 
                                                </listitem>
2327
 
                                        </varlistentry>
2328
 
                                </variablelist>
2329
 
                        </listitem>
2330
 
                </varlistentry>
2331
 
        </variablelist>
2332
 
 
2333
 
</sect2>
2334
 
</sect1>
2335
 
 
2336
 
 
2337
 
 
2338
 
 
2339
 
<!-- sect1 id="snyaptic-prefs">
2340
 
        <title>Settings</title>
2341
 
 
2342
 
        NEEDS SOME LOVE - THEREFOR DISABLED
2343
 
 
2344
 
<sect2 id="synaptic-prefs-general" xreflabel="action preferences"> 
2345
 
        <title>General</title> 
2346
 
        <para>
2347
 
                The general preferences include the following settings:
2348
 
        </para>
2349
 
        
2350
 
        <variablelist>
2351
 
                <varlistentry>
2352
 
                        <term>
2353
 
                                General
2354
 
                        </term>
2355
 
                        <listitem>
2356
 
                                <variablelist>
2357
 
                                        <varlistentry>
2358
 
                                                <term>
2359
 
                                                        Allow regular expressions in searches and filters
2360
 
                                                </term>
2361
 
                                                        <listitem>
2362
 
                                                                <para>
2363
 
                                                                        Regular expression are an advanced method of text
2364
 
                                                                        matching.
2365
 
                                                                </para>
2366
 
                                                        </listitem>
2367
 
                                        </varlistentry>
2368
 
                                        <varlistentry>
2369
 
                                                <term>
2370
 
                                                        Consider recommended packages as dependencies
2371
 
                                                </term>
2372
 
                                                        <listitem>
2373
 
                                                                <para>
2374
 
                                                                        Regular expression are an advanced method of text
2375
 
                                                                        matching.
2376
 
                                                                </para>
2377
 
                                                        </listitem>
2378
 
                                        </varlistentry>
2379
 
                                </variablelist>
2380
 
                        </listitem>
2381
 
                </varlistentry>
2382
 
                <varlistentry>
2383
 
                        <term>
2384
 
                                Actions
2385
 
                        </term>
2386
 
                        <listitem>
2387
 
                                <anchor id="synaptic-prefs-actions" xreflabel="action settings"/>
2388
 
                                <variablelist>
2389
 
                                        <varlistentry>
2390
 
                                                <term>
2391
 
                                                        Apply changes in a terminal window
2392
 
                                                </term>
2393
 
                                                        <listitem>
2394
 
                                                                <para>
2395
 
                                                                        Regular expression are an advanced method of text
2396
 
                                                                        matching.
2397
 
                                                                </para>
2398
 
                                                        </listitem>
2399
 
                                        </varlistentry>
2400
 
                                        <varlistentry>
2401
 
                                                <term>
2402
 
                                                        Ask to quit after the changes have been applied successfully
2403
 
                                                </term>
2404
 
                                                        <listitem>
2405
 
                                                                <para>
2406
 
                                                                        Regular expression are an advanced method of text
2407
 
                                                                        matching.
2408
 
                                                                </para>
2409
 
                                                        </listitem>
2410
 
                                        </varlistentry>
2411
 
                                        <varlistentry>
2412
 
                                                <term>
2413
 
                                                        Remove package
2414
 
                                                </term>
2415
 
                                                        <listitem>
2416
 
                                                                <para>
2417
 
                                                                        Regular expression are an advanced method of text
2418
 
                                                                        matching.
2419
 
                                                                </para>
2420
 
                                                        </listitem>
2421
 
                                        </varlistentry>
2422
 
                                        <varlistentry>
2423
 
                                                <term>
2424
 
                                                        Upgrade method
2425
 
                                                </term>
2426
 
                                                        <listitem>
2427
 
                                                                <para>
2428
 
                                                                        Regular expression are an advanced method of text
2429
 
                                                                        matching.
2430
 
                                                                </para>
2431
 
                                                        </listitem>
2432
 
                                        </varlistentry>
2433
 
                                        <varlistentry>
2434
 
                                                <term>
2435
 
                                                        Number of undo operations
2436
 
                                                </term>
2437
 
                                                        <listitem>
2438
 
                                                                <para>
2439
 
                                                                        Regular expression are an advanced method of text
2440
 
                                                                        matching.
2441
 
                                                                </para>
2442
 
                                                        </listitem>
2443
 
                                        </varlistentry>
2444
 
                                        <varlistentry>
2445
 
                                                <term>
2446
 
                                                        Confirm actions also affecting other packages
2447
 
                                                </term>
2448
 
                                                        <listitem>
2449
 
                                                                <para>
2450
 
                                                                        Regular expression are an advanced method of text
2451
 
                                                                        matching.
2452
 
                                                                </para>
2453
 
                                                        </listitem>
2454
 
                                        </varlistentry>
2455
 
                                </variablelist>
2456
 
                        </listitem>
2457
 
                </varlistentry>
2458
 
        </variablelist>
2459
 
</sect2>
2460
 
 
2461
 
<sect2 id="synaptic-prefs-layout"> 
2462
 
        <title>Layout</title> 
2463
 
        <para>
2464
 
                You can change the appearance of Synaptic.
2465
 
        </para>
2466
 
        <variablelist>
2467
 
                <varlistentry>
2468
 
                        <term>
2469
 
                                Main Window
2470
 
                        </term>
2471
 
                        <listitem>
2472
 
                                <para>
2473
 
                                        Choose between two different layouts of the main window.
2474
 
                                </para>
2475
 
                        </listitem>
2476
 
                </varlistentry>
2477
 
                <varlistentry>
2478
 
                        <term>
2479
 
                                Fonts
2480
 
                        </term>
2481
 
                        <listitem>
2482
 
                                <para>
2483
 
                                        Specify custom fonts for the application and the terminal output.
2484
 
                                </para>
2485
 
                        </listitem>
2486
 
                </varlistentry>
2487
 
        </variablelist>
2488
 
</sect2>
2489
 
 
2490
 
<sect2 id="synaptic-prefs-ordercolor"> 
2491
 
        <title>Column Order and Colours</title> 
2492
 
        <para>
2493
 
                Modify the appearance of the package list in the main window.
2494
 
        </para>
2495
 
        <variablelist>
2496
 
                <varlistentry>
2497
 
                        <term>
2498
 
                                Column Order
2499
 
                        </term>
2500
 
                        <listitem>
2501
 
                                <para>
2502
 
                                        Order the columns of the package list. A value of -1 hides the column.
2503
 
                                </para>
2504
 
                        </listitem>
2505
 
                </varlistentry>
2506
 
                <varlistentry>
2507
 
                        <term>
2508
 
                                Colors
2509
 
                        </term>
2510
 
                        <listitem>
2511
 
                                <para>
2512
 
                                        Assign colors to visualize the package status.
2513
 
                                </para>
2514
 
                        </listitem>
2515
 
                </varlistentry>
2516
 
        </variablelist>
2517
 
 
2518
 
</sect2>    
2519
 
 
2520
 
<sect2 id="synaptiac-prefs-temp"> 
2521
 
        <title>Temporary Files</title> 
2522
 
        <para>
2523
 
                Configure the management of completely or partially downloaded package files.
2524
 
        </para>
2525
 
</sect2> 
2526
 
 
2527
 
<sect2 id="synaptiac-prefs-network"> 
2528
 
        <title>Network</title> 
2529
 
        <para> 
2530
 
                Configure the Internet connection and proxy server.
2531
 
        </para>
2532
 
</sect2> 
2533
 
 
2534
 
<sect2 id="synaptiac-prefs-expert"> 
2535
 
        <title>Expert</title>
2536
 
        <para>
2537
 
                Undocumented.   
2538
 
        </para>
2539
 
</sect2> 
2540
 
</sect1 -->
2541
 
 
2542
 
<sect1 id="synaptic-bugs">
2543
 
        <title>Known Bugs and Limitations</title>
2544
 
        <para>
2545
 
                
2546
 
 
2547
 
        <table frame="topbot" id="synaptic-bugs-table">
2548
 
                <title>Known issues and workarounds</title>
2549
 
                <tgroup cols="2" colsep="0" rowsep="0">
2550
 
                        <colspec colname="COLSPEC0" colwidth="30*"/>
2551
 
                        <colspec colname="COLSPEC1" colwidth="70*"/>
2552
 
                        <thead>
2553
 
                                <row rowsep="1">
2554
 
                                        <entry valign="top" align="left">
2555
 
                                                Problem
2556
 
                                        </entry>
2557
 
                                        <entry valign="top" align="left">
2558
 
                                                Workaround
2559
 
                                        </entry>
2560
 
                                </row>
2561
 
                        </thead>
2562
 
                        <tbody>
2563
 
                                <row>
2564
 
                                        <entry valign="top">
2565
 
                                                Unsupported locale
2566
 
                                        </entry>
2567
 
                                        <entry valign="top">
2568
 
                                                Use a locale supported by Xlib.
2569
 
                                        </entry>
2570
 
                                </row>
2571
 
                                <row>
2572
 
                                        <entry valign="top">
2573
 
                                                A failed installation blocks further operations in synaptic
2574
 
                                        </entry>
2575
 
                                        <entry valign="top">
2576
 
                                                <para>
2577
 
                                                        Under some rare circumstances the actual installation or removal of a package can fail. 
2578
 
                                                        As a consequence all other marked changes are canceled, too. 
2579
 
                                                </para>
2580
 
                                                <para>
2581
 
                                                        &app; requires a 
2582
 
                                                        clear environment with no half installed packages 
2583
 
                                                        to perform additional changes. But at the moment there is no way to continue
2584
 
                                                        canceled installations within &app;.
2585
 
                                                </para>
2586
 
                                                <para>
2587
 
                                                        To fix this situation type the following command in a terminal, then press
2588
 
                                                        <keycap>Return</keycap>:
2589
 
                                                </para>
2590
 
                                                <command>
2591
 
                                                        apt-get install -f
2592
 
                                                </command>
2593
 
                                        </entry>
2594
 
                                </row>
2595
 
                        </tbody>
2596
 
                </tgroup>
2597
 
        </table>
2598
 
        </para>
2599
 
</sect1>
2600
 
 
2601
 
<sect1 id="synaptic-shortcuts">
2602
 
        <title>Keyboard Shortcuts</title>
2603
 
        <para>
2604
 
                List of all global short cuts in &app;:
2605
 
        </para>
2606
 
        <informaltable frame="none" id="synaptic-shortcuts-table">
2607
 
        
2608
 
                <tgroup cols="2" colsep="0" rowsep="0">
2609
 
                        <colspec colname="COLSPEC0" colwidth="30*"/>
2610
 
                        <colspec colname="COLSPEC1" colwidth="70*"/>
2611
 
                        <tbody>
2612
 
                                <row>
2613
 
                                        <entry valign="top">
2614
 
                                                Reload the list of known packages
2615
 
                                        </entry>
2616
 
                                        <entry valign="top">
2617
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>
2618
 
                                        </entry>
2619
 
                                </row>
2620
 
                                <row>
2621
 
                                        <entry valign="top">
2622
 
                                                Open the package search dialog
2623
 
                                        </entry>
2624
 
                                        <entry valign="top">
2625
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>
2626
 
                                        </entry>
2627
 
                                </row>
2628
 
                                <row>
2629
 
                                        <entry valign="top">
2630
 
                                                Open the properties dialog for the selected package
2631
 
                                        </entry>
2632
 
                                        <entry valign="top">
2633
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>
2634
 
                                        </entry>
2635
 
                                </row>
2636
 
                                <row>
2637
 
                                        <entry valign="top">
2638
 
                                                Mark the selected package(s) for installation
2639
 
                                        </entry>
2640
 
                                        <entry valign="top">
2641
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>I</keycap></keycombo>
2642
 
                                        </entry>
2643
 
                                </row>
2644
 
                                <row>
2645
 
                                        <entry valign="top">
2646
 
                                                Mark the selected package(s) for upgrade
2647
 
                                        </entry>
2648
 
                                        <entry valign="top">
2649
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>
2650
 
                                        </entry>
2651
 
                                </row>
2652
 
                                <row>
2653
 
                                        <entry valign="top">
2654
 
                                                Mark the selected package(s) for removal
2655
 
                                        </entry>
2656
 
                                        <entry valign="top">
2657
 
                                                <keycap>Delete</keycap>
2658
 
                                        </entry>
2659
 
                                </row>
2660
 
                                <row>
2661
 
                                        <entry valign="top">
2662
 
                                                Mark the selected package(s) for complete removal (Debian only)
2663
 
                                        </entry>
2664
 
                                        <entry valign="top">
2665
 
                                                <keycombo><keycap>Shift</keycap><keycap>Delete</keycap></keycombo>
2666
 
                                        </entry>
2667
 
                                </row>
2668
 
                                <row>
2669
 
                                        <entry valign="top">
2670
 
                                                Unmark any changes to the selected package(s)
2671
 
                                        </entry>
2672
 
                                        <entry valign="top">
2673
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo>
2674
 
                                        </entry>
2675
 
                                </row>
2676
 
                                <row>
2677
 
                                        <entry valign="top">
2678
 
                                                Mark all possible upgrades
2679
 
                                        </entry>
2680
 
                                        <entry valign="top">
2681
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>G</keycap></keycombo>
2682
 
                                        </entry>
2683
 
                                </row>
2684
 
                                <row>
2685
 
                                        <entry valign="top">
2686
 
                                                Force the installation of a specific version of the package
2687
 
                                        </entry>
2688
 
                                        <entry valign="top">
2689
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>
2690
 
                                        </entry>
2691
 
                                </row>
2692
 
                                <row>
2693
 
                                        <entry valign="top">
2694
 
                                                Undo the last status change to a package and to the
2695
 
                                                therefor required dependencies
2696
 
                                        </entry>
2697
 
                                        <entry valign="top">
2698
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>
2699
 
                                        </entry>
2700
 
                                </row>
2701
 
                                <row>
2702
 
                                        <entry valign="top">
2703
 
                                                Redo the last reverted status change to a package and to the
2704
 
                                                therefor required dependencies
2705
 
                                        </entry>
2706
 
                                        <entry valign="top">
2707
 
                                                <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap>
2708
 
                                                <keycap>Z</keycap></keycombo>
2709
 
                                        </entry>
2710
 
                                </row>
2711
 
                                <row>
2712
 
                                        <entry valign="top">
2713
 
                                                Apply all marked changes
2714
 
                                        </entry>
2715
 
                                        <entry valign="top">
2716
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>
2717
 
                                        </entry>
2718
 
                                </row>
2719
 
                                <row>
2720
 
                                        <entry valign="top">
2721
 
                                                Quit &app;
2722
 
                                        </entry>
2723
 
                                        <entry valign="top">
2724
 
                                                <keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
2725
 
                                        </entry>
2726
 
                                </row>
2727
 
                                <row>
2728
 
                                        <entry valign="top">
2729
 
                                                Show the manual of &app;
2730
 
                                        </entry>
2731
 
                                        <entry valign="top">
2732
 
                                                <keycap>F1</keycap>
2733
 
                                        </entry>
2734
 
                                </row>
2735
 
                        </tbody>
2736
 
                </tgroup>
2737
 
        </informaltable>
2738
 
</sect1>
2739
 
 
2740
 
 
2741
 
<sect1 id="myapp-about"> 
2742
 
        <title>About &app;</title> 
2743
 
        <para> 
2744
 
                &app; was originally written by Alfredo K. Kojima (<email>kojima@windowmaker.org</email>)
2745
 
                and is now maintained by Michael Vogt (<email>mvo@debian.org</email>) and
2746
 
                Gustavo Niemeyer (<email>niemeyer@conectiva.com</email>).
2747
 
                To get more information about &app;, please visit the 
2748
 
                <ulink url="http://www.nongnu.org/synaptic" type="http">Synaptic Web Page</ulink>.
2749
 
        </para>
2750
 
        <para>
2751
 
                To report a bug or make a suggestion regarding &app; 
2752
 
                or this manual, use the bug report system on the <ulink 
2753
 
                url="http://www.nongnu.org/synaptic" type="http">Synaptic Web Site</ulink>, contact 
2754
 
                the mailing list <email>synaptic@nongnu.org</email> or join the IRC channel 
2755
 
                #synaptic on irc.freenode.org.
2756
 
        </para>
2757
 
        <para> 
2758
 
                This program is distributed under the terms of the GNU
2759
 
                Public license as published by the Free Software; either version 2 of the License, 
2760
 
                or (at your option) later version. A copy of this license can be found in
2761
 
                , or in the file included with 
2762
 
                the source code of this program. 
2763
 
        </para>
2764
 
</sect1> 
2765
 
 
2766
 
<!-- Appendix with GPL -->
2767
 
&legal;
2768
 
</article>