← Back to branch summary

~ubuntu-core-dev/synaptic/ubuntu

« back to all changes in this revision

Viewing changes to man/synaptic.8

  • Committer: renate
  • Date: 2004-03-08 11:32:25 UTC
  • Revision ID: gustavo@niemeyer.net-20040308113225-ad468205983f625e
* Synced with stable:
 - new man page
 - new shortcuts

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/synaptic.8
2
2
.\" First parameter, NAME, should be all caps
3
3
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4
4
.\" other parameters are allowed: see man(7), man(1)
5
 
.TH SYNAPTIC 8 "Jun 10, 2003"
 
5
.TH SYNAPTIC 8 "Mar 4, 2004"
6
6
.\" Please adjust this date whenever revising the manpage.
7
7
.\"
8
8
.\" Some roff macros, for reference:
16
16
.\" .sp <n>    insert n+1 empty lines
17
17
.\" for manpage-specific macros, see man(7)
18
18
.SH NAME
19
 
synaptic \- Graphical frontend for package management
 
19
synaptic \- graphical management of software packages
20
20
.SH SYNOPSIS
21
21
\fBsynaptic\fP [options]
22
22
.br
23
23
.SH DESCRIPTION
24
 
Synaptic is a graphical frontend for apt.
25
 
Synaptic is used very much like apt-get. Usually you do an
26
 
`update' which will update the package list from the servers in your
27
 
\fIsources.list\fR file. Note that no packages are updated in this step,
28
 
only information about the packages. Now you can view what packages
29
 
are `upgradable'. To do this, just click on the filter `Upgradable'.
30
 
The main list will change and you will see only those packages where
31
 
a new version is available on the server. You can now upgrade
32
 
individual packages by selecting them and then clicking on the small
33
 
`upgrade' button on the left (or double click in the gtk-version) or
34
 
choose to upgrade all packages by clicking on the big `Upgrade' button
35
 
on the top. No packages will downloaded/upgraded yet, they are only
36
 
marked as to be upgraded. You may want to change the filter again to
37
 
`Expected Changes' to see what will happen if you continue. If you
38
 
like what you see, click `Proceed!' and synaptic will download the
39
 
packages and install them. 
40
 
.TP
41
 
.SH Difference between `Upgrade all' and `DistUpgrade'
42
 
The difference between `Upgrade all' and `DistUpgrade' is small but
43
 
important. `Upgrade all' means: Mark packages that are upgradable for
44
 
upgrade, except those with new dependencies. Under no circumstances
45
 
are currently installed packages removed, or packages not already
46
 
installed retrieved and installed. 
47
 
 
48
 
`DistUpgrade', in addition to performing the function of `Upgrade
49
 
all', also intelligently handles changing dependencies with new
50
 
versions of packages and uses a smart conflict resolution system if
51
 
necessary. 
52
 
 
53
 
Usually you only need `DistUpgrade' if you upgrade between major
54
 
versions of your distribution.
55
 
.TP
56
 
.SH Selecting Multiple Packages
57
 
You can select more than one package at a time. You have to
58
 
use SHIFT or CTRL to select multiple packages. If you click on a action 
59
 
(install/upgrade/remove) for multiple packages, the action will be performed
60
 
for each package (as you probably already guessed (: ).
 
24
Synaptic is a frontend for the apt package managent system.
 
25
It allows you to perform all actions of the command line tool
 
26
apt-get in a graphical environemnt. This includes installing,
 
27
upgrading, downgrading  and removing of single packages or
 
28
even upgrading your whole system.
61
29
.PP
62
 
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
63
 
.\" \fI<whatever>\fP escape sequences to invoke bold face and italics, 
64
 
.\" respectively.
65
 
.TP
66
 
.SH Keybindings
67
 
The gtk has some global keybindings:
68
 
.br
69
 
\fBCTRL-n\fR do not modify
70
 
.br
71
 
\fBCTRL-i\fR install
72
 
.br
73
 
\fBCTRL-r\fR remove
74
 
.br
75
 
\fBCTRL-f\fR search 
76
 
.br
77
 
\fBCTRL-g\fR upgrade
78
 
.br
79
 
\fBCTRL-u\fR update
80
 
.br
81
 
\fBCTRL-e\fR execute changes
82
 
.br
83
 
\fBCTRL-q\fR quit
84
 
 
85
 
.TP
86
 
.SH Filters
87
 
Synaptic displays the main package list according to the filter you
88
 
selected. The most simple filter is of course `All packages'. But
89
 
there are much more filters than that. You can view the predefined
90
 
filters and make your own filters by clicking on `Filters' above the
91
 
main package list. 
 
30
A manual with detailed instructions can be found in the help
 
31
menu of Synaptic.
92
32
 
93
33
.SH OPTIONS
94
 
Synaptic recognizes the standard X options as well as the following:
 
34
Synaptic accepts all of the standard Gtk+ toolkit command line
 
35
options as well as the following:
95
36
.TP
96
37
\fB-f\fR, \fB\-\-filter-file\fR=\fIfilename\fR
97
 
give a alternative filter file
 
38
specify an alternative filter settings file
98
39
.TP
99
40
\fB-i\fR, \fB\-\-initial-filter\fR=\fIint\fR
100
 
start with filter nr. \fIint\fR
 
41
apply the filter with number \fIint\fR at startup
101
42
.TP
102
43
\fB-o\fR, \fB\-\-option\fR=\fIoption\fR
103
 
set a synaptic/apt option (expert only)
 
44
set an internal option (experts only)
104
45
 
105
46
.SH AUTHORS
106
 
Synaptic was developed by Alfredo K. Kojima
 
47
Synaptic was originally developed by Alfredo K. Kojima
107
48
<kojima@conectiva.com.br>. His last official release was 0.16. Michael
108
 
Vogt <mvo@debian.org> took over his CVS version, where Alfredo added a
109
 
nearly complete port to Gtk+. Michael completed the port and added some new
 
49
Vogt <mvo@debian.org> took over his CVS version, that already included a
 
50
nearly complete port to Gtk+. Michael completed the port and added new
110
51
features. See the \fINEWS\fR file for the user visible changes from
111
52
that point on. Conectiva is still involved in the development of
112
53
synaptic. Gustavo Niemeyer <niemeyer@conectiva.com> is doing a
114
55
.PP
115
56
All development is done at http://savannah.gnu.org/projects/synaptic
116
57
.PP
117
 
This manual page was written by Wybo Dekker <wybo@servalys.nl> and 
118
 
Michael Vogt <mvo@debian.org>.
 
58
This manual page was originally written by Wybo Dekker <wybo@servalys.nl> and
 
59
Michael Vogt <mvo@debian.org> and modified by Sebastian Heinlein
 
60
<sebastian.heinlein@campus.lmu.de>.
 
61
 
 
62
.SH COPYRIGHT
 
63
Copyright  (C)  2001-2004 Conectiva S/A
 
64
.PP
 
65
Copyright  (C)  2002-2004 Michael Vogt
 
66
.PP
 
67
There is NO warranty.  
 
68
You may redistribute this software under the terms of  the  GNU
 
69
General  Public License.  For more information about these matters, see
 
70
the files named COPYING.