aboutsummaryrefslogtreecommitdiffstats
path: root/docs/mcc-help/en/rpmdrake.xml
blob: ffd9045f693620845891fb54bf2907e901bb34a8 (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
252
253
254
<?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">
  <info annotations="simonnzg 6jan2013">
    <title xml:id="rpmdrake-ti1">Software Management (Install and Remove
    Software)</title>

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

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

  <!--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-->

  <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 cols="2" align="left">
          <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 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>