<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY kappname "&kpackage;" -- this only *seems* redundant -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>

<book lang="&language;">
<bookinfo>
<title>The &kpackage; Handbook</title>
<authorgroup>
<author>
<firstname>Toivo</firstname>
<surname>Pedaste</surname>
<affiliation>
<address><email>toivo@ucs.uwa.edu.au</email></address>
</affiliation>
</author>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation>
<address><email>vampyr@atconnex.net</email></address>
</affiliation>
<contrib>Reviewer</contrib>
</othercredit>
</authorgroup>

<copyright>
<year>2000</year>
<holder>Toivo Pedaste</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>4/1/2001</date>

<releaseinfo>2.1.00</releaseinfo>

<abstract><para>&kpackage; is a &GUI; interface to the <acronym>RPM</acronym>,
Debian, Slackware and BSD package managers.</para></abstract>

<keywordset>
<keyword>kpackage</keyword>
<keyword>package</keyword>
<keyword>package manager</keyword>
<keyword>RPM</keyword>
<keyword>deb</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>&kpackage; is a &GUI; interface to the <acronym>RPM</acronym>, Debian,
Slackware and BSD package managers. It is similar in some ways to
<application>GLINT</application>. &kpackage; is part of the K Desktop Environment
and, as a result, it is designed to integrate with the &kde; file manager. </para>

<sect1 id="new">
<title>New</title>

<itemizedlist>
<listitem><para>&kpackage;-2.1</para>
<itemizedlist>
<listitem><para>New popup for installing/uninstalling with list of
 packages and integrated terminal window</para></listitem>
<listitem><para>Use PTY's for talking to programs</para></listitem>
<listitem><para>Debian APT handling </para></listitem>
<listitem><para>RPM 4 support  -  bero</para></listitem>
<listitem><para>Add options panel for which package handlers to use</para></listitem>
<listitem><para>Option for using either ssh or su for calling privileged programs</para></listitem>
<listitem><para>add --remote option</para></listitem>
<listitem><para>Ignore Debian packages with only conf-files installed</para></listitem>
</itemizedlist>
</listitem>

<listitem><para>&kpackage;-2.0</para>
<itemizedlist>
<listitem><para>Only support &Qt;2/&kde;2  </para></listitem>
<listitem><para>Only support RPM3</para></listitem>
<listitem><para>Replace multiple select mode with
<keycombo action="simul"><keycap>Shift</keycap><keycap>Control</keycap> 
<mousebutton>left</mousebutton></keycombo>Mouse
button</para></listitem>
<listitem>
<para>Use <classname>QTextBrowser</classname> widget for package properties
display </para></listitem>
<listitem><para>List dependencies as links to other packages</para></listitem>
<listitem><para>Add Debian distribution site handling </para></listitem>
<listitem><para>change toolbar  to use <acronym>XML</acronym> config, add
<guimenuitem>configure toolbar</guimenuitem> option </para></listitem>
<listitem><para>Use tab bar for selecting package display </para></listitem>
<listitem><para>Don't write empty entries to config file </para></listitem>
<listitem><para>Add subdirs   -   Matthias Mohr
<email>MMohr@SysDesign-EDV.de</email></para></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para><emphasis>Toivo Pedaste</emphasis></para>
<para><email>toivo@ucs.uwa.edu.au</email></para>
</sect1>
</chapter>

<chapter id="onscreen-fundamentals">

<title>Onscreen Fundamentals</title>

<para>&kpackage; has two panels. The left panel displays a tree of the installed
and available packages, the right panel displays information on the
packages.</para>

<sect1 id="drag-and-drop">
<title>Drag and Drop</title>

<para>&kpackage; makes use of the &kde; Drag and Drop protocol. This means that
you can drag and drop packages onto &kpackage; to open them. Dropping a file
onto the <guilabel>Find File</guilabel> dialog will find the package that
contains the file.</para>

</sect1>

<sect1 id="the-package-tree-panel">
<title>The Package Tree Panel</title>

<para>When &kpackage; is started normally (that is it has not been invoked via
drag and drop and has not been given any parameters) it displays two panels with
the package tree on the left, this tree shows installed packages and optionally
new and updated packages as well.</para>

<para>The tabs on the panel select whether to display
<guilabel>installed</guilabel> packages, <guilabel>updated</guilabel> packages,
<guilabel>available</guilabel> packages or all packages</para>

<para>The package tree shows the package name, package size, the version and (in
the case of an available package which would update an installed package) the
version of the already installed package.</para>

<para>Selecting a package from the tree displays information about it in the
right panel and allows:</para>

<itemizedlist>
<listitem><para>Displaying the status information  on the
package</para></listitem>
<listitem><para>Seeing which files are included in an installed package,
selecting a file from the list will open it using the file
manager</para></listitem>
<listitem><para>Verifying files in a package, files that exist are marked with a
tick, files that don't with a cross.</para></listitem>
<listitem><para>Uninstalling an installed package</para></listitem>
<listitem><para>Installing an available package</para></listitem>
</itemizedlist>

<para>A single package is selected by clicking on the name. Clicking on the dot
in the <guilabel>Mark</guilabel> column marks the package with a tick, a second
click unmarks it, while <keycombo
action="simul"><keycap>Shift</keycap><mousebutton>left</mousebutton></keycombo>
click can be used to select a range of packages.</para>

</sect1>

<sect1 id="integrating-available-packages-in-the-tree">
<title>Integrating available packages in the tree</title>

<para>Access to available is setup via the <guimenu>Location</guimenu> menu
entries for each package type under the <guimenu>Settings</guimenu>
menu.</para>

<para>For <acronym>RPM</acronym> packages &kpackage; can read a directory
containing packages and add these to the package tree as either new or updated
packages. It is possible to examine or install these packages from the package
tree. By default the information about the packages is extracted from the
standard format of the file names and so it is necessary to use the
<guibutton>Examine</guibutton> button to see the full description, it is
possible though to set an option so that for local directories each package file
is read, this is slower but gives a full description.</para>

<para>For Debian packages that are handled using dpkg there
 are three ways of accessing available packages,
these can be selected in three different types of location setting
panels. </para>

<itemizedlist>
<listitem><para>Specify the location of the Debian package tree and select the
distribution and architecture, &kpackage; will look in the standard places for the
Package files describing the available packages, these packages are then added
to the package tree and can be examined or installed</para></listitem>
<listitem><para>Specify the location of the the Debian distribution along with
the Packages files for the parts of the distribution that are of interest. If
the <application>dselect</application> program is being used then the file
<filename>/var/lib/dpkg/available</filename> can be used as a Packages file that
describes the distribution that <application>dselect</application>
uses.</para></listitem>
<listitem><para>Packages directories can be handled in the same way as with
<acronym>RPM</acronym> packages.</para></listitem>
</itemizedlist>

<para>For Debian packages that are handled  using APT the location of uninstalled package
repositories is set in the <filename>/etc/apt/sources.list</filename> file, the
<guimenu>Location</guimenu> menu can still be used for directories containing Debian packages. These packages are fetched and
cached by APT itself, not by &kpackage; </para>

<para>For Slackware packages there is very little information stored on
installed packages, but it is possible to use a <filename>PACKAGE.TXT</filename>
file as a source of information about the installed packages. The
<filename>PACKAGES.TXT</filename> file is the equivalent of a Debian Packages
file and Slackware distributions are structured with a directory tree containing
the <literal role="extension">.tgz</literal> packages and a
<filename>PACKAGES.TXT</filename> file that describes the packages.</para>

<para>As with Debian distributions the packages in a Slackware distribution can
be integrated into the package tree. Unfortunately the Slackware packages don't
carry version information so it is not possible to tell with available packages
are newer than installed ones.</para>

<para>For <acronym>BSD</acronym> packages &kpackage; will understand a packages
distribution directory that contains an <filename>INDEX</filename> file (which
describes all the packages) and also contains an <filename>All</filename>
directory (with all the package files in it). </para>

<para>For remote directories and package files (&ie; those fetched via &FTP;)
&kpackage; will do caching, the packages are cached in
<filename>~/.kpackage</filename> and the directories in
<filename>~/.kpackage/dir</filename></para>

<note><para>For the handling of remote (&FTP;) directories to work it may be
necessary not have the <guilabel>FTP Proxy</guilabel> set in the Browser
Settings.</para></note>

</sect1>

<sect1 id="package-information-panel">
<title>Package Information Panel</title>

<para>The right panel has tabs for displaying two different types of information
about selected packages </para>

<itemizedlist>
<listitem><para>The <guilabel>Properties</guilabel> tab which displays
information on the selected package. In the dependency information there are
hyper-links to the packages listed, installed packages are in standard font,
uninstalled packages are in italic.</para></listitem>
<listitem><para>The <guilabel>File List</guilabel> tab shows the files in the
package and for installed packages shows the state of the
files.</para></listitem>
</itemizedlist>

</sect1>

<sect1 id="root-access">
<title>Root Access</title>

<para> &kpackage; requires root access for installing/uninstalling
packages, this can be can be done by running &kpackage; as root, say
by using kdesu .</para>

<para>Alternatively, if &kpackage; is running as a normal user it
will try to run the install/uninstall programs a root by logging
in to a psuedo terminal, it will use either SU or SSH to do this
and if needed it will pop up a terminal window where the root password
can be typed. For this to work the root prompt has to end in "# " .</para>

<para>This doesn't work for <acronym>RPM</acronym> packages, because
they are handled internally by &kpackage; . </para>

</sect1>

<sect1 id="installing-packages">
<title>Installing Packages</title>

<para>To install a package you can</para>
<itemizedlist>
<listitem><para>locate the package you wish to install in &konqueror;, drag it
onto a running copy of &kpackage;</para></listitem>
<listitem><para>click on a package file in &konqueror; and start a new copy of
&kpackage;</para></listitem> 
<listitem><para>use on the <guimenu>Open</guimenu> menu items in
&kpackage;</para></listitem>
<listitem><para>selecting an available package in the package
tree</para></listitem>
</itemizedlist>

<para>For a selected package, use the buttons in the right panel, the
<guibutton>Fetch</guibutton> button will fetch the package from a remote source
and display detailed information, the <guibutton>Install</guibutton> button pops up
the installation window. </para>

<para>For marked packages, use the button in the left panel, the
<guibutton>Install Marked</guibutton> button pops up the install
window.</para>

<para>The install window lists the packages to be installed and allows
the setting of install options. The panel on the right is an integrated
terminal window in which the installation programs are run, for interactive
installation programs the interaction is done in this window. </para>

<para><acronym>RPM</acronym> packages are handled slightly differently from
other package types, since the installation is done directly by &kpackage; ,
the right panel is only used for error messages. </para>

</sect1>

<sect1 id="uninstalling-packages">
<title>Uninstalling Packages</title>

<para>A selected package can be uninstalled by using the
<guibutton>Uninstall</guibutton> button in the right panel, this brings up a
window with the uninstall options, the <guibutton>Uninstall</guibutton> button in
the window causes the packages to be uninstalled, and the right panel provides
an integrated terminal window for the uninstall programs.</para>

<para>Marked packages can be uninstalled using the <guibutton>Uninstall
Marked</guibutton> button in the left panel.</para>

</sect1>

</chapter>
<chapter id="menus">

<title>Menus</title>

<para>This describes the &kpackage; menus. </para>

<sect1 id="file-menu">
<title><guimenu>File</guimenu> menu</title>

<para>The items in the <guimenu>File</guimenu> menu are:</para>

<variablelist>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
<keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>O</accel>pen</guimenuitem></menuchoice></term>
<listitem><para>Brings up file selector for local and &FTP;
files</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Open <accel>R</accel>ecent</guimenuitem></menuchoice></term>
<listitem><para>A list of the most recently open package files</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
<keycap>Ctrl</keycap><keycap>F</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu><guimenuitem>Find
<accel>P</accel>ackage</guimenuitem></menuchoice></term>
<listitem><para>Search the installed package list for a package who's name
contains the entered string </para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Find <accel>F</accel>ile</guimenuitem></menuchoice></term>
<listitem><para>Produces a list of packages that contain the entered file
name, selecting a line will display the information on that package. It
behaves slightly differently for <acronym>RPM</acronym> (where you have to enter
the exact file name) and <abbrev>DEB</abbrev> (where you can enter a regular
expression).</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>R</accel>eload</guimenuitem></menuchoice></term>
<listitem><para>Reread the package data and rebuild the package
tree</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul">
<keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>Q</accel>uit</guimenuitem></menuchoice></term>
<listitem><para>Quit &kpackage; </para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="packages-menu">
<title><guimenu>Packages</guimenu> menu</title>

<para>The items in the <guimenu>Packages</guimenu> menu are:</para>

<variablelist>
<varlistentry>
<term><menuchoice><guimenu><accel>P</accel>ackages</guimenu>
<guimenuitem><accel>B</accel>ack</guimenuitem></menuchoice></term>
<listitem><para>Back button for navigation using the links in
<guilabel>Properties</guilabel> entries in the right panel.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>P</accel>ackages</guimenu>
<guimenuitem><accel>F</accel>orward</guimenuitem></menuchoice></term>
<listitem><para>Forward button for navigation using the links in
<guilabel>Properties</guilabel> entries in the right panel..</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>P</accel>ackages</guimenu>
<guimenuitem><accel>E</accel>xpand Tree</guimenuitem></menuchoice></term>
<listitem><para>Fully expands the packages tree</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>P</accel>ackages</guimenu>
<guimenuitem><accel>C</accel>ollapse Tree</guimenuitem> </menuchoice></term>
<listitem><para>Collapses the package tree so that only the tree structure is
shown</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <guimenu><accel>P</accel>ackages</guimenu>
<guimenuitem>Clear <accel>M</accel>arked</guimenuitem> </menuchoice></term>
<listitem><para>Unmarks all packages</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="cache-menu">
<title><guimenu>Cache</guimenu> menu</title>

<para>The items in the <guimenu>Cache</guimenu> menu are: </para>
<variablelist>
<varlistentry>
<term><menuchoice><guimenu><accel>C</accel>ache</guimenu> <guimenuitem>Clear
Package <accel>D</accel>irectory Cache</guimenuitem></menuchoice></term>
<listitem><para>Delete cached copies of remote package directories and Packages
files</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>C</accel>ache</guimenu><guimenuitem>Clear <accel>P</accel>ackage
Cache</guimenuitem>
</menuchoice></term>
<listitem><para>Delete cached copies of remote package files that have been
fetched</para> </listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="special-menu">
<title><guimenu>Special</guimenu> menu</title>

<para>The <guimenu>Settings</guimenu> contains actions
related to specific package types:</para>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Spe<accel>c</accel>ial</guimenu><guimenuitem>
<accel>D</accel>ebApt</guimenuitem>
</menuchoice></term>
<listitem>

<variablelist>

<varlistentry>
<term><guilabel>Update</guilabel></term>
<listitem><para>Update APT indexes from package repositories.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Upgrade</guilabel></term>
<listitem><para>Upgrade the Debian installation to the latest versions
of all the packages.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Fixup</guilabel></term>
<listitem><para>APT is extremely strict about dependencies, attempt
to fixup dependency problems</para></listitem>
</varlistentry>

</variablelist>

</listitem>

</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title><guimenu>Settings</guimenu> menu</title>

<para>The items in the <guimenu>Settings</guimenu> menu are:</para>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Show
<accel>T</accel>oolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Toggle displaying the toolbar</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem><accel>S</accel>ave
Settings</guimenuitem></menuchoice></term>
<listitem><para>Save options immediately</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Configure
<accel>K</accel>ey Bindings</guimenuitem></menuchoice></term>
<listitem><para>The standard &kde; dialog for setting shortcut
keys</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Configure
Tool<accel>b</accel>ars</guimenuitem></menuchoice></term>
<listitem><para>The standard &kde; dialog for configuring tool
bars</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem><accel>O</accel>ptions</guimenuitem></menuchoice></term>
<listitem>

<variablelist>
<varlistentry>
<term><guilabel>Types</guilabel></term>
<listitem><para>Which package types to handle, Debian using DPKG and
Debian using APT are listed separately, it is not a good idea to
enable both at the same time.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Directory Cache</guilabel></term>
<listitem><para>Whether to cache remote (&FTP;ed)  directories and Package
files.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Package Cache</guilabel></term>
<listitem><para>Whether to cache remote package files that have been fetched
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>misc</guilabel></term>
<listitem>
<variablelist>

<varlistentry>
<term><guilabel>Use SSH for privileged commands</guilabel></term>
<listitem><para>Use SSH instead of SU for running privileged commands</para> </listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Verify file list</guilabel></term>
<listitem><para>If set the list of files in the package is checked to see if
they are actually installed</para> </listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Read information from all local package files</guilabel></term>
<listitem><para>If set all the files from a (local) package directory are read
instead of just using the files names, this is slower but shows more
information.</para></listitem>
</varlistentry>

</variablelist>

</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu> <guisubmenu>Location of available
packages</guisubmenu></menuchoice></term>
<listitem>
<variablelist>
<varlistentry>
<term><guimenuitem>Location RPM</guimenuitem></term>
<listitem><para>This provides for specifying the location of package directories
(either local or &FTP;), each line includes an entry where the
<acronym>URL</acronym> or name of the directory can be typed in, a
<guibutton>...</guibutton> button that brings up a file selector and a
<guilabel>Use</guilabel> radio button that determines whether the directory
given in the line is to be used or not. The <guilabel>SubDirs</guilabel> radio 
button indicates whether to recurse down into sub-directories.  The multiple
panels are just for convenience.</para></listitem>
</varlistentry>

<varlistentry>
<term> Location BSD</term>
<listitem><para>The first panel gives the location of the ports tree in the file
system </para>
<para>The other panel allows the specifying the location of packages directories
&ie; those containing <filename>INDEX</filename>
files</para></listitem>
</varlistentry>

<varlistentry>
<term>Location DEB</term>
<listitem><para>There are three different types of panels.</para>
<itemizedlist>
<listitem><para>The first three panels have an entry for the location of the
Debian distribution tree, a combo box for the distribution name and a combo box
for the architecture</para></listitem>
<listitem><para>The next two panels allow the specification of a Debian
distribution tree and the location of Packages files in that
distribution.</para></listitem>
<listitem><para> The last three panels specify directories the same way as for
RPMs.</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term>Location SLACK</term>
<listitem><para>For Slackware packages there are three types of panels</para>
<itemizedlist>
<listitem><para>The first panel is the location of a
<filename>PACKAGES.TXT</filename> file which is used to provided information on
the installed packages</para></listitem>
<listitem><para>The next four panels can be used to specify the location of
distributions with the directory tree containing the <literal
role="extension">.tgz</literal> files and the location of the corresponding
<filename>PACKAGES.TXT</filename> file</para></listitem>
<listitem><para>The last two panels are for directories that do
<emphasis>not</emphasis> have a corresponding <filename>PACKAGES.TXT</filename>
file</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="help-menu">
<title><guimenu>Help</guimenu> menu</title>

<para>The items in the <guimenu>Help</guimenu> menu are: </para>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycap>F1</keycap></shortcut>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>C</accel>ontents</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the Help file for &kpackage; (this document)</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Shift</keycap><keycap>F1</keycap>
</keycombo></shortcut>
<guimenu><accel>H</accel>elp</guimenu><guimenuitem>What's
<accel>T</accel>his...</guimenuitem></menuchoice></term>
<listitem><para>Turns the cursor into a question mark (?), enabling you to click
on an icon or other item in the &kpackage; window, and receive a short paragraph of
help about the selected item.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu><guimenuitem><accel>R</accel>eport
Bug</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a dialog box enabling you to report a bug, or enter an
item on the "wish list" for a feature you would like to see in an upcoming
version of &kpackage;</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu><guimenuitem><accel>A</accel>bout
KPackage</guimenuitem></menuchoice></term>
<listitem><para>Shows version and credit information about
&kpackage;</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu> <guimenuitem>About
<accel>K</accel>DE</guimenuitem></menuchoice></term>
<listitem><para>Shows version and credit information about KDE</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="toolbar">
<title>Toolbar</title>

<itemizedlist>
<listitem><para><guiicon>Open</guiicon></para></listitem>
<listitem><para><guiicon>Back</guiicon></para></listitem>
<listitem><para><guiicon>Forward</guiicon></para></listitem>
<listitem><para><guiicon>Expand Package Tree</guiicon></para></listitem>
<listitem><para><guiicon>Collapse Package Tree</guiicon></para></listitem>
<listitem><para><guiicon>Find Package</guiicon></para></listitem>
<listitem><para><guiicon>Find File</guiicon></para></listitem>
<listitem><para><guiicon>Reload</guiicon></para></listitem>
<listitem><para><guiicon>Quit</guiicon></para></listitem>
</itemizedlist>
</sect1>
</chapter>

<chapter id="credits-and-licenses">
<title>Credits and Licenses</title>

<para>
&kpackage;
</para>
<para>Program copyright 1999-2000 Damyan Pepper, Toivo Pedaste</para>

<para>Documentation copyright 2000 Toivo Pedaste
<email>toivo@ucs.uwa.edu.au</email></para>

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="how-to-obtain-kpackage">
<title>How to obtain &kpackage;</title>

<para>&kpackage; is now part of the &kde;2 <acronym>CVS</acronym> tree, in the
kdeadmin package.</para>

<para>For information on how to obtain and compile it see <ulink
url="http://www.kde.org/install-source.html">
http://www.kde.org/install-source.html</ulink></para>

<para>There is more information on compilation at <ulink
url="http://www.kde.org/compilationfaq.html">
http://www.kde.org/compilationfaq.html</ulink></para>

<para>There is a web page at  <ulink
url="http://www.general.uwa.edu.au/u/toivo/kpackage">
http://www.general.uwa.edu.au/u/toivo/kpackage</ulink></para>

</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>For installing &kpackage; you need:</para>

<itemizedlist>
<listitem><para>&Qt;2 and &kde; 2 </para></listitem>
</itemizedlist>

<para>For listing Debian packages no other software is needed but to install and
unistall the packages you need:</para>

<itemizedlist>
<listitem><para>the <application>dpkg</application> package
manager or</para></listitem>

<listitem><para> <application>apt-get</application> and 
<application>apt-cache</application></para></listitem>
</itemizedlist>

<para>For BSD packages you need the package management programs: </para>

<itemizedlist>
<listitem><para><application>pkg_info</application></para></listitem>
<listitem><para><application>pkg_add</application></para></listitem>
<listitem><para><application>pkg_delete</application></para></listitem>
</itemizedlist>

<para>For Slackware packages  you need: </para>

<itemizedlist>
<listitem><para><application>installpkg</application> </para></listitem>
<listitem><para><application>removepkg</application></para></listitem>
</itemizedlist>

<para>For dealing with Redhat packages you need:</para>
<itemizedlist>
<listitem><para><acronym>RPM</acronym> and RPM-DEVEL:   3.0 or 4.0</para></listitem>
<listitem><para>the same libraries as compiling <acronym>RPM</acronym> does. These
are:</para>
<itemizedlist>
<listitem><para><filename>libdb</filename> - the Berkeley database library
</para></listitem>
<listitem><para><filename>libz</filename> and <filename>libz-dev</filename>  -
compression library </para></listitem>
<listitem><para><acronym>RPM</acronym> requires the
<application>gettext</application> routine which is found in
<filename>libc6</filename> or in <filename>libintl</filename></para></listitem>
<listitem><para><acronym>RPM</acronym> 3.0 may require the <filename>popt</filename>
package</para></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para>For &kpackage; to work correctly with <acronym>RPM</acronym> packages the
<acronym>RPM</acronym> database must be initialized. If typing
<userinput><command>rpm</command> <option>-qa</option></userinput> gives an
error about <computeroutput>unable to open....</computeroutput> then try
<userinput><command>rpm</command>
<option>--rebuilddb</option></userinput>'.</para>

</sect1>

</appendix>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
