aboutsummaryrefslogtreecommitdiffstats
path: root/docs/docs/stable/mcc-help/ast/rpmdrake.xml
blob: 6ab33fa95a9e476fb0fd94d7bd1269730ace0cea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
<?xml version='1.0' encoding='utf-8'?><section xmlns="http://docbook.org/ns/docbook" xmlns:ns5="http://www.w3.org/1998/Math/MathML" xmlns:ns4="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:ns2="http://www.w3.org/1999/xlink" xmlns:ns="http://docbook.org/ns/docbook" xml:id="rpmdrake" version="5.0" xml:lang="ast">
  <!--2012-09-03 marja expanded xml:id's of section and title below, because they conflicted with identical xml:id's in another page of MCC help, also replaced first para in some sections with title tags, removed figure tags-->
<info annotations="simonnzg 6jan2013">
    <title xml:id="rpmdrake-ti1">Software Management (Install and Remove Software)</title>

    <subtitle>rpmdrake</subtitle>
  </info>

  <mediaobject>
    <imageobject>
      <imagedata format="PNG" xml:id="rpmdrake-im1" align="center" fileref="rpmdrake.png" revision="1"/>
    </imageobject>
  </mediaobject>

  

  <section xml:id="rpmdrake-introduction">
    <title xml:id="rpmdrake-introduction-ti1">Introduction to rpmdrake</title>

    <para>This tool<footnote>
        <para>You can start this tool from the command line, by typing <emphasis
role="bold">rpmdrake</emphasis> as root.</para>
      </footnote>, also known as drakrpm, is a
program for installing, uninstalling and updating packages. It is the
graphical user interface of URPMI. At each start up, it will check online
package lists (called 'media') downloaded straight from Mageia's official
servers, and will show you each time the latest applications and packages
available for your computer. A filter system allows you to display only
certain types of packages: you may display only installed applications (by
default), or only available updates. You can also view only not installed
packages. You can also search by the name of a package, or in the summaries
of descriptions or in the full descriptions of packages or in the file names
included in the packages.</para>

    <para>To work, rpmdrake needs the repositories to be configured with <xref
linkend="drakrpm-edit-media"/> .</para>

    <important>
      <para>During the installation, the configured repository is the medium used for
the installation, generally the DVD or CD. If you keep this medium, rpmdrake
will ask it each time you want to install a package, with this pop-up window
: <mediaobject>
          <imageobject>
            <imagedata fileref="rpmdrake8.png"/>
          </imageobject>
        </mediaobject>If the above message annoys you
and you have a good internet connection without too strict download limit,
it is wise to remove that medium and replace it by online repositories
thanks to <xref linkend="drakrpm-edit-media"/> .</para>

      <para>Moreover, the online repositories are always up to date, contains much more
packages, and allow to update your installed packages.</para>
    </important>
  </section>

  <section>
    <title>The main parts of the screen</title>

    <screenshot>
<mediaobject>
        <imageobject>
          <imagedata fileref="rpmdrake1.png"/>
        </imageobject>
      </mediaobject></screenshot>

    <orderedlist>
      <listitem>
        <para><emphasis role="bold">Package type filter:</emphasis></para>

        <para>This filter allows you to display only certain types of packages. The first
time you start the manager, it only displays applications with a graphical
interface. You can display either all the packages and all their
dependencies and libraries or only package groups such as applications only,
updates only or backported packages from newer versions of Mageia.</para>

        <warning>
          <para>The default filter setting is for new entrants to Linux or Mageia, who
probably do not want command line or specialist tools.  Since you're reading
this documentation, you're obviously interested in improving your knowledge
of Mageia, so it is best to set this filter to "All".</para>
        </warning>
      </listitem>

      <listitem>
        <para><firstterm> <emphasis role="bold">Package state filter:</emphasis>
</firstterm></para>

        <para>This filter allows you to view only the installed packages, only the
packages that are not installed or all of the packages, both installed and
not installed.</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Search mode:</emphasis></para>

        <para>Click on this icon to search through the package names, through their
summaries, through their complete description or through the files included
in the packages.</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">"Find" box:</emphasis></para>

        <para>Enter here one or more key words. If you want to use more than one keyword
for searching use '|' between keywords, e.g. To search for "mplayer" and
"xine" at the same time type 'mplayer | xine'.</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Erase all:</emphasis></para>

        <para>This icon can erase in one click all the key words entered in the "Find" box
.</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Categories list:</emphasis></para>

        <para>This side bar groups all applications and packages into clear categories and
sub categories.</para>
      </listitem>

      <listitem>
        <para><emphasis role="bold">Description panel:</emphasis></para>

        <para>This panel displays the package's name, its summary and complete
description. It displays many useful elements about the selected package. It
can also show precise details about the package, the files included in the
package as well as a list of the last changes made by the maintainer.</para>
      </listitem>
    </orderedlist>
  </section>

  <section>
    <title>The status column</title>

    <para>Once you correctly set the filters, you can find your software either by
category (in area 6 above) or by name/summary/description using area 4. A
list of packages fulfilling your query and, don't forget, the chosen medium
is shown with different status markers according to whether each package is
installed/not installed/an update... To change this status, just check or
uncheck the box before the package name and click on
<guibutton>Apply</guibutton>.</para>

    <para><table>
        <title/>

        <tgroup align="left" cols="2">
          <colspec align="center"/>

          <thead>
            <row>
              <entry align="center">Icon</entry>

              <entry valign="middle" align="center">Legend</entry>
            </row>
          </thead>

          <tbody>
            <row>
              <entry><mediaobject>
                  <imageobject>
                    <imagedata fileref="../rpmdrake2.png"/>
                  </imageobject>
                </mediaobject></entry>

              <entry valign="middle">This package is already installed</entry>
            </row>

            <row>
              <entry><mediaobject>
                  <imageobject>
                    <imagedata fileref="../rpmdrake3.png"/>
                  </imageobject>
                </mediaobject></entry>

              <entry valign="middle">This package will be installed</entry>
            </row>

            <row>
              <entry><mediaobject>
                  <imageobject>
                    <imagedata fileref="../rpmdrake4.png"/>
                  </imageobject>
                </mediaobject></entry>

              <entry valign="middle">This package cannot be modified</entry>
            </row>

            <row>
              <entry><mediaobject>
                  <imageobject>
                    <imagedata fileref="../rpmdrake5.png"/>
                  </imageobject>
                </mediaobject></entry>

              <entry valign="middle">This package is an update</entry>
            </row>

            <row>
              <entry><mediaobject>
                  <imageobject>
                    <imagedata fileref="../rpmdrake6.png"/>
                  </imageobject>
                </mediaobject></entry>

              <entry valign="middle">This package will be uninstalled</entry>
            </row>
          </tbody>
        </tgroup>
      </table></para>

    <para>Examples in the screenshot above:</para>

    <itemizedlist>
      <listitem>
        <para>If I uncheck digikam (the green arrow tell us it is installed), the status
icon will go red with an up arrow and it will be uninstalled when clicking
on <guibutton>Apply</guibutton>.</para>
      </listitem>
    </itemizedlist>

    <itemizedlist>
      <listitem>
        <para>If I check qdigidoc (which is not installed, see the status), the orange
with a down arrow status icon will appear and it will be installed when
clicking on <guibutton>Apply</guibutton>.</para>
      </listitem>
    </itemizedlist>
  </section>

  <section>
    <title>The dependencies</title>

    <screenshot>
<mediaobject>
        <imageobject>
          <imagedata fileref="rpmdrake7.png"/>
        </imageobject>
      </mediaobject></screenshot>

    <para>Some packages need other packages called dependencies in order to work. They
are for example libraries or tools. In this case, Rpmdrake displays an
information window allowing you to choose whether to accept the selected
dependencies, cancel the operation or get more information (see above). It
may also happen that various packages are able to provide the needed
library, in which case rpmdrake displays the list of alternatives with a
button to get more information and another button to choose which package to
install.</para>
  </section>
</section>