source: projects/synaptic/trunk/README @ 280

Revision 280, 4.0 KB checked in by yasumichi, 13 years ago (diff)

first import

Line 
1Synaptic
2========
3
4Synaptic is a graphical package management program for apt. It
5provides the same features as the apt-get command line utility with a
6GUI front-end based on Gtk+ or WINGs.
7
8Synaptic was developed by Alfredo K. Kojima <kojima@conectiva.com.br>
9from Connectiva. His last offical released was 0.16. I took over his
10CVS version, where he added a nearly complette port to Gtk+. I
11completted the port and add some new features. See the NEWS file for
12the user visible changes from that point on. Connectiva is still
13supporting the development of synaptic. Gustavo Niemeyer
14<niemeyer@conectiva.com> is a active developer of synaptic.
15
16If you want to use synaptic from the gnome menu, you should use gksu
17(default) to obtain root privileges. Get it from gksu from
18http://www.nongnu.org/gksu/.
19
20Synaptic can display a "Pkg Help" button on debian systems. If you have
21installed and configured dwww, a help will be display and if you click
22on it, a browser is opend.
23
24It is also possible on debian systems to reconfigure debconf packages.
25This is done with the help of libgnome2-perl that needs to be installed.
26
27On a debian system, you can have more than one "release" in your
28sources.list file. You can choose which one to use in the "expert" tab
29in the preferences dialog.
30
31All development is done at http://savannah.gnu.org/projects/synaptic
32
33Tutorial:
34---------
35Synaptic is used very much like apt-get. Usually you do a
36"update" which will update the package list from the servers in your
37sources.list file. Note that no packages are updated in this step,
38only information about the packages. Now you can view what packages
39are "upgradeable". To do this, just click on the filter "Upgradeable".
40The main list will change and you will see only those packages where
41a new version is available on the server. You can now upgrade
42inidiviual packages by selecting them and then clicking on the small
43"upgrade" button on the left (or double click in the gtk-version) or
44thos to upgrade all packages by clicking on the big "Upgrade" button
45on the top. No packages will downloaded/upgraded yet, they are only
46marked as to be upgraded. You may want to change the filter again to
47"Expected Changes" to see what will happen if you continue. If you
48like what you see, click "Proceed!" and synaptic will download the
49packages and install them.
50
51
52Filters:
53--------
54Synaptic display the main package list according to the filter you
55selected. The most simple filter is of course "All packages". But
56there are much more filters than that :) You can view the predefiend
57filters and make your own filters by clicking on "Filters" above the
58main package list.
59
60Keybindings:
61------------
62From version 0.20 on, the gtk has some global keybings:
63* ALT-k  keep
64* ALT-i  install
65* ALT-r  remove
66* ALT-u  Update individual package
67* ALT-l  Update Package List
68* ALT-g  upgrade
69* ALT-d  DistUpgrade
70* ALT-p  proceed
71* CTRL-f find
72
73Command line options:
74---------------------
75From version 0.25 on, synaptic supports the following command line
76options:
77 '-f <filename>' or "--filter-file <filename>" = give a alternative filter file
78 '-i <int>' or "--initial-filter <int>" = start with filter nr. <int>
79 '-r' = open repository screen on startup
80 '-o <option>' or "--option <option>" = set a synaptic/apt option (expert only)
81 '--set-selections' = feed packages inside synaptic (format is like
82                      dpkg --get-selections)
83 '--non-interactive' = non-interactive mode (this will also prevent saving
84                       of configuration options)
85
86Selecting Multiple Packages
87----------------------------
88From 0.25 on, you can select more than one package at a time. You have to
89use SHIFT or CTRL to select multiple packages. If you click on a action
90(install/upgrade/remove) for multiple packages, the action will be performed
91for each package (as you probably already guessed (: ).
92
93
94Contacting me
95-------------
96If you have any questions, suggestions or bugreports, send a email
97to synaptic-devel@mail.freesoftware.fsf.org or directly to me (mvo@debian.org).
98
99
100Have fun with synaptic,
101 Michael Vogt
102
Note: See TracBrowser for help on using the repository browser.