~ubuntu-core-dev/synaptic/ubuntu : revision 1076

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.52">

5

<!ENTITY appversion "0.53">

6

<!ENTITY app "<application>Synaptic Package Manager</application>">

7

<!ENTITY manrevision "0.1">

7

<!ENTITY manrevision "0.1.1">

8

<!ENTITY date "October 2003">

9

]>

10

41

</releaseinfo>

42

43

44

<title>

45

Legal Notice

46

</title>

44

<title>Legal Notice</title>

47

45

<para>

48

46

This document is distributed under the terms of the GNU

49

47

Public license as published by the Free Software; either version 2 of the License,

54

52

</legalnotice>

55

53

56

54

57

<title>

58

Feedback

59

</title>

55

<title>Feedback</title>

60

56

<para>

61

57

To report a bug or make a suggestion regarding

62

58

the &app; or this manual, use the bug report

81

77

</indexterm>

82

78

83

79

84

<title>

85

Introduction

86

</title>

80

<title>Introduction</title>

87

81

<para>

88

The &app; enables you to install software onto your computer and to manage the software that is

82

The &app; enables you to install software onto your computer and to manage the software, that is

89

83

already installed. The software is bundled in so called <emphasis>packages</emphasis>. A single

90

84

application can even exist of several packages: e.g. the <application>Mozilla Internet Suite</application> is packaged

91

to <emphasis>mozilla-browser</emphasis> that contains the actual browser and <emphasis>mozilla-mail

92

</emphasis> that contains the mail client (this example refers to Debian GNU/Linux and can be

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

93

87

different on your distribution).

94

88

</para>

95

89

<para>

96

To avoid duplications most applications reuse the functionality of other applications or libraries

90

Nearly all applications reuse the functionality of other applications or libraries

97

91

(libraries only provide functions to other libraries or applications and are no stand alone

98

applications). So the most packages depend on other packages. The &app; resolves the <emphasis>

92

applications) to avoid doubled efforts. So the most packages depend on other packages. The &app; resolves the <emphasis>

99

93

dependencies</emphasis> for you automatically.

100

94

</para>

101

95

<para>

102

Technically the &app; is based on the package manager <application>APT</application> and provides functions that are

96

Technically the &app; is based on the package manager <application>APT</application> and provides functions, that are

103

97

similar to the ones of the command line tool <command>apt-get</command> in a graphical environment.

104

98

</para>

105

99

<para>

123

117

</listitem>

124

118

125

119

<para>

126

Find packages by name, description and several other attributes.

120

Search packages by name, description and several other attributes.

127

121

</para>

128

122

</listitem>

129

123

148

142

</listitem>

149

143

150

144

<para>

151

Force the installation of a specifc package version.

145

Force the installation of a specific package version.

152

146

</para>

153

147

</listitem>

154

148

</itemizedlist>

155

149

</para>

156

150

<note>

157

151

<para>

158

You need root rights to install or modify software packages on your computer.

152

You need root rights to install or remove software packages on your computer.

159

153

</para>

160

154

</note>

161

155

317

311

</sect2>

318

312

319

313

320

<title>

321

Toolbar

322

</title>

314

<title>Toolbar</title>

323

315

324

316

325

<title>

326

&app; toolbar

327

</title>

317

<title>&app; toolbar</title>

328

318

329

319

330

320

346

336

347

337

348

338

<term>

349

Refresh

339

Reload

350

340

</term>

351

341

352

342

<para>

353

Refresh the list of known packages.

343

Reload the list of known packages.

354

344

</para>

355

345

</listitem>

356

346

</varlistentry>

357

347

358

348

<term>

359

Upgrade System

349

Mark all Upgrades

360

350

</term>

361

351

362

352

<para>

380

370

</term>

381

371

382

372

<para>

383

Open the <xref linkend="synaptic-win-properties"/> dialog(s) of the selected package(s).

373

Open the <xref linkend="synaptic-win-properties"/> dialog of the selected package.

384

374

</para>

385

375

</listitem>

386

376

</varlistentry>

387

377

388

378

<term>

389

Find

379

Search

390

380

</term>

391

381

392

382

<para>

393

Open the find dialog.

383

Open the package search dialog.

394

384

</para>

395

385

</listitem>

396

386

</varlistentry>

398

388

</para>

399

389

</sect2>

400

390

401

402

<title>

403

Category Selector

404

</title>

391

392

<title>Category Selector</title>

405

393

406

394

<para>

407

The selector on the left side allows to narrow down the packages listed in the <xref linkend="synaptic-win-list"/>

395

The selector on the left side allows you to narrow down the packages, that are shown in the <xref linkend="synaptic-win-list"/>

408

396

by categories.

409

397

</para>

410

398

475

463

</varlistentry>

476

464

477

465

<term>

478

Find history

466

Search history

479

467

</term>

480

468

481

469

<para>

490

478

491

479

492

480

493

<title>

494

Package List

495

</title>

481

<title>Package List</title>

496

482

497

483

<para>

498

484

The package list shows the packages of the selected category.

526

512

527

513

<tip>

528

514

<para>

529

The column order and the used colors can be changed in the preferences, see

530

<xref linkend="synaptic-prefs-ordercolor"/>.

515

The column order and the used colors can be changed in the preferences.

531

516

</para>

532

517

</tip>

533

518

</sect2>

534

519

535

520

536

521

537

<title>

538

Package Properties

539

</title>

522

<title>Package Properties</title>

540

523

541

524

<para>

542

525

To open the properties dialog of a selected package:

555

538

</listitem>

556

539

557

540

<para>

558

Press the key combination <keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>

541

Press the key combination <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>

559

542

</para>

560

543

</listitem>

561

544

</itemizedlist>

583

566

The notebook provides the following tabs:

584

567

585

568

586

<title>

587

Tabs in the properties dialog

588

</title>

569

<title>Tabs in the properties dialog</title>

589

570

590

571

591

572

634

615

</sect1>

635

616

636

617

637

638

<title>

639

Browsing and Finding Packages

640

</title>

641

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

642

624

643

625

<title>

644

626

To Browse the List of Known Packages (FIXME)

684

666

685

667

686

668

687

<title>

688

To Find and Browse Packages (FIXME)

689

</title>

669

<title>To Find and Browse Packages (FIXME)</title>

690

670

691

671

692

672

807

787

</varlistentry>

808

788

</variablelist>

809

789

</sect2>

810

</sect1>

790

</sect1 -->

811

791

812

<title>

813

Managing Packages

814

</title>

792

<title>Managing Packages</title>

815

793

816

794

<para>

817

795

This chapter covers the basic actions <xref linkend="anchor-installing"/>,

822

800

Furthermore performing a <xref linkend="anchor-dist-upgrade"/>,

823

801

<xref linkend="anchor-dwww"/> the online documentation,

824

802

<xref linkend="anchor-changelog"/> the changelog and the advanced actions

825

<xref linkend="anchor-force"/> the installation of a specifc package version,

826

<xref linkend="anchor-lock"/> a package to the current version are descripted.

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.

827

805

</para>

828

806

829

807

830

<title>

831

To Install Packages

832

</title>

808

<title>To Install Packages</title>

833

809

834

810

835

811

836

812

<note>

837

813

<para>

838

814

If different version of the same package are available &app; will select the most

839

applicable by default. To force the installation of a specific version that is differnet

815

applicable by default. To force the installation of a specific version that is different

840

816

to the default one, see <xref linkend="synaptic-pkg-force"/>.

841

817

</para>

842

818

</note>

843

819

844

820

<para>

845

If you have <xref linkend="anchor-find"/> a package that you want to install

846

perform the following steps:

821

If you want to install a package perform the following steps:

847

822

</para>

848

823

849

824

850

825

<para>

851

Refresh the list of known packages to be aware of the latest version available:

826

Reload the list of known packages to be aware of the latest version available:

852

827

853

828

854

829

855

830

<para>

856

831

Choose <menuchoice><guimenu>Edit</guimenu>

857

<guimenuitem>Refresh Package List</guimenuitem>

832

<guimenuitem>Reload Package List</guimenuitem>

858

833

</menuchoice> from the menu.

859

834

</para>

860

835

</listitem>

861

836

862

837

<para>

863

Click on <guibutton>Refresh</guibutton> in the toolbar.

838

Click on <guibutton>Reload</guibutton> in the toolbar.

864

839

</para>

865

840

</listitem>

866

841

867

842

<para>

868

843

Press the key combination

869

<keycombo><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>.

844

<keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.

870

845

</para>

871

846

</listitem>

872

847

</itemizedlist>

939

914

940

915

<para>

941

916

Press the key combination

942

<keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>.

917

<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.

943

918

</para>

944

919

</listitem>

945

920

</itemizedlist>

954

929

955

930

<para>

956

931

During the processing of the changes you will see a progressbar. Wait until

957

the changes have been applied. This can take some time depending on the size

958

of the changes. Afterwards you will be returned to the main window.

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.

959

934

</para>

960

935

<note>

961

936

<para>

962

937

The progressbar is not available on Debian system. Instead you will

963

938

see a detailed terminal output.

964

</para>

939

</para>

965

940

</note>

966

941

</listitem>

967

942

</orderedlist>

978

953

from the system by default.

979

954

</para>

980

955

<para>

981

<emphasis>Debian only:</emphasis> You can change the default behavior in the

982

<xref linkend="synaptic-prefs-action"/>.

956

<emphasis>Debian only:</emphasis> You can change the default behavior in the preferences.

983

957

</para>

984

958

<para>

985

959

<emphasis>Debian only:</emphasis> To remove all files related to the package

1037

1011

1038

1012

<para>

1039

1013

Select the package and

1040

press the key combination <keycombo>

1041

<keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.

1014

press the key <keycap>Delete</keycap>.

1042

1015

</para>

1043

1016

</listitem>

1044

1017

</itemizedlist>

1061

1034

</listitem>

1062

1035

1063

1036

<para>

1064

Choose <menuchoice><guimenu>Actions</guimenu>

1037

Choose <menuchoice><guimenu>Edit</guimenu>

1065

1038

<guimenuitem>Apply Marked Changes</guimenuitem>

1066

1039

</menuchoice> from the menu.

1067

1040

</para>

1069

1042

1070

1043

<para>

1071

1044

Press the key combination

1072

<keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>.

1045

<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.

1073

1046

</para>

1074

1047

</listitem>

1075

1048

</itemizedlist>

1084

1057

1085

1058

<para>

1086

1059

During the processing of the changes you will see a progressbar. Wait until

1087

the changes have been applied. This can take some time depending on the size

1088

of the changes. Afterwards you will be returned to the main window.

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.

1089

1062

</para>

1090

1063

<note>

1091

1064

<para>

1092

1065

The progressbar is not available on Debian system. Instead you will

1093

1066

see a detailed terminal output.

1094

</para>

1067

</para>

1095

1068

</note>

1096

1069

</listitem>

1097

1070

</orderedlist>

1098

1071

</sect2>

1099

1072

1100

<title>

1101

To Upgrade Packages

1102

</title>

1073

<title>To Upgrade Packages</title>

1103

1074

1104

1075

1105

1076

1109

1080

1110

1081

1111

1082

<para>

1112

Refresh the list of known packages to be aware of the latest version available:

1083

Reload the list of known packages to be aware of the latest version available:

1113

1084

1114

1085

1115

1086

1116

1087

<para>

1117

1088

Choose <menuchoice><guimenu>Edit</guimenu>

1118

<guimenuitem>Refresh Package List</guimenuitem></menuchoice>

1089

<guimenuitem>Reload Package List</guimenuitem></menuchoice>

1119

1090

from the menu.

1120

1091

</para>

1121

1092

</listitem>

1122

1093

1123

1094

<para>

1124

Click on <guibutton>Refresh</guibutton> in the toolbar.

1095

Click on <guibutton>Reload</guibutton> in the toolbar.

1125

1096

</para>

1126

1097

</listitem>

1127

1098

1128

1099

<para>

1129

1100

Press the key combination

1130

<keycombo><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>.

1101

<keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.

1131

1102

</para>

1132

1103

</listitem>

1133

1104

</itemizedlist>

1136

1107

1137

1108

1138

1109

<para>

1139

Marked the package for upgrade:

1110

Mark the package for upgrade:

1140

1111

1141

1112

1142

1113

1170

1141

<para>

1171

1142

Select the package and

1172

1143

press the key combination

1173

<keycombo><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>.

1144

<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.

1174

1145

</para>

1175

1146

</listitem>

1176

1147

</itemizedlist>

1200

1171

1201

1172

<para>

1202

1173

Press the key combination

1203

<keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>.

1174

<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.

1204

1175

</para>

1205

1176

</listitem>

1206

1177

</itemizedlist>

1214

1185

1215

1186

<para>

1216

1187

During the processing of the changes you will see a progressbar. Wait until

1217

the changes have been applied. This can take some time depending on the size

1218

of the changes. Afterwards you will be returned to the main window.

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.

1219

1190

</para>

1220

1191

<note>

1221

1192

<para>

1222

1193

The progressbar is not available on Debian system. Instead you will

1223

1194

see a detailed terminal output.

1224

</para>

1195

</para>

1225

1196

</note>

1226

1197

</listitem>

1227

1198

</orderedlist>

1235

1206

1236

1207

1237

1208

1238

<title>

1239

To Upgrade the Whole System

1240

</title>

1209

<title>To Upgrade the Whole System</title>

1241

1210

1242

1211

1243

1244

1245

<para>

1246

The global upgrade enables you to upgrade your system

1247

to the latest version without having to mark and validate each package upgrade manually.

1248

</para>

1249

1212

1250

1213

<para>

1251

&app; provides two global upgrade methods:

1214

&app; provides two methods for marking packages for upgrade:

1252

1215

1253

1216

1254

1217

<term>

1255

Upgrade

1218

Default Upgrade

1256

1219

</term>

1257

1220

1258

1221

<para>

1270

1233

1271

1234

<para>

1272

1235

The smart upgrade method tries to resolve package conflicts intelligently. This includes

1273

installing additional required packages and prefering packages with

1236

installing additional required packages and preferring packages with

1274

1237

higher priority.

1275

1238

</para>

1276

1239

<para>

1295

1258

1296

1259

1297

1260

<para>

1298

Refresh the list of known packages to be aware of the latest version available:

1261

Reload the list of known packages to be aware of the latest version available:

1299

1262

1300

1263

1301

1264

1302

1265

<para>

1303

1266

Choose <menuchoice><guimenu>Edit</guimenu>

1304

<guimenuitem>Refresh Package List</guimenuitem></menuchoice> from the menu.

1267

<guimenuitem>Reload Package List</guimenuitem></menuchoice> from the menu.

1305

1268

</para>

1306

1269

</listitem>

1307

1270

1308

1271

<para>

1309

Click on <guibutton>Refresh</guibutton> in the toolbar.

1272

Click on <guibutton>Reload</guibutton> in the toolbar.

1310

1273

</para>

1311

1274

</listitem>

1312

1275

1313

1276

<para>

1314

1277

Press the key combination <keycombo>

1315

<keycap>Ctrl</keycap><keycap>U</keycap></keycombo>.

1278

<keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.

1316

1279

</para>

1317

1280

</listitem>

1318

1281

</itemizedlist>

1321

1284

1322

1285

1323

1286

<para>

1324

Mark the package(s) for upgrade:

1287

Mark all possible upgrades:

1325

1288

1326

1289

1327

1290

1328

1291

<para>

1329

Click on <guibutton>Upgrade System

1292

Click on <guibutton>Mark all Upgrades

1330

1293

</guibutton> in the toolbar.

1331

1294

</para>

1332

1295

</listitem>

1333

1296

1334

1297

<para>

1335

1298

Choose <menuchoice><guimenu>Edit</guimenu>

1336

<guimenuitem>Upgrade System</guimenuitem>

1299

<guimenuitem>Mark all Upgrades</guimenuitem>

1337

1300

</menuchoice> from the menu.

1338

1301

</para>

1339

1302

</listitem>

1359

1322

1360

1323

1361

1324

<para>

1362

Click on <guibutton>Apply Changes</guibutton> in the toolbar.

1325

Click on <guibutton>Apply</guibutton> in the toolbar.

1363

1326

</para>

1364

1327

</listitem>

1365

1328

1372

1335

1373

1336

<para>

1374

1337

Press the key combination

1375

<keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>.

1338

<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.

1376

1339

</para>

1377

1340

</listitem>

1378

1341

</itemizedlist>

1387

1350

1388

1351

<para>

1389

1352

During the processing of the changes you will see a progressbar. Wait until

1390

the changes have been applied. This can take some time depending on the size

1391

of the changes. Afterwards you will be returned to the main window.

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.

1392

1355

</para>

1393

1356

<note>

1394

1357

<para>

1395

1358

The progressbar is not available on Debian system. Instead you will

1396

1359

see a detailed terminal output.

1397

</para>

1360

</para>

1398

1361

</note>

1399

1362

</listitem>

1400

1363

</orderedlist>

1401

1364

1402

1365

<tip>

1403

1366

<para>

1404

You can change the default upgrade method in the

1405

<xref linkend="synaptic-prefs-actions"/> for further upgrades.

1367

You can change the default upgrade method for further upgrade in the preferences

1368

.

1406

1369

</para>

1407

1370

</tip>

1408

1371

</sect2>

1409

1372

1410

1373

<!-- sect2 id="synaptic-pkg-downgrade">

1411

<title>

1412

To Downgrade Packages

1413

</title>

1374

<title>To Downgrade Packages</title>

1414

1375

1415

1376

1416

1377

<para>

1492

1453

1493

1454

<para>

1494

1455

Press the key combination

1495

<keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>.

1456

<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.

1496

1457

</para>

1497

1458

</listitem>

1498

1459

</itemizedlist>

1502

1463

</sect2 -->

1503

1464

1504

1465

1505

<title>

1506

To Apply Marked Changes

1507

</title>

1466

<title>To Apply Marked Changes</title>

1508

1467

1509

1468

<tip>

1510

1469

<para>

1532

1491

1533

1492

<para>

1534

1493

Press the key combination

1535

<keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>.

1494

<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.

1536

1495

</para>

1537

1496

</listitem>

1538

1497

</itemizedlist>

1543

1502

</para>

1544

1503

<para>

1545

1504

During the processing of the changes you will see a progressbar. Wait until

1546

the changes have been applied. This can take some time depending on the size

1547

of the changes. Afterwards you will be returned to the main window.

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.

1548

1507

</para>

1549

1508

<note>

1550

1509

<para>

1551

1510

The progressbar is not available on Debian system. Instead you will

1552

1511

see a detailed terminal output.

1553

</para>

1512

</para>

1554

1513

</note>

1555

1514

</sect2>

1556

1515

1557

1516

1558

<title>

1559

To Unmark Changes

1560

</title>

1517

<title>To Unmark Changes</title>

1561

1518

1562

1519

<para>

1563

1520

The following ways allow you to unmark changes:

1616

1573

from the menu.

1617

1574

</para>

1618

1575

<para>

1619

This step can be repeated. The maxium number of undo operations can be set

1576

This step can be repeated. The maxmium number of undo operations can be set

1620

1577

in the preferences. FIX link

1621

1578

</para>

1622

1579

</listitem>

1625

1582

</sect2>

1626

1583

1627

1584

1628

<title>

1629

To Configure Packages (Debian only)

1630

</title>

1585

<title>To Configure Packages (Debian only)</title>

1631

1586

1632

1587

<para>

1633

1588

<note>

1669

1624

</sect2>

1670

1625

1671

1626

1672

<title>

1673

To View Documentation for Packages (Debian only)

1674

</title>

1627

<title>To View Documentation for Packages (Debian only)</title>

1675

1628

1676

1629

1677

1630

1685

1638

<para>

1686

1639

Dwww provides access to all the installed documentation

1687

1640

related to package with a web browser. The whole documentation is

1688

hostet via a local HTTP server.

1641

hosted via a local HTTP server.

1689

1642

</para>

1690

1643

1691

1644

1698

1651

1699

1652

<para>

1700

1653

Choose <menuchoice><guimenu>Package</guimenu>

1701

<guimenuitem>Documentation</guimenuitem></menuchoice>.

1654

<guimenuitem>Browse Documentation</guimenuitem></menuchoice>.

1702

1655

</para>

1703

1656

</listitem>

1704

1657

</orderedlist>

1705

1658

1706

1659

</sect2>

1707

1660

1708

<title>

1709

To View the Changelog of a Package (Debian only)

1710

</title>

1661

<title>To View the Changelog of a Package (Debian only)</title>

1711

1662

1712

1663

1713

1664

1718

1669

</note>

1719

1670

1720

1671

<para>

1721

To view the changelog of a native Debian package perfrom the following steps:

1672

To view the changelog of a native Debian package perform the following steps:

1722

1673

</para>

1723

1674

1724

1675

1737

1688

</sect2>

1738

1689

1739

1690

1740

<title>

1741

To Lock a Package to the Current Version (Debian only)

1742

</title>

1691

<title>To Lock a Package to the Current Version (Debian only)</title>

1743

1692

1744

1693

1745

1694

1755

1704

1756

1705

<para>

1757

1706

Choose <menuchoice><guimenu>Package</guimenu>

1758

<guimenuitem>Lock</guimenuitem></menuchoice>.

1707

<guimenuitem>Lock Version</guimenuitem></menuchoice>.

1759

1708

</para>

1760

1709

<para>

1761

1710

The &app; will reload the package list. You should now see, that the menu item <menuchoice>

1773

1722

1774

1723

1775

1724

1776

<title>

1777

To Force the Installation of a Specific Version

1778

</title>

1725

<title>To Force the Installation of a Specific Version</title>

1779

1726

1780

1727

1781

1728

1782

1729

1783

1730

<para>

1784

1731

The &app; always selects the most applicable version available. If you force a

1785

differnet version from the default one, errors in the dependency handling

1732

different version from the default one, errors in the dependency handling

1786

1733

can occur.

1787

1734

</para>

1788

1735

</warning>

1789

1736

1790

1737

<para>

1791

To force the installation of a version of package differnet to the default one

1738

To force the installation of a version of package different to the default one

1792

1739

perform the following steps:

1793

1740

</para>

1794

1741

1795

1742

1796

1743

<para>

1797

Refresh the list of known packages to be aware of the latest version available:

1744

Reload the list of known packages to be aware of the latest version available:

1798

1745

1799

1746

1800

1747

1801

1748

<para>

1802

1749

Choose <menuchoice><guimenu>Edit</guimenu>

1803

<guimenuitem>Refresh Package List</guimenuitem>

1750

<guimenuitem>Reload Package List</guimenuitem>

1804

1751

</menuchoice> from the menu.

1805

1752

</para>

1806

1753

</listitem>

1807

1754

1808

1755

<para>

1809

Click on <guibutton>Refresh</guibutton> in the toolbar.

1756

Click on <guibutton>Reload</guibutton> in the toolbar.

1810

1757

</para>

1811

1758

</listitem>

1812

1759

1813

1760

<para>

1814

1761

Press the key combination

1815

<keycombo><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>.

1762

<keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo>.

1816

1763

</para>

1817

1764

</listitem>

1818

1765

</itemizedlist>

1832

1779

1833

1780

<para>

1834

1781

Select the version that should be marked for installation. To confirm your

1835

descision click on the button <guibutton>Force</guibutton>.

1782

decision click on the button <guibutton>Force</guibutton>.

1836

1783

</para>

1837

1784

</listitem>

1838

1785

1855

1802

1856

1803

<para>

1857

1804

Press the key combination

1858

<keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>.

1805

<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo>.

1859

1806

</para>

1860

1807

</listitem>

1861

1808

</itemizedlist>

1870

1817

1871

1818

<para>

1872

1819

During the processing of the changes you will see a progressbar. Wait until

1873

the changes have been applied. This can take some time depending on the size

1874

of the changes. Afterwards you will be returned to the main window.

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.

1875

1822

</para>

1876

1823

<note>

1877

1824

<para>

1878

1825

The progressbar is not available on Debian system. Instead you will

1879

1826

see a detailed terminal output.

1880

</para>

1827

</para>

1881

1828

</note>

1882

1829

</listitem>

1883

1830

</orderedlist>

1884

1831

</sect2>

1885

1832

1886

<title>

1887

To Fix Broken Packages

1888

</title>

1833

<title>To Fix Broken Packages</title>

1889

1834

1890

1835

<para>

1891

1836

&app; will not allow any further changes to the system before all broken packages are fixed.

1944

1889

1945

1890

<para>

1946

1891

During the processing of the changes you will see a progressbar. Wait until

1947

the changes have been applied. This can take some time depending on the size

1948

of the changes. Afterwards you will be returned to the main window.

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.

1949

1894

</para>

1950

1895

<note>

1951

1896

<para>

1952

1897

The progressbar is not available on Debian system. Instead you will

1953

1898

see a detailed terminal output.

1954

</para>

1899

</para>

1955

1900

</note>

1956

1901

</listitem>

1957

1902

</orderedlist>

1961

1906

</sect1>

1962

1907

1963

1908

1964

<title>

1965

Repositories

1966

</title>

1909

<title>Repositories</title>

1967

1910

1968

1911

<para>

1969

1912

Packages are made available through so called <emphasis>repositories</emphasis>. The repository contains the

1977

1920

1978

1921

1979

1922

1980

<title>

1981

To Refresh the List of Known Packages

1982

</title>

1923

<title>To Reload the List of Known Packages</title>

1983

1924

<para>

1984

1925

To collect the list of all available packages from the repositories choose one of the following

1926

methods:

1985

1927

</para>

1986

1928

1987

1929

1988

1930

<para>

1989

1931

Choose <menuchoice><guimenu>Edit</guimenu>

1990

<guimenuitem>Refresh Package List</guimenuitem></menuchoice> from the menu.

1932

<guimenuitem>Reload Package List</guimenuitem></menuchoice> from the menu.

1991

1933

</para>

1992

1934

</listitem>

1993

1935

1994

1936

<para>

1995

Click on <guibutton>Update List</guibutton> in the toolbar.

1937

Click on <guibutton>Reload</guibutton> in the toolbar.

1996

1938

</para>

1997

1939

</listitem>

1998

1940

</itemizedlist>

1999

1941

</sect2>

2000

1942

2001

1943

2002

<title>

2003

To Edit, Add or Remove Repositories

2004

</title>

1944

<title>To Edit, Add or Remove Repositories</title>

2005

1945

<para>

2006

1946

You can edit, add or delete repositories in the repository preferences.

2007

1947

</para>

2011

1951

</para>

2012

1952

2013

1953

2014

<title>

2015

Repository Preferences

2016

</title>

1954

<title>Repository Preferences</title>

2017

1955

2018

1956

2019

1957

2032

1970

</sect2>

2033

1971

2034

1972

2035

<title>

2036

To Add Repositories From CD-ROM

2037

</title>

1973

<title>To Add Repositories From CD-ROM</title>

2038

1974

<para>

2039

1975

Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Add CD...</guimenuitem></menuchoice>

2040

1976

from the menu.

2042

1978

</sect2>

2043

1979

2044

1980

2045

<title>

2046

The Syntax of the APT line

2047

</title>

1981

<title>The Syntax of the APT line</title>

2048

1982

<para>

2049

1983

The package manager stores all available repositories in a text based configuration file.

2050

Each line describes the type, location and content of one repositroy.

1984

Each line describes the type, location and content of one repository.

2051

1985

</para>

2052

1986

2053

1987

2054

<title>

2055

Synatax of an APT line e.g. <emphasis>deb http://ftp.debian.org sarge main</emphasis>

2056

</title>

1988

<title>Syntax of an APT line e.g. <emphasis>deb http://ftp.debian.org sarge main</emphasis></title>

2057

1989

2058

1990

2059

1991

2073

2005

deb

2074

2006

</entry>

2075

2007

2076

The first elements describes the type of the repositroy.

2008

The first elements describes the type of the repository.

2077

2009

Possible values are <emphasis>deb</emphasis> (Debian binary packages), <emphasis>deb-src

2078

2010

</emphasis>(Debian source packages), <emphasis>rpm</emphasis> (RPM binary packages),

2079

2011

<emphasis>rpm-src</emphasis> (Redhat source packages), <emphasis>rpmdir</emphasis>

2087

2019

</entry>

2088

2020

2089

2021

The second element is the location of the repository.

2090

The repositroy can be accessed by the protocols HTTP and

2022

The repository can be accessed by the protocols HTTP and

2091

2023

FTP, or locally on a CD, DVD or hard disk.

2092

2024

</entry>

2093

2025

</row>

2108

2040

</entry>

2109

2041

2110

2042

The forth element describes sections of the

2111

repositroy that should be included. By default official Debian repositories are

2043

repository that should be included. By default official Debian repositories are

2112

2044

separated into the sections <emphasis>main</emphasis>, <emphasis>

2113

2045

contrib</emphasis> and <emphasis>non-free</emphasis>, see the

2114

2046

<ulink

2127

2059

</sect1>

2128

2060

2129

2061

2130

<title>

2131

Filters

2132

</title>

2062

<title>Custom Filters</title>

2133

2063

<para>

2134

Filters enable you to narrow down the list of shown packages.

2064

Filters enable you to narrow down the list of shown packages by a variety of package attributes.

2135

2065

</para>

2136

2066

<para>

2137

2067

&app; comes with a set of predefined filters.

2138

2068

</para>

2139

2069

2140

2070

2141

<title>

2142

Predefined Filters

2143

</title>

2071

<title>Predefined Filters</title>

2144

2072

2145

2073

2146

2074

2162

2090

</entry>

2163

2091

</row>

2164

2092

<row>

2093

<entry valign="top">Marked Changes</entry>

2094

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

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

2108

Display only packages with broken dependencies.

2109

</entry>

2110

</row>

2111

<row>

2112

<entry valign="top">Upgradable (upstream)</entry>

2113

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

2129

<title>Deprecated Filters</title>

2130

2131

2132

2133

<thead>

2134

2135

2136

Filter

2137

</entry>

2138

2139

Description

2140

</entry>

2141

</row>

2142

</thead>

2143

<tbody>

2144

<row>

2165

2145

<entry valign="top">Install</entry>

2166

2146

2167

2147

Display only currently installed packages.

2222

2202

<row>

2223

2203

<entry valign="top">Search Filter</entry>

2224

2204

2225

Display the last results of the advanced package

2226

package search, see <xref linkend="synaptic-pkg-find-advsearch"/>.

2205

Display the results of the last package search.

2227

2206

</entry>

2228

2207

</row>

2229

2208

</tbody>

2231

2210

</table>

2232

2211

2233

2212

2234

<title>

2235

To Apply Filters

2236

</title>

2213

<title>To Apply Filters</title>

2237

2214

<para>

2238

To apply a filter:

2215

To apply a filter follow these steps:

2239

2216

</para>

2240

2217

2241

2218

2242

2219

<para>

2243

Choose the filter from the <guibutton>Show</guibutton> combobox in the main window.

2220

Choose <guibutton>Custom Filters</guibutton> from the category combobox in

2221

the main window.

2244

2222

</para>

2245

2223

</listitem>

2246

</itemizedlist>

2224

2225

<para>

2226

Choose the wished filter from the <xref linkend="synaptic-win-selector"/>.

2227

</para>

2228

</listitem>

2229

</orderedlist>

2247

2230

</sect2>

2248

2231

2249

2232

2250

<title>

2251

To Edit or Create Filters

2252

</title>

2233

<title>To Edit or Create Custom Filters</title>

2253

2234

2254

2235

<para>

2255

2236

Filters can be created, deleted and modified in the filter editor:

2256

2237

</para>

2257

2238

2258

2259

2260

<para>

2261

Choose from the menu <menuchoice><guimenu>View</guimenu><guimenuitem>

2262

Edit Filters...</guimenuitem></menuchoice>.

2263

</para>

2264

</listitem>

2265

2266

<para>

2267

Click on <guibutton>Filters...</guibutton> in the main window.

2268

</para>

2269

</listitem>

2270

</itemizedlist>

2239

<para>

2240

Choose <menuchoice><guimenu>Preferences</guimenu><guimenuitem>

2241

Filters</guimenuitem></menuchoice> from the menu.

2242

</para>

2271

2243

2272

2244

2273

2245

<title>Edit Filters</title>

2303

2275

</varlistentry>

2304

2276

2305

2277

<term>

2306

View

2307

</term>

2308

2309

<para>

2310

Specify the arrangement of the results.

2311

</para>

2312

</listitem>

2313

</varlistentry>

2314

2315

<term>

2316

2278

Rules

2317

2279

</term>

2318

2280

2327

2289

</term>

2328

2290

2329

2291

<para>

2330

Allows you to select packages by their status.

2292

Allows you to search packages by status.

2331

2293

</para>

2332

2294

</listitem>

2333

2295

</varlistentry>

2337

2299

</term>

2338

2300

2339

2301

<para>

2340

Allows you to select packages by their section.

2302

Allows you to search packages by section.

2341

2303

</para>

2342

2304

</listitem>

2343

2305

</varlistentry>

2347

2309

</term>

2348

2310

2349

2311

<para>

2312

Allows you to search packages by a variety of

2313

attributes e.g. name, dependencies or origin.

2350

2314

</para>

2351

2315

</listitem>

2352

2316

</varlistentry>

2372

2336

2373

2337

2374

2338

2375

2339

<!-- sect1 id="snyaptic-prefs">

2376

2340

<title>Preferences</title>

2377

2341

2342

NEEDS SOME LOVE - THEREFOR DISABLED

2343

2378

2344

2379

2345

<title>General</title>

2380

2346

<para>

2493

2459

</sect2>

2494

2460

2495

2461

2496

<title>

2497

Layout

2498

</title>

2462

<title>Layout</title>

2499

2463

<para>

2500

2464

You can change the appearance of Synaptic.

2501

2465

</para>

2524

2488

</sect2>

2525

2489

2526

2490

2527

<title>

2528

Column Order and Colours

2529

</title>

2491

<title>Column Order and Colours</title>

2530

2492

<para>

2531

2493

Modify the appearance of the package list in the main window.

2532

2494

</para>

2556

2518

</sect2>

2557

2519

2558

2520

2559

<title>

2560

Temporary Files

2561

</title>

2521

<title>Temporary Files</title>

2562

2522

<para>

2563

2523

Configure the management of completely or partially downloaded package files.

2564

2524

</para>

2565

2525

</sect2>

2566

2526

2567

2527

2568

<title>

2569

Network

2570

</title>

2528

<title>Network</title>

2571

2529

<para>

2572

2530

Configure the Internet connection and proxy server.

2573

2531

</para>

2574

2532

</sect2>

2575

2533

2576

2534

2577

<title>

2578

Expert

2579

</title>

2535

<title>Expert</title>

2580

2536

<para>

2581

2537

Undocumented.

2582

2538

</para>

2583

2539

</sect2>

2584

</sect1>

2540

</sect1 -->

2585

2541

2586

2542

2587

<title>

2588

Known Bugs and Limitations

2589

</title>

2543

<title>Known Bugs and Limitations</title>

2590

2544

<para>

2591

2545

2592

2546

2645

2599

</sect1>

2646

2600

2647

2601

2648

<title>

2649

Keyboard Shortcuts

2650

</title>

2602

<title>Keyboard Shortcuts</title>

2651

2603

<para>

2652

2604

List of all global short cuts in &app;:

2653

2605

</para>

2659

2611

<tbody>

2660

2612

<row>

2661

2613

2662

2614

Reload the list of known packages

2663

2615

</entry>

2664

2616

2665

Apply all marked changes

2617

2666

2618

</entry>

2667

2619

</row>

2668

2620

<row>

2669

2621

2622

Open the package search dialog

2623

</entry>

2624

2670

2625

2671

2626

</entry>

2672

2673

Open the package find dialog

2674

</entry>

2675

</row>

2676

<row>

2677

2678

2679

</entry>

2627

</row>

2628

<row>

2629

2630

Open the properties dialog for the selected package

2631

</entry>

2632

2633

2634

</entry>

2635

</row>

2636

<row>

2637

2638

Mark the selected package(s) for installation

2639

</entry>

2640

2641

2642

</entry>

2643

</row>

2644

<row>

2645

2646

Mark the selected package(s) for upgrade

2647

</entry>

2648

2649

2650

</entry>

2651

</row>

2652

<row>

2653

2654

Mark the selected package(s) for removal

2655

</entry>

2656

2657

<keycap>Delete</keycap>

2658

</entry>

2659

</row>

2660

<row>

2661

2662

Mark the selected package(s) for complete removal (Debian only)

2663

</entry>

2664

2665

<keycombo><keycap>Shift</keycap><keycap>Delete</keycap></keycombo>

2666

</entry>

2667

</row>

2668

<row>

2669

2670

Unmark any changes to the selected package(s)

2671

</entry>

2672

2673

2674

</entry>

2675

</row>

2676

<row>

2680

2677

2681

2678

Mark all possible upgrades

2682

2679

</entry>

2683

</row>

2684

<row>

2685

2686

2687

</entry>

2688

2689

Mark the selected package(s) for installation

2690

</entry>

2691

</row>

2692

<row>

2693

2694

2695

</entry>

2696

2697

Unmarked any changes and set package as before

2698

</entry>

2699

</row>

2700

<row>

2701

2680

2702

2681

2703

2682

</entry>

2704

2705

Upgrade the whole system by marking all available upgrade

2706

</entry>

2707

</row>

2708

<row>

2709

2710

2711

</entry>

2712

2713

Mark the selected package(s) for installation

2714

</entry>

2715

</row>

2716

<row>

2683

</row>

2684

<row>

2685

2686

Undo the last status change to a package and to the

2687

therefor required dependencies

2688

</entry>

2689

2690

2691

</entry>

2692

</row>

2693

<row>

2694

2695

Redo the last reverted status change to a package and to the

2696

therefor required dependencies

2697

</entry>

2698

2699

<keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap>

2700

2701

</entry>

2702

</row>

2703

<row>

2704

2705

Apply all marked changes

2706

</entry>

2707

2708

2709

</entry>

2710

</row>

2711

<row>

2712

2713

Quit &app;

2714

</entry>

2717

2715

2718

2716

2719

2717

</entry>

2720

2721

Quit &app;

2722

</entry>

2723

</row>

2724

<row>

2725

2726

2727

</entry>

2728

2729

Mark the selected package(s) for removal

2730

</entry>

2731

</row>

2732

<row>

2733

2734

2735

</entry>

2736

2737

Refresh the list of known package

2718

</row>

2719

<row>

2720

2721

Show the manual of &app;

2722

</entry>

2723

2724

2738

2725

</entry>

2739

2726

</row>

2740

2727

</tbody>

2744

2731

2745

2732

2746

2733

2747

<title>

2748

About &app;

2749

</title>

2734

<title>About &app;</title>

2750

2735

<para>

2751

2736

&app; was originally written by Alfredo K. Kojima (<email>kojima@windowmaker.org</email>)

2752

2737

and is now maintained by Michael Vogt (<email>mvo@debian.org</email>) and