<?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="gl">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->

  <articleinfo>
    <title>Manual de <application>gnome-packagekit</application></title>
    <abstract role="description">
      <para><application>gnome-packagekit</application> é una suite de ferramentas para a integración do escritorio GNOME.</para>
    </abstract>
    <copyright>
      <year>2008</year>
      <holder>Richard Hughes (richard@hughsie.com)</holder>
    </copyright><copyright><year>2011.</year><holder>Fran Dieguez (frandieguez@gnome.org)</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>Pode copiar, distribuír e modificar este documento baixo os termos da Licenza de Documentación Libre GNU (GFDL) na súa versión 1.1 ou posterior, publicada pola Free Software Foundation, sen seccións invariantes e sen textos de portada ou de contraportada. Pode atopar unha copia da GFDL en <ulink type="help" url="ghelp:fdl">link</ulink> ou no ficheiro COPYING-DOCS distribuído xunto con este manual.</para>
         <para> 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>
	  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>
	  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>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>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">
        <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>
       <revnumber>3.0</revnumber>
        <date>2008-03-31</date>
        <revdescription>
          <para role="author">Rahul Sundaram <email>sundaram@fedoraproject.org</email></para>
          <para role="publisher">Rahul Sundaram</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>2.0</revnumber>
        <date>2007-08-30</date>
        <revdescription>
          <para role="author">Richard Hughes <email>richard@hughsie.com</email></para>
          <para role="publisher">Richard Hughes</para>
        </revdescription>
      </revision>
    </revhistory>

    <legalnotice>
      <title>Comentarios</title>
      <para>Para informar dun error ou facer unha suxestión respecto ao aplicativo gnome-packagekit ou este manual, siga as indicacións na <ulink url="http://live.gnome.org/PackageKit/" type="http">páxina de contacto de <application>gnome-packagekit</application></ulink>.</para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice>
  </articleinfo>

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

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

  <para>
    gnome-packagekit is a suite of tools for the <systemitem>GNOME desktop</systemitem>
  </para>
  <para>
    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>
    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>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>Aplicativos</title>
  <para>
    <application>packagekitd</application> is started automatically when it is
    needed. <command>pkcon</command> offers a versatile command line interface
    to PackageKit.
  </para>
  <para>
    Below is a list containing the names and a short description of the
    utilities included in the gnome-packagekit pack:
  </para>
  <variablelist>
    <varlistentry>
      <term>Liña de ordes</term>
      <listitem>
        <para>
          <command>gpk-application</command>: Add/Remove Software
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Liña de ordes</term>
      <listitem>
        <para>
          <command>gpk-update-viewer</command>: Updating your system.
          Also can view the history of updates.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Liña de ordes</term>
      <listitem>
        <para>
          <command>gpk-prefs</command>: Configuring software updates preferences
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Liña de ordes</term>
      <listitem>
        <para>
          <command>gpk-repo</command>: Enabling or disabling software repositories
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Liña de ordes</term>
      <listitem>
        <para>
          <command>gpk-log</command>: History of updates including installing,
          removing or updating any software
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>Liña de ordes</term>
      <listitem>
        <para>
          <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>Liña de ordes</term>
      <listitem>
        <para>
          <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>Liña de ordes</term>
      <listitem>
        <para>
          <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>Engadir ou eliminar programas</title>
  <para>
    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>Buscando un grupo con filtros</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-application-groups.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    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>
    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>Filtros</title>
    <para>
      You can limit the amount of software packages that is shown by several criteria.
    </para>
    <para>
      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>
      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>
      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>
      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>Buscando software</title>
    <para>
      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>Orixes de software</title>
  <para>
    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>IU de orixes de software</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-repo.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    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>Axuda do xestor de ficheiros</title>
  <para>
    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>
    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>Visor de actualizacións</title>
  <para>
    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>
    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>Descrición das actualizacións</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-updates-overview.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    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>
    You can choose to manually refresh and verify the presence of
    updates by clicking the <guibutton>Refresh</guibutton> button.
  </para>
  <tip><para>
    You can change how often PackageKit refreshes on its own in
    the <link linkend="prefs">Software Update Preferences</link>.
  </para></tip>
  <para>
    There is a option to view the history of updates including
    previous installations, removal or updates of software.
  </para>
  <para>
    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>Información detallada sobre as actualizacións</title>
    <para>
      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>
      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>
      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>Ferramienta Visor de actualizacións</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-updates.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <note><para>
      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>Software Updates Preferences</title>
  <figure>
    <title>Ferramenta de preferencias</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-prefs.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    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>Software Log Viewer</title>
  <figure>
    <title>Visor de rexistro</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-log.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    This tool can be opened using <menuchoice><guimenu>Applications</guimenu>
    <guisubmenu>System Tools</guisubmenu>
    <guimenuitem>Software Log Viewer</guimenuitem></menuchoice>.
  </para>
  <para>
    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>
  <para>
    It can also can be used to roll back to a specific point for package
    backends that support <literal>RollBack</literal>.
 </para>
</section>

<section id="service-pack">
  <title>Creador de «Service packs»</title>
  <figure>
    <title>Creador de «Service packs»</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-service-pack.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    This tool can be opened using <menuchoice><guimenu>Applications</guimenu>
    <guisubmenu>System Tools</guisubmenu>
    <guimenuitem>Service Pack Creator</guimenuitem></menuchoice>.
  </para>
  <para>
    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>
    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>
        You have seven desktops you've just installed with Fedora 9.
        Each one needs to have 204Mb of updates installed.
      </para>
    </listitem>
    <listitem>
      <para>
        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>
        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>
        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>
    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>
    We need a destination file list because we not know what packages are
    installed on the destination computer.
    For example:
  </para>
  <figure>
    <title>Dos equipos de exemplo</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-service-pack-example.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    Computer A has the following packages installed, and has internet access.
  </para>
  <itemizedlist>
    <listitem><para><literal>glib</literal></para></listitem>
    <listitem><para><literal>dbus</literal></para></listitem>
    <listitem><para><literal>dbus-glib</literal></para></listitem>
    <listitem><para><literal>libgnome</literal></para></listitem>
  </itemizedlist>
  <para>
    Computer B has the following packages installed, and does not have internet access.
  </para>
  <itemizedlist>
    <listitem><para><literal>glib</literal></para></listitem>
    <listitem><para><literal>dbus</literal></para></listitem>
    <listitem><para><literal>kdebase</literal></para></listitem>
    <listitem><para><literal>kdeapps</literal></para></listitem>
  </itemizedlist>
  <para>O equipo B quere ter un «Service pack» que conteña unha versión máis nova de <literal>k3b</literal> para poder gravar DVD-RW.</para>
  <para>
    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>
    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>Agora pode transferir o «Service pack» do equipo A ao equipo B nun soporte USB.</para>
  <para>
    The <command>pkgenpack</command> command line tool can also be used for
    creating service pack files.
  </para>
</section>

<section id="auto-updates">
  <title>Actualizaciones automáticas</title>
  <para>
    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>Icona Actualizar</title>
  <para>
     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>Ferramenta de preferencias</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-updates-warning.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
</section>

<section id="eula">
  <title>Aceptar as EULA</title>
  <para>
    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>
    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>Exemplo de EULA</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-eula.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    Be sure to carefully read and accept the EULA text before continuing with
    the install or update.
  </para>
</section>

<section id="gpg-signature">
  <title>Aceptar unha sinatura de seguranza</title>
  <para>
    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>
    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>Exemplo de petición de sinatura</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-signature.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>
    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>Só debería continuar con este diálogo se está seguro de confiar en paquetes deste repositorio de software.</para>
</section>

<section id="dialogs">
  <title>Explicación dos diálogos comúns</title>
  <para>
    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>Copiar ficheiros a outra localización</title>
    <figure>
      <title>Exemplo de diálogo</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-client-copy-local.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>
      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>Instalar ficheiros locais</title>
    <para>Un aplicativo solicitou instalar ficheiros locais no seu sistema. Se vostede iniciou esta acción, prema o botón «instalar».</para>
  </section>

  <section id="dialog-install-catalogs">
    <title>Instalar catálogos</title>
    <para>
      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>Para obter máis información sobre os catálogos, visite as <ulink url="http://www.packagekit.org/pk-faq.html#catalogs" type="http">Preguntas frecuentes</ulink>.</para></note>
  </section>

  <section id="dialog-catalog-none-required">
    <title>Non se precisan paquetes</title>
    <para>
      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>Para obter máis información sobre os catálogos, visite as <ulink url="http://www.packagekit.org/pk-faq.html#catalogs" type="http">Preguntas frecuentes</ulink>.</para></note>
  </section>

  <section id="dialog-application-confirm">
    <title>Confirmación requirida</title>
    <figure>
      <title>Exemplo de diálogo dun engadido</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-client-codecs.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>Un aplicativo precisa o seu permiso antes de modificar paquetes do seu sistema. O nome do programa e a icona son do aplicativo que necesita o seu permiso.</para>
  </section>

  <section id="dialog-finding-requires">
    <title>Buscar outros paquetes requiridos</title>
    <para>
      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>Buscar outros paquetes dependentes</title>
    <para>Este paquete pode necesitar recursos de outros paquetes para funcionar correctamente. Este aplicativo está buscando outros paquetes requiridos polo paquete que está tentando instalar.</para>
  </section>

  <section id="dialog-remove-other-packages">
    <title>Eliminar outros paquetes</title>
    <figure>
      <title>Exemplo de diálogo ao eliminar rarian</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-remove-confirm.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>
      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>Non debería eliminar o paquete se non está seguro.</para></caution>
  </section>

  <section id="dialog-install-other-packages">
    <title>Instalar outros paquetes</title>
    <figure>
      <title>Exemplo de diálogo ao instalar xfce-utils</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-added-deps.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>
      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>Buscar paquetes</title>
    <para>
      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>Paquete non atopado</title>
    <para>
      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>
      Only install packages from reputable software sources.
    </para></caution>
  </section>

  <section id="dialog-progress">
    <title>Xanela de progreso</title>
    <para>
      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>Sen privilexios</title>
    <figure>
      <title>PolicyKit Permissions UI</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-repo-auth.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>
      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>
      If you cannot authenticate, you need to speak to your systems administrator.
    </para></note>
  </section>

  <section id="dialog-no-service">
    <title>No hai ningún servizo de PackageKit executándose</title>
    <para>
      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>Actualizar sistema</title>
    <para>
      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>Actualizar paquetes</title>
    <para>
      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>Actualizar a lista de paquetes</title>
    <para>
      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>
      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>Sobre</title>
  <para>
    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>
    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>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>
