gnome-packagekit-data 3.8.2-4ubuntu1 / usr / share / help / oc / gnome-packagekit / index.docbook

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY GFDL SYSTEM "fdl-appendix.xml">
<!ENTITY app "gnome-packagekit">
<!ENTITY application "<application>&app;</application>">
<!ENTITY appversion "2.17.1">
<!ENTITY manrevision "2.17.1">
]>
<!--
      (Do not remove this comment block.)
  Template Maintained by the GNOME Documentation Project:
          http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="oc">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->

  <articleinfo>
    <title lang="en"><application>gnome-packagekit</application> Manual</title>
    <abstract role="description">
      <para lang="en">
        <application>gnome-packagekit</application> is a suite of tools for integration with the GNOME desktop.
      </para>
    </abstract>
    <copyright lang="en">
      <year>2008</year>
      <holder>Richard Hughes (richard@hughsie.com)</holder>
    </copyright>

  <!-- translators: uncomment this:

  <copyright>
   <year>2007</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

  -->

<!-- An address can be added to the publisher information.  If a role is
     not specified, the publisher/author is the same for all versions of the
     document.  -->
    <publisher role="maintainer">
      <publishername>Richard Hughes</publishername>
    </publisher>

     <legalnotice id="legalnotice">
	<para lang="en">
	  Permission is granted to copy, distribute and/or modify this
	  document under the terms of the GNU Free Documentation
	  License (GFDL), Version 1.1 or any later version published
	  by the Free Software Foundation with no Invariant Sections,
	  no Front-Cover Texts, and no Back-Cover Texts.  You can find
	  a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
	  distributed with this manual.
         </para>
         <para lang="en"> This manual is part of a collection of GNOME manuals
          distributed under the GFDL.  If you want to distribute this
          manual separately from the collection, you can do so by
          adding a copy of the license to the manual, as described in
          section 6 of the license.
	</para>

	<para lang="en">
	  Many of the names used by companies to distinguish their
	  products and services are claimed as trademarks. Where those
	  names appear in any GNOME documentation, and the members of
	  the GNOME Documentation Project are made aware of those
	  trademarks, then the names are in capital letters or initial
	  capital letters.
	</para>

	<para lang="en">
	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
	  WITH THE FURTHER UNDERSTANDING THAT:

	  <orderedlist>
		<listitem>
		  <para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                    EXCEPT UNDER THIS DISCLAIMER; AND
		  </para>
		</listitem>
		<listitem>
		  <para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                       THE POSSIBILITY OF SUCH DAMAGES.
		  </para>
		</listitem>
	  </orderedlist>
	</para>
  </legalnotice>


   <!-- This file  contains link to license for the documentation (GNU FDL), and
        other legal stuff such as "NO WARRANTY" statement. Please do not change
        any of this. -->

    <authorgroup>
      <author role="maintainer" lang="en">
        <firstname>Richard</firstname>
        <surname>Hughes</surname>
        <email>richard@hughsie.com</email>
      </author>
<!-- This is appropriate place for other contributors: translators,
      maintainers,  etc. Commented out by default.
       <othercredit role="translator">
        <firstname>Latin</firstname>
        <surname>Translator 1</surname>
        <affiliation>
          <orgname>Latin Translation Team</orgname>
          <address> <email>translator@gnome.org</email> </address>
        </affiliation>
        <contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>

    <revhistory>
      <revision lang="en">
       <revnumber>3.0</revnumber>
        <date>2008-03-31</date>
        <revdescription>
          <para role="author" lang="en">Rahul Sundaram
            <email>sundaram@fedoraproject.org</email>
          </para>
          <para role="publisher" lang="en">Rahul Sundaram</para>
        </revdescription>
      </revision>
      <revision lang="en">
        <revnumber>2.0</revnumber>
        <date>2007-08-30</date>
        <revdescription>
          <para role="author" lang="en">Richard Hughes
            <email>richard@hughsie.com</email>
          </para>
          <para role="publisher" lang="en">Richard Hughes</para>
        </revdescription>
      </revision>
    </revhistory>

    <legalnotice>
      <title lang="en">Feedback</title>
      <para lang="en">
        To report a bug or make a suggestion regarding the gnome-packagekit application or
        this manual, follow the directions in the
        <ulink url="http://www.packagekit.org/" type="http"><application>gnome-packagekit</application> Contact Page</ulink>.
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice>
  </articleinfo>

  <indexterm zone="index" lang="en">
    <primary><application>gnome-packagekit</application></primary>
  </indexterm>
  <indexterm zone="index" lang="en">
    <primary>gpk-application</primary>
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<section id="intro">
  <title>Introduccion</title>
  <!-- manrevision 2.0 compatibility -->
  <anchor id="aboutex"/>
  <anchor id="notice"/>
  <indexterm lang="en">
    <primary><application>gnome-packagekit</application></primary>
    <secondary>Manual</secondary>
    <tertiary>gpk-application</tertiary>
  </indexterm>

  <para lang="en">
    gnome-packagekit is a suite of tools for the <systemitem>GNOME desktop</systemitem>
  </para>
  <para lang="en">
    PackageKit is designed to unify all the software graphical tools used in
    different distributions.
    It abstracts the various underlying package management technologies like
    yum, apt, smart etc. and provides unified graphical and command line frontends.
    It also provides a framework that includes programming interfaces that other
    software applications can take advantage of.
    It is not a replacement for existing package managers like yum.
  </para>
  <para lang="en">
    Some of the architectural advantages of PackageKit over other package management solutions are
    that the PackageKit daemon runs as a system process that is not tied to any user session,
    which means that a long-running update or installation will not be interrupted if the user who
    started it logs out.
    Tasks are queued up, meaning that a user can initiate multiple tasks which will be executed one
    by one and also that multiple users can also use PackageKit in parallel without completely
    locking each other out.
    Access to all privileged operations is controlled via
    <ulink url="http://en.wikipedia.org/wiki/PolicyKit">PolicyKit</ulink>.
  </para>
  <figure>
    <title lang="en">PolicyKit Permissions UI</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-repo-auth.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>

</section>

<section id="application">
  <title lang="en">Applications</title>
  <para lang="en">
    <application>packagekitd</application> is started automatically when it is
    needed. <command>pkcon</command> offers a versatile command line interface
    to PackageKit.
  </para>
  <para lang="en">
    Below is a list containing the names and a short description of the
    utilities included in the gnome-packagekit pack:
  </para>
  <variablelist>
    <varlistentry>
      <term>Linha de comanda</term>
      <listitem>
        <para lang="en">
          <command>gpk-application</command>: Add/Remove Software
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Linha de comanda</term>
      <listitem>
        <para lang="en">
          <command>gpk-update-viewer</command>: Updating your system.
          Also can view the history of updates.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Linha de comanda</term>
      <listitem>
        <para lang="en">
          <command>gpk-prefs</command>: Configuring software updates preferences
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Linha de comanda</term>
      <listitem>
        <para lang="en">
          <command>gpk-repo</command>: Enabling or disabling software repositories
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Linha de comanda</term>
      <listitem>
        <para lang="en">
          <command>gpk-log</command>: History of updates including installing,
          removing or updating any software
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Linha de comanda</term>
      <listitem>
        <para lang="en">
          <command>gpk-install-file</command>: Installs locally available software packages.
          This also gets run if you double-click on a package in your desktop or within a file manager.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Linha de comanda</term>
      <listitem>
        <para lang="en">
          <command>gpk-update-icon</command>: When PackageKit is installed, it starts the session
          icon automatically when you log in.
          This application displays an icon in the notification area of your panel when software
          updates are available, and is responsible for showing notifications about PackageKit
          operations and events.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Linha de comanda</term>
      <listitem>
        <para lang="en">
          <command>gpk-backend-status</command>: Shows technical status of
          support for the underlying package management backend.
          Only useful for developers.
        </para>
      </listitem>
    </varlistentry>
  </variablelist>
</section>

<section id="add-remove">
  <title lang="en">Add/Remove Software</title>
  <para lang="en">
    Add/Remove software application accessed via <menuchoice><guimenu>System</guimenu>
    <guisubmenu>Administration</guisubmenu>
    <guimenuitem>Add/Remove Software</guimenuitem></menuchoice>
    allows you to search the software repository easily or browse through the
    different groups like multimedia or office and select software packages to
    install or remove from your system.
    You can find more information about any package such as description and
    dependencies by just clicking on it.
    Before installing a package, you also can visit the home page of the
    software projects easily for getting any additional details.
  </para>
  <figure>
    <title lang="en">Searching for a group with filters</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-application-groups.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    Typically, you can find several thousands of software packages under
    different groups available.
    Since this can be overwhelming you can choose to filter the lists of
    software packages based on several criteria such as whether the package is already
    installed, whether it is a development or graphical application and based
    on the software license.
    See <xref linkend="filters"/> for more information about filters.
  </para>
  <para lang="en">
    A software source configuration is available in the system menu that
    allows you to enable or disable a existing software repository.
    You can also refresh the application lists for displaying the latest
    information about software packages available in the repository.
  </para>

  <section id="filters">
    <title lang="en">Filters</title>
    <para lang="en">
      You can limit the amount of software packages that is shown by several criteria.
    </para>
    <para lang="en">
      To see only installed or only uninstalled software, choose the
      corresponding menu item in the <menuchoice><guimenu>Filters</guimenu>
      <guisubmenu>Installed</guisubmenu></menuchoice> menu.
    </para>
    <para lang="en">
      To see only software containing applications with a graphical user
      interface or only applications with a command line interface, choose a
      filter from the <menuchoice><guimenu>Filters</guimenu>
      <guisubmenu>Graphical</guisubmenu></menuchoice>
      menu.
    </para>
    <note><para lang="en">
      Note that PackageKit uses a heuristic to determine if a package is a 'graphical'
      application and can get this wrong when a package has dependencies like gtk2+.
    </para></note>
    <para lang="en">
      To see only software that qualify as free software, choose the
      corresponding menu item from the <menuchoice><guimenu>Filters</guimenu>
      <guisubmenu>Free</guisubmenu></menuchoice>
      menu. Currently, PackageKit considers a package to be free software
      if its license is listed as such in the Fedora
      <ulink url="http://fedoraproject.org/wiki/Licensing">Licensing</ulink> page.
    </para>
  </section>

  <section id="searching">
    <title lang="en">Searching for software</title>
    <para lang="en">
      The search entry and <guibutton>Find</guibutton> button let you search
      for software. The icon inside the entry indicates what kind
      of search is performed. By clicking on it, you can select to search for
      a string that is contained in package name, the package description, or
      search for the name of a file contained in the package.
    </para>
  </section>

</section>

<section id="software-sources">
  <title lang="en">Software Sources</title>
  <para lang="en">
    The software repository viewer allows you to enable or disable software
    sources - also known as <quote>repositories</quote>. Repositories
    are collections of software that are known to work together and
    are compatible with your operating system. Apart from the repositories for
    the operating system itself, there are third-party repositories offering
    additional software for many Linux distributions - check your
    distribution-specific documentation for more information.
  </para>
  <figure>
    <title lang="en">Software Sources UI</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-repo.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    At this time, PackageKit does not offer a way to add new repositories to
    your system. It only allows you to enable or disable known repositories.
    However, it is often possible to make a new repository known to PackageKit
    by installing a package with the necessary information. These are usually
    called (foo)-release, where foo is the name of the repository.
  </para>
</section>

<section id="mime-types">
  <title lang="en">File Handler Helper</title>
  <para lang="en">
    Sometimes you will not have the software on your system to open a particular
    file. If the file type is not recognized, then applications that can open
    this file type are shown.
  </para>
  <para lang="en">
    At this time, only a limited number of results will be shown, as they will
    need to be rebuilt by the distribution to support the extra data needed by
    PackageKit. This will happen automatically, and soon all suitable
    applications will be shown.
  </para>
</section>

<section id="update-viewer">
  <title lang="en">Update Viewer</title>
  <para lang="en">
    You can update your system via <menuchoice><guimenu>System</guimenu>
    <guisubmenu>Administration</guisubmenu>
    <guimenuitem>Update System</guimenuitem></menuchoice>
    or by selecting <menuchoice><guimenuitem>Show Updates</guimenuitem></menuchoice>
    from the update icon in the notification area.
    When you do this, the update viewer application launches and immediately
    starts checking for updates. Once this check completes, it shows you an
    overview of available updates, grouped by severity. The severities range
    from security updates over important updates to bug fix updates and
    finally enhancements.
  </para>
  <note><para lang="en">
    Note that the severity information must be provided by the software
    repositories where the software packages originate. This information may not
    be available for development branches of distributions.
  </para></note>
  <figure>
    <title lang="en">Updates overview</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-updates-overview.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    Below the summary of available updates, the update viewer gives and
    indication how long ago the last check (or <quote>refresh</quote>)
    for new updates happened, and when updates where last installed.
  </para>
  <para lang="en">
    You can choose to manually refresh and verify the presence of
    updates by clicking the <guibutton>Refresh</guibutton> button.
  </para>
  <tip><para lang="en">
    You can change how often PackageKit refreshes on its own in
    the <link linkend="prefs">Software Update Preferences</link>.
  </para></tip>
  <para lang="en">
    There is a option to view the history of updates including
    previous installations, removal or updates of software.
  </para>
  <para lang="en">
    Use the <guibutton>Update System</guibutton> button to install
    all available updates or use the <guibutton>Review</guibutton>
    button to review and select individual updates.
    If you do not want to install updates at this time, you can just
    close the window.
  </para>

  <section id="update-viewer-details">
    <title lang="en">Detailed information about updates</title>
    <para lang="en">
      The <guibutton>Review</guibutton> button brings up a listing
      of the individual updates that are available. The area below
      the list displays detailed information about the selected update.
      The information may include references to bugs and vulnerability
      reports that are fixed by the update.
    </para>
    <note><para lang="en">
      Note that the detailed update information must be provided by the
      software repositories where the software packages originate. This information
      may not be available for development branches of distributions.
    </para></note>
    <para lang="en">
      The checkboxes next to each package in the list allow to select
      individual updates for installation. Use the <guibutton>Apply
      Updates</guibutton> button to install only the selected updates.
      If you do not want to install updates at this time, you can just
      close the window.
    </para>
    <figure>
      <title lang="en">Update viewer tool</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-updates.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <note><para lang="en">
      You can uncheck all the updates quickly by right clicking on the list and
      selecting the menu item <guibutton>Unselect all</guibutton>.
    </para></note>
  </section>
</section>

<section id="prefs">
  <title lang="en">Software Updates Preferences</title>
  <figure>
    <title lang="en">Preferences tool</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-prefs.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    Preferences can be configured via <menuchoice><guimenu>System</guimenu>
    <guisubmenu>Preferences</guisubmenu><guisubmenu>System</guisubmenu>
    <guimenuitem>Software Updates</guimenuitem></menuchoice>.
    You can configure it to check for updates on a daily, hourly or weekly
    basis or never. Note that these frequencies are only approximate, and
    checks for updates can be triggered by other events, such as the screen
    being unlocked, network becoming available, or another user checking for
    updates. The default setting is to check for updates daily.
    You can also configure it to automatically install all updates or just the
    ones that fix security issues.
    These settings are per-user and effective only for the current user logged
    in the system.
 </para>
</section>

<section id="software-log">
  <title lang="en">Software Log Viewer</title>
  <figure>
    <title lang="en">Log viewer</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-log.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    This tool can be opened using <menuchoice><guimenu>Applications</guimenu>
    <guisubmenu>System Tools</guisubmenu>
    <guimenuitem>Software Log Viewer</guimenuitem></menuchoice>.
  </para>
  <para lang="en">
    The log viewer can be used to find out what updates were downloaded and
    installed.
    The filter will match on the package name, version or architecture.
  </para>
</section>

<section id="service-pack">
  <title lang="en">Service Pack Creator</title>
  <figure>
    <title lang="en">Service pack creator</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-service-pack.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    This tool can be opened using <menuchoice><guimenu>Applications</guimenu>
    <guisubmenu>System Tools</guisubmenu>
    <guimenuitem>Service Pack Creator</guimenuitem></menuchoice>.
  </para>
  <para lang="en">
    A service pack is a tarball which contains a set of packages and their dependencies.
    To explain better what a service pack is, it is best to show a few use-cases.
  </para>
  <note><para lang="en">
    You can add multiple packages to a service pack by separating the package
    names with a comma, for instance <literal>hal,gnome-power-manager</literal>.
  </para></note>
  <orderedlist numeration="arabic">
    <listitem>
      <para lang="en">
        You have seven desktops you've just installed with Fedora 9.
        Each one needs to have 204Mb of updates installed.
      </para>
    </listitem>
    <listitem>
      <para lang="en">
        You have a laptop that needs network drivers before it can download updates,
        and you have a similar up to date laptop with internet access nearby.
        The network drivers require a few dependencies, and other packages to be
        upgraded before they will install.
      </para>
    </listitem>
    <listitem>
      <para lang="en">
        You frequently install Linux on other peoples computers.
        You carry around a live-cd and a pendrive with a single 204Mb file
        <filename>Fedora-updates-SP1.servicepack</filename> which contains all the
        updates since last week.
      </para>
    </listitem>
    <listitem>
      <para lang="en">
        A free software magazine wants to distribute patent encumbered multimedia
        plugins and programs with the latest Fedora release DVD.
        They want a way in which even the most lazy user can get the things
        installed without much fuss.
      </para>
    </listitem>
  </orderedlist>
  <para lang="en">
    Internally, the pack file is just an uncompressed tarball, with the packages
    and a single metadata.conf file inside.
    The metadata file is just the distribution identifier and the time of creation.
    This ensures you don't try installing a <filename>fedora-9-i386</filename>
    service pack on a <filename>ubuntu-intrepid-ppc</filename> machine.
  </para>
  <para lang="en">
    We need a destination file list because we not know what packages are
    installed on the destination computer.
    For example:
  </para>
  <figure>
    <title lang="en">Two example computers</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-service-pack-example.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    Computer A has the following packages installed, and has internet access.
  </para>
  <itemizedlist>
    <listitem><para lang="en"><literal>glib</literal></para></listitem>
    <listitem><para lang="en"><literal>dbus</literal></para></listitem>
    <listitem><para lang="en"><literal>dbus-glib</literal></para></listitem>
    <listitem><para lang="en"><literal>libgnome</literal></para></listitem>
  </itemizedlist>
  <para lang="en">
    Computer B has the following packages installed, and does not have internet access.
  </para>
  <itemizedlist>
    <listitem><para lang="en"><literal>glib</literal></para></listitem>
    <listitem><para lang="en"><literal>dbus</literal></para></listitem>
    <listitem><para lang="en"><literal>kdebase</literal></para></listitem>
    <listitem><para lang="en"><literal>kdeapps</literal></para></listitem>
  </itemizedlist>
  <para lang="en">
    Computer B wants to have a service pack containing a new version of
    <literal>k3b</literal> so that it can burn DVD-RWs.
  </para>
  <para lang="en">
    The <literal>k3b</literal> program has dependencies of <literal>dbus</literal>,
    <literal>dbus-glib</literal> and <literal>kdebase</literal>.
    Now, if we asked computer A to download <literal>k3b</literal>, it would download
    <literal>k3b</literal> <emphasis>and</emphasis> <literal>kdebase</literal>, but
    <emphasis>not</emphasis> <literal>dbus-glib</literal>.
    We need to provide computer A with the information about what packages computer B
    has got installed before we can create the service pack.
  </para>
  <para lang="en">
    If we generate a package list on computer B, and the transfer it to
    computer A on a USB pendrive or CD-RW we can download the correct packages.
    In this case we would download <literal>k3b</literal> and
    <literal>dbus-glib</literal> and pack it into the new service pack.
  </para>
  <para lang="en">
    The service pack can now be transferred from computer A to computer B on
    the USB pendrive.
  </para>
  <para lang="en">
    The <command>pkgenpack</command> command line tool can also be used for
    creating service pack files.
  </para>
</section>

<section id="auto-updates">
  <title lang="en">Automatic Updates</title>
  <para lang="en">
    Automatic updates can be performed in the background system wide using the
    PackageKit-cron package.
    The settings are controlled via the configuration file at
    <filename>/etc/sysconfig/packagekit-background</filename>.
    You can set it to just check for updates or perform the updates
    automatically and notify any email address.
  </para>
</section>

<section id="update-icon">
  <title lang="en">Update Icon</title>
  <para lang="en">
     The icon offers menu items for installing the available updates or
     for starting the update viewer, which allows you to obtain detailed
     information about the available updates before installing them. See
     <xref linkend="update-viewer"/> for more information.
  </para>
  <figure>
    <title lang="en">Preferences tool</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-updates-warning.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
</section>

<section id="eula">
  <title lang="en">Agreeing to EULAs</title>
  <para lang="en">
    A license agreement is a contract between a producer and a user of software
    which grants the user a software license.
    A software license agreement defines the legal terms under which a user
    may use the software.
    This is called an end-user license agreement or EULA for short.
  </para>
  <para lang="en">
    Many EULAs assert extensive liability limitations for the software.
    Typically a EULA will hold the software producer immune in the event that
    the software causes damage to the computer hardware or data.
    Some software also includes limitations if the user can be held liable for
    damage that arises through improper use of the software.
  </para>
  <figure>
    <title lang="en">Example EULA</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-eula.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    Be sure to carefully read and accept the EULA text before continuing with
    the install or update.
  </para>
</section>

<section id="gpg-signature">
  <title lang="en">Accepting a security signature</title>
  <para lang="en">
    Packages from a software source are typically signed by the project managing
    the repository or packages.
    This allows users to be sure a package signed with a security key is
    actually from the software source it claims to be.
  </para>
  <para lang="en">
    For a package management infrastructure to operate effectively, it has to
    trust repositories so that updates can be downloaded and installed
    automatically.
    The other benefit is that signed packages can be installed without using the
    administrator password, assuming your admin has enabled this option.
  </para>
  <figure>
    <title lang="en">Example signature prompt</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-signature.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para lang="en">
    To trust a repository, you should verify the details of the signing key.
    Normally the best way to do this is to go to the web page of the software
    source, and try to find details about the key used to sign the packages.
    This is normally called a <literal>GPG key</literal>.
  </para>
  <para lang="en">
    You should only proceed with this dialog if you are happy to trust packages
    from this software source.
  </para>
</section>

<section id="dialogs">
  <title lang="en">Common Dialogs Explained</title>
  <para lang="en">
    This application tries to reuse dialogs as much as possible, so that there
    is a repeatable and consistent user interface when managing packages.
    In the following subsections, some of the dialogs will be explained further,
    often with examples or web links.
  </para>

  <section id="dialog-installing-private-files">
    <title lang="en">Copying Files To Another Location</title>
    <figure>
      <title lang="en">Example dialog</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-client-copy-local.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para lang="en">
      If a file has been downloaded to your home directory, it is usually
      downloaded to a location similar to <literal>/home/hughsie/Downloads</literal>.
      The PackageKit service is not run as the same user as the the normal
      desktop user, and so the daemon would not normally be able to access this file.
      If the download folder cannot be read by the root user then it is copied to a
      temporary directory so it can be accessed.
    </para>
  </section>

  <section id="dialog-install-files">
    <title lang="en">Installing Local Files</title>
    <para lang="en">
      An application has asked to install local files on your system.
      If you initiated the action, please click the install button.
    </para>
  </section>

  <section id="dialog-install-catalogs">
    <title lang="en">Installing Catalogs</title>
    <para lang="en">
      A package catalog is a simple file that indicates that other packages should
      be installed.
      There are no optional packages, as a catalog file is designed to be simple
      and need no user interaction.
      Using a catalog file allows you to install different packages quickly and easily.
    </para>
    <note><para lang="en">
      To find more information about catalogs, please visit the
      <ulink url="http://www.packagekit.org/pk-faq.html#catalogs" type="http">FAQ</ulink>.
    </para></note>
  </section>

  <section id="dialog-catalog-none-required">
    <title lang="en">No Packages Required</title>
    <para lang="en">
      The catalog that you tried to install made no changes to your system as
      you already have the required packages installed.
      No further actions are required.
    </para>
    <note><para lang="en">
      To find more information about catalogs, please visit the
      <ulink url="http://www.packagekit.org/pk-faq.html#catalogs" type="http">FAQ</ulink>.
    </para></note>
  </section>

  <section id="dialog-application-confirm">
    <title lang="en">Confirmation Required</title>
    <figure>
      <title lang="en">Example plugin dialog</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-client-codecs.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para lang="en">
      An application needs your permission before modifying packages on your system.
      The program name and the icon is from the application asking for permission.
    </para>
  </section>

  <section id="dialog-finding-requires">
    <title lang="en">Finding Other Required Packages</title>
    <para lang="en">
      Other packages may depend on this package to operate correctly.
      This application is searching for other packages that require the package
      you are trying to remove.
      No changes are being made, and you will be prompted later if this is required.
    </para>
  </section>

  <section id="dialog-finding-depends">
    <title lang="en">Finding Other Dependent Packages</title>
    <para lang="en">
      This package may require resources in other packages to operate correctly.
      This application is searching for other required packages of the package
      you are trying to install.
    </para>
  </section>

  <section id="dialog-remove-other-packages">
    <title lang="en">Removing Other Packages</title>
    <figure>
      <title lang="en">Example dialog when removing rarian</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-remove-confirm.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para lang="en">
      Other packages need to be removed if this package is to be removed.
      If you remove these packages you may loose functionality in other
      applications.
    </para>
    <caution><para lang="en">
      If you are unsure you should not remove the package.
    </para></caution>
  </section>

  <section id="dialog-install-other-packages">
    <title lang="en">Installing Other Packages</title>
    <figure>
      <title lang="en">Example dialog when installing xfce-utils</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-added-deps.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para lang="en">
      Other packages need to be installed if this package is to be installed.
      If you remove these packages you may loose functionality in other
      applications.
      Downloading and installing extra packages will increase the time it
      takes to install this package.
    </para>
  </section>

  <section id="dialog-finding-packages">
    <title lang="en">Finding Packages</title>
    <para lang="en">
      The package database is being searched for your query.
      This may take some time if new package lists need to be downloaded from
      the Internet.
    </para>
  </section>

  <section id="dialog-package-not-found">
    <title lang="en">Package Not Found</title>
    <para lang="en">
      No packages could be found in any remote software source.
      This normally means that you do not have any third party repositories
      enabled or installed.
      These extra repositories can often be found using search engines or forums.
    </para>
    <caution><para lang="en">
      Only install packages from reputable software sources.
    </para></caution>
  </section>

  <section id="dialog-progress">
    <title lang="en">Progress Window</title>
    <para lang="en">
      If we start an action automatically, we typically do it non-interactively.
      If this task starts doing something using the network, or that will take a
      long time, then a new dialog will appear.
      This gives you the opportunity to cancel the task if this is not desired.
    </para>
  </section>

  <section id="dialog-permissions">
    <title lang="en">No Privileges</title>
    <figure>
      <title lang="en">PolicyKit Permissions UI</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-repo-auth.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para lang="en">
      You don't have the necessary privileges to perform this action.
      This can happen when you fail to authenticate correctly, for instance
      by entering your password correctly twice in a row.
      NOTE: you also need to enter the root password on some distributions,
      not your own password.
    </para>
    <note><para lang="en">
      If you cannot authenticate, you need to speak to your systems administrator.
    </para></note>
  </section>

  <section id="dialog-no-service">
    <title lang="en">No PackageKit Service Running</title>
    <para lang="en">
      The core PackageKit service could not be started.
      This will only happen when you have a serious system error.
      You can get more information about the error by running (as the root user):
      <literal>/usr/sbin/packagekitd --verbose</literal>
    </para>
  </section>

  <section id="dialog-update-system">
    <title lang="en">Update System</title>
    <para lang="en">
      All the packages that can be updated on your system are now being updated.
      You can cancel the update if the cancel button is not insensitive.
    </para>
  </section>

  <section id="dialog-update-packages">
    <title lang="en">Update Packages</title>
    <para lang="en">
      Some packages on your system are now being upgraded.
      You can cancel the update if the cancel button is not insensitive.
    </para>
  </section>

  <section id="dialog-refresh">
    <title lang="en">Refreshing Package Lists</title>
    <para lang="en">
      Once a week (although this can be changed in the preferences)
      you will automatically have the latest package lists downloaded.
      This means that when you search for a package you do not have installed,
      you will get any new software that was added to a software source.
    </para>
    <para lang="en">
      Once the package lists are downloaded, the installed and available packages
      will be cached so client tools can auto-complete.
      When this is completed, any new applications are scanned and added to a
      client database.
    </para>
  </section>
</section>

<section id="about">
  <title>A prepaus de</title>
  <para lang="en">
    gnome-packagekit is maintained Richard Hughes <email>richard@hughsie.com</email> and developed along with
    several others.
    To find more information about gnome-packagekit, please visit the
    <ulink url="http://www.packagekit.org/" type="http"><application>gnome-packagekit</application> web page</ulink>.
  </para>
  <para lang="en">
    To report a bug or make a suggestion regarding this application or
    this manual, follow the directions at the
    <ulink url="http://www.packagekit.org/" type="http">
    <application>gnome-packagekit</application> Bug Page</ulink>.
  </para>
  <para lang="en">This program is distributed under the terms of the GNU
    General Public license as published by the Free Software
    Foundation; either version 2 of the License, or (at your option)
    any later version. A copy of this license can be found at this
    <ulink url="gpk-application:gpl" type="help">link</ulink>, or in the file
    COPYING included with the source code of this program.
  </para>
</section>

</article>