diff options
Diffstat (limited to 'docs/docs/stable/mcc-help/en/rpmdrake.xml')
-rw-r--r-- | docs/docs/stable/mcc-help/en/rpmdrake.xml | 254 |
1 files changed, 254 insertions, 0 deletions
diff --git a/docs/docs/stable/mcc-help/en/rpmdrake.xml b/docs/docs/stable/mcc-help/en/rpmdrake.xml new file mode 100644 index 00000000..05120705 --- /dev/null +++ b/docs/docs/stable/mcc-help/en/rpmdrake.xml @@ -0,0 +1,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 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>
\ No newline at end of file |