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

  <articleinfo>
    <title><application>gnome-packagekit</application> ਦਸਤਾਵੇਜ਼</title>
    <abstract role="description">
      <para>
        <application>gnome-packagekit</application> is a suite of tools for integration with the GNOME desktop.
      </para>
    </abstract>
    <copyright>
      <year>੨੦੦੮</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>ਰਿਚਰਡ ਹੱਘਸ</publishername>
    </publisher>

     <legalnotice id="legalnotice">
	<para>
	  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> 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>ਰਿਚਰਡ</firstname>
        <surname>ਹੱਘਸ</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>੩.੦</revnumber>
        <date>2008-03-31</date>
        <revdescription>
          <para role="author">ਰਾਹੁਲ ਸੁੰਦਰਮ <email>sundaram@fedoraproject.org</email></para>
          <para role="publisher">ਰਾਹੁਲ ਸੁੰਦਰਮ</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>੨.੦</revnumber>
        <date>2007-08-30</date>
        <revdescription>
          <para role="author">Richard Hughes <email>richard@hughsie.com</email></para>
          <para role="publisher">ਰਿਚਰਡ ਹੱਘਸ</para>
        </revdescription>
      </revision>
    </revhistory>

    <legalnotice>
      <title>ਸੁਝਾਅ</title>
      <para>
        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">
    <primary><application>ਗਨੋਮ-ਪੈਕੇਜਕਿੱਟ</application></primary>
  </indexterm>
  <indexterm zone="index">
    <primary>gpk-application</primary>
  </indexterm>

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<section id="intro">
  <title>ਜਾਣ ਪਛਾਣ</title>
  <!-- manrevision 2.0 compatibility -->
  <anchor id="aboutex"/>
  <anchor id="notice"/>
  <indexterm>
    <primary><application>ਗਨੋਮ-ਪੈਕੇਜਕਿੱਟ</application></primary>
    <secondary>ਦਸਤਾਵੇਜ਼</secondary>
    <tertiary>gpk-application</tertiary>
  </indexterm>

  <para>ਗਨੋਮ-ਪੈਕੇਜਕਿੱਟ <systemitem>ਗਨੋਮ ਡੈਸਕਟਾਪ</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>ਪਾਲਸੀਕਿੱਟ ਅਧਿਕਾਰ UI</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-repo-auth.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>

</section>

<section id="application">
  <title>ਐਪਲੀਕੇਸ਼ਨ</title>
  <para>
    <application>packagekitd</application> is started automatically when it is
    needed. <command>pkcon</command> offers a versatile commandline 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>ਕਮਾਂਡ ਲਾਈਨ</term>
      <listitem>
        <para><command>gpk-application</command>: ਸਾਫਟਵੇਅਰ ਸ਼ਾਮਲ/ਹਟਾਓ</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>ਕਮਾਂਡ ਲਾਈਨ</term>
      <listitem>
        <para><command>gpk-update-viewer</command>: ਤੁਹਾਡਾ ਸਿਸਟਮ ਅੱਪਡੇਟ ਕਰਨ ਵਾਸਤੇ। ਅੱਪਡੇਟ ਦੇ ਅਤੀਤ ਬਾਰੇ ਜਾਣਕਾਰੀ ਵੀ ਵੇਖ ਸਕਦੇ ਹੋ।</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>ਕਮਾਂਡ ਲਾਈਨ</term>
      <listitem>
        <para><command>gpk-prefs</command>: ਸਾਫਟਵੇਅਰ ਅੱਪਡੇਟ ਪਸੰਦ ਦੀ ਸੰਰਚਨਾ ਲਈ</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>ਕਮਾਂਡ ਲਾਈਨ</term>
      <listitem>
        <para><command>gpk-repo</command>: ਸਾਫਟਵੇਅਰ ਰਿਪੋਜ਼ਟਰੀਆਂ ਚਾਲੂ ਜਾਂ ਬੰਦ ਕਰਨ ਲਈ</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>ਕਮਾਂਡ ਲਾਈਨ</term>
      <listitem>
        <para><command>gpk-log</command>: ਅੱਪਡੇਟ ਦਾ ਅਤੀਤ, ਜਿਸ ਵਿੱਚ ਕਿਸੇ ਸਾਫਟਵੇਅਰ ਨੂੰ ਇੰਸਟਾਲ ਕਰਨ, ਹਟਾਉਣ ਜਾਂ ਅੱਪਡੇਟ ਕਰਨ ਬਾਰੇ ਜਾਣਕਾਰੀ ਹੈ</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>ਕਮਾਂਡ ਲਾਈਨ</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>ਕਮਾਂਡ ਲਾਈਨ</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>ਕਮਾਂਡ ਲਾਈਨ</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>ਸਾਫਟਵੇਅਰ ਸ਼ਾਮਲ/ਹਟਾਓ</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>ਫਿਲਟਰ ਨਾਲ ਗਰੁੱਪ ਦੀ ਖੋਜ ਕਰਨੀ</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>ਫਿਲਟਰ</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 menuitem 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 commandline 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>ਸਾਫਟਵੇਅਰ ਲਈ ਖੋਜ ਕਰਨੀ</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>ਸਾਫਟਵੇਅਰ ਸਰੋਤ</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>ਸਾਫਟਵੇਅਰ ਸਰੋਤ UI</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>ਫਾਇਲ ਹੈਂਡਲਰ ਮੱਦਦਗਾਰ</title>
  <para>
    Sometimes you will not have the software on your system to open a particular
    file. If the file type is not recognised, 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 distro 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>ਅੱਪਡੇਟ ਦਰਸ਼ਕ</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>ਅੱਪਡੇਟ ਸਾਰ</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>ਅੱਪਡੇਟ ਬਾਰੇ ਵੇਰਵੇ ਸਮੇਤ ਜਾਣਕਾਰੀ</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>ਅੱਪਡੇਟ ਦਰਸ਼ਕ ਟੂਲ</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>ਸਾਫਟਵੇਅਰ ਅੱਪਡੇਟ ਪਸੰਦ</title>
  <figure>
    <title>ਮੇਰੀ ਪਸੰਦ ਟੂਲ</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>ਸਾਫਟਵੇਅਰ ਲਾਗ ਦਰਸ਼ਕ</title>
  <figure>
    <title>ਲਾਗ ਦਰਸ਼ਕ</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>ਸਰਵਿਸ ਪੈਕ ਨਿਰਮਾਤਾ</title>
  <figure>
    <title>ਸਰਵਿਸ ਪੈਕ ਨਿਰਮਾਤਾ</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>ਦੋ ਉਦਾਹਰਨ ਕੰਪਿਊਟਰ</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-service-pack-example.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>ਕੰਪਿਊਟਰ ੳ ਉੱਤੇ ਅੱਗੇ ਦਿੱਤੇ ਪੈਕੇਜ ਇੰਸਟਾਲ ਹਨ ਤੇ ਇਸ ਉੱਤੇ ਇੰਟਰਨੈੱਟ ਅਸੈੱਸ ਹੈ।</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>ਕੰਪਿਊਟਰ ਅ ਉੱਤੇ ਹੇਠ ਦਿੱਤੇ ਪੈਕੇਜ ਇੰਸਟਾਲ ਹਨ ਤੇ ਇਸ ਉੱਤੇ ਇੰਟਰਨੈੱਟ ਅਸੈੱਸ ਨਹੀਂ ਹੈ।</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>ਕੰਪਿਊਟਰ ਅ ਸਰਵਿਸ ਪੈਕ ਚਾਹੁੰਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ <literal>k3b</literal> ਦਾ ਨਵਾਂ ਵਰਜਨ ਹੋਵੇ ਤਾਂ ਕਿ ਇਹ DVD-RW ਲਿਖ ਸਕੇ।</para>
  <para>
    The <literal>k3b</literal> program has dependancies 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 CDRW 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>ਹੁਣ ਸਰਵਿਸ ਪੈਕ ਨੂੰ ਕੰਪਿਊਟਰ ੳ ਤੋਂ ਕੰਪਿਊਟਰ ਅ ਉੱਤੇ USB ਪੈੱਨ ਡਰਾਇਵ ਨਾਲ ਟਰਾਂਸਫਰ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ।</para>
  <para><command>pkgenpack</command> ਕਮਾਂਡ ਲਾਈਨ ਟੂਲ ਨੂੰ ਸਰਵਿਸ ਪੈਕ ਫਾਇਲਾਂ ਬਣਾਉਣ ਲਈ ਵਰਤਿਆ ਜਾ ਸਕਦਾ ਹੈ।</para>
</section>

<section id="auto-updates">
  <title>ਆਟੋਮੈਟਿਕ ਅੱਪਡੇਟ</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>ਅੱਪਡੇਟ ਆਈਕਾਨ</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>ਮੇਰੀ ਪਸੰਦ ਟੂਲ</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-updates-warning.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
</section>

<section id="eula">
  <title>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>ਉਦਾਹਰਨ EULA</title>
    <screenshot>
      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/gpk-eula.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
  </figure>
  <para>ਇੰਸਟਾਲ ਜਾਂ ਅੱਪਡੇਟ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ EULA ਟੈਕਸਟ ਨੂੰ ਧਿਆਨ ਨਾਲ ਪੜ੍ਹੋ ਤੇ ਮੰਨੋ।</para>
</section>

<section id="gpg-signature">
  <title>ਸੁਰੱਖਿਆ ਦਸਤਖਤ ਮਨਜ਼ੂਰ ਕਰਨੇ</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>ਉਦਾਹਰ ਦਸਤਖਤ ਪਰੌਉਟ</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>
    You should only proceed with this dialog if you are happy to trust packages
    from this software source.
  </para>
</section>

<section id="dialogs">
  <title>ਆਮ ਡਾਈਲਾਗ ਵਰਣਨ</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>ਫਾਇਲਾਂ ਹੋਰ ਟਿਕਾਣੇ ਉੱਤੇ ਕਾਪੀ ਕਰਨੀਆਂ</title>
    <figure>
      <title>ਡਾਈਲਾਗ ਉਦਾਹਰਨ</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>ਲੋਕਲ ਫਾਇਲਾਂ ਇੰਸਟਾਲ ਕਰਨੀਆਂ</title>
    <para>
      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>ਕੈਟਾਲਾਗ ਇੰਸਟਾਲ ਕਰਨੇ</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>ਕੈਟਾਲਾਗ ਬਾਰੇ ਹੋਰ ਜਾਣਕਾਰੀ ਲੱਭਣ ਲਈ, <ulink url="http://www.packagekit.org/pk-faq.html#catalogs" type="http">ਸਵਾਲ-ਜਵਾਬ</ulink>ਵੇਖੋ</para></note>
  </section>

  <section id="dialog-catalog-none-required">
    <title>ਕੋਈ ਪੈਕੇਜ ਨਹੀਂ ਚਾਹੀਦਾ</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>ਕੈਟਾਲਾਗ ਬਾਰੇ ਹੋਰ ਜਾਣਕਾਰੀ ਲੱਭਣ ਲਈ, <ulink url="http://www.packagekit.org/pk-faq.html#catalogs" type="http">ਸਵਾਲ-ਜਵਾਬ</ulink>ਵੇਖੋ</para></note>
  </section>

  <section id="dialog-application-confirm">
    <title>ਪੁਸ਼ਟੀ ਦੀ ਲੋੜ ਹੈ</title>
    <figure>
      <title>ਪਲੱਗਇਨ ਡਾਈਲਾਗ ਉਦਾਹਰਨ</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/gpk-client-codecs.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>
      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>ਹੋਰ ਲੋੜੀਦੇ ਪੈਕੇਜ ਲੱਭਣੇ</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>ਹੋਰ ਨਿਰਭਰ ਪੈਕੇਜ ਲੱਭਣੇ</title>
    <para>
      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>ਹੋਰ ਪੈਕੇਜ ਹਟਾਉਣੇ</title>
    <figure>
      <title>Example dialog when removing 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>ਜੇ ਤੁਸੀਂ ਪੈਕੇਜ ਹਟਾਉਣ ਬਾਰੇ ਯਕੀਨੀ ਨਹੀਂ ਹੋ ਤਾਂ ਤੁਹਾਨੂੰ ਨਹੀਂ ਹਟਾਉਣੇ ਚਾਹੀਦੇ।</para></caution>
  </section>

  <section id="dialog-install-other-packages">
    <title>ਹੋਰ ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰਨੇ</title>
    <figure>
      <title>Example dialog when installing 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>ਪੈਕੇਜ ਲੱਭਣੇ</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>ਪੈਕੇਜ ਨਹੀਂ ਲੱਭਿਆ</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>ਮੰਨੇ-ਪਰਮੰਨੇ ਸਾਫਟਵੇਅਰ ਸਰੋਤ ਤੋਂ ਹੀ ਪੈਕੇਜ ਇੰਸਟਾਲ ਕਰੋ।</para></caution>
  </section>

  <section id="dialog-progress">
    <title>ਤਰੱਕੀ ਵਿੰਡੋ</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>ਅਧਿਕਾਰ ਨਹੀਂ</title>
    <figure>
      <title>ਪਾਲਸੀਕਿੱਟ ਅਧਿਕਾਰ 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>ਜੇ ਤੁਸੀਂ ਪਰਮਾਣਿਤ ਨਹੀਂ ਹੋ ਸਕੇ ਤਾਂ ਤੁਹਾਨੂੰ ਆਪਣੇ ਸਿਸਟਮ ਪਰਸ਼ਾਸ਼ਕ ਨਾਲ ਗੱਲ ਕਰਨ ਦੀ ਲੋੜ ਹੈ।</para></note>
  </section>

  <section id="dialog-no-service">
    <title>ਕੋਈ ਪੈਕੇਜਕਿੱਟ ਸਰਵਿਸ ਨਹੀਂ ਚੱਲ ਰਹੀ</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>ਸਿਸਟਮ ਅੱਪਡੇਟ ਕਰੋ</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>ਪੈਕੇਜ ਅੱਪਡੇਟ</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>ਪੈਕੇਜ ਲਿਸਟ ਤਾਜ਼ਾ ਕੀਤੀ ਜਾ ਰਹੀ ਹੈ</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>ਇਸ ਬਾਰੇ</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>
