<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!-- Define an entity for your application if it is not part of KDE
       CVS -->
  <!ENTITY kget "<application>KGet</application>">
  <!ENTITY kappname "&kget;"><!-- replace kget here
                                            do *not* replace kappname-->
  <!ENTITY package "kdenetwork">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE"> 
]>

<book lang="&language;">

<bookinfo>
<title>The &kget; Handbook</title>

<authorgroup>
<author>
<personname>
<firstname>Jonathan</firstname>
<othername>E.</othername>
<surname>Drews</surname>
</personname>
<email>j.e.drews@att.net</email>
</author>

<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>2003</year>
<holder>Jonathan E. Drews</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>

<date>2003-11-11</date>
<releaseinfo>0.01.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para>
&kget; allows you to group downloads. In some cases, &kget; can resume these
downloads even if you shutdown your computer before the downloads have completed.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kdeutils</keyword>
<keyword>kget</keyword>
<keyword>kppp</keyword>
<keyword>nothing else</keyword>
</keywordset>

</bookinfo>

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

<para>
To download a document or package, drag and drop the &URL; on to &kget;.

</para>
</chapter>

<chapter id="using-kget">
<title>Using &kget;</title>

<sect1 id="kget-features">
<title>&kget; Tutorial</title>

<para>Here is a brief tutorial that uses some of the features of &kget;. Below
are three software packages that are to be downloaded. Suppose you want to 
download the middle one first and then the top and bottom ones second. 
</para>


<orderedlist>
<listitem>
<para>
Place &kget; in offline mode. Click on 
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_offline_mode_on.png" format="PNG"/>
	  </imageobject></inlinemediaobject>  to change it to 
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_offline_mode_off.png" format="PNG"/>
	  </imageobject></inlinemediaobject>.
</para>
</listitem>

<listitem>
<para>
Click on the top entry with the &LMB;. Hold down the &Ctrl; key and click on the bottom entry. &kget;
should look similar to this:

<screenshot>
<screeninfo>Screenshot of Kget</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kget1.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Items to be downloaded from Konqueror</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>


</listitem>

<listitem><para>
Click on the delay button <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_delay.png" format="PNG"/>
	  </imageobject></inlinemediaobject> to prevent these items from being
downloaded.
</para></listitem>

<listitem><para>
Now click on the middle entry to highlight it. The top and bottom items will no
longer be highlighted.
<screenshot>
<screeninfo>Screenshot of Kget</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kget2.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Items to be downloaded from Konqueror</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para></listitem>

<listitem><para>
Click on 
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_offline_mode_off.png" format="PNG"/>
	  </imageobject></inlinemediaobject> to change it to online
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_offline_mode_on.png" format="PNG"/>
	  </imageobject></inlinemediaobject> and &kget; will download the
	  middle item.
</para></listitem>

<listitem><para>
Click on the top item, hold down the &Shift; key and click on the bottom item. &kget;
should look like this:
<screenshot>
<screeninfo>Screenshot of Kget</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kget3.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Items to be downloaded from Konqueror</phrase>
	  </textobject>
	</mediaobject>
</screenshot>


<note><para>
Holding down the &Ctrl; key allows you to select individual items;
holding down the &Shift; key allows you to select consecutive items,
while clicking with the &LMB;.
</para></note></para>

</listitem>

<listitem><para>
Now click on 
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_queue.png" format="PNG"/>
	  </imageobject></inlinemediaobject> to download the two highlighted
 items.
</para></listitem>

</orderedlist>
</sect1>
</chapter>

<chapter id="commands">
<title>Command Reference</title>

<sect1 id="kapp-mainwindow">
<title>The main &kget; window</title>

<sect2>
<title>The <guimenu>File</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Open</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the transfer window where you can paste &URL;'s.
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="fileopen.png" format="PNG"/>
	  </imageobject></inlinemediaobject> </action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Paste</guimenuitem>
</menuchoice></term>
<listitem><para><action>Pastes the contents of the clipboard into the
transfer window. The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_paste.png" format="PNG"/>
	  </imageobject></inlinemediaobject></action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Export Transfer List ...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a Save As window </action> that allows you to save
highlighted &URL;'s to a <filename>.kget</filename> file. To use this feature:
</para>
<itemizedlist>
<listitem><para>
Place &kget; in offline mode by clicking on 
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_offline_mode_on.png" format="PNG"/>
	  </imageobject></inlinemediaobject>  to change it to offline  
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_offline_mode_off.png" format="PNG"/>
	  </imageobject></inlinemediaobject>.
</para></listitem>
<listitem><para>
Drag the &URL;'s you wish to download on to &kget;.
</para></listitem>

<listitem><para>
Next click on the top entry so that it is highlighted.
</para></listitem>

<listitem><para>
Hold down the  <userinput><keycombo>
<keycap>Shift</keycap></keycombo></userinput>
key and click on the bottom &URL; to highlight the entries like so:
<screenshot>
<screeninfo>Picture of kget for saving to export file</screeninfo>
	<mediaobject>
               <imageobject>
	    <imagedata fileref="kget4.png" format="PNG"/>
	       </imageobject>
        </mediaobject>
</screenshot>
</para></listitem>

<listitem><para>
Now click on <menuchoice><guimenu>File</guimenu>
<guimenuitem>Export Transfer List...</guimenuitem></menuchoice> and enter the name of the
<filename>.kget</filename> file for your downloads.
</para></listitem>
</itemizedlist>


<para>This feature is used to save items that will be downloaded on a
regular basis, such as the &kde; snapshots above.
</para>
</listitem>

</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Import Transfer File ...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Loads <filename>.kget</filename> files that were created with
<menuchoice><guimenu>File</guimenu>
<guimenuitem>Export Transfer List ...</guimenuitem></menuchoice>
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Import Text File ...</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Imports &URL;'s that are in text files.</action> This is a powerful feature that allows
you to parse &URL;'s from text files and emails you may have received. It can 
discriminate between ordinary text and &URL;'s, provided the &URL; begins at the 
left margin of the document. &kget; will find these &URL;'s and load them into
its main window for you. 
<note><para>This feature only ignores regular text when you have clicked on
the Expert Mode icon<inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_expert.png" format="PNG"/>
	  </imageobject></inlinemediaobject>. If the Expert Mode is not used
	  then the text file must contain only &URL;'s.
</para></note> 
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quits &kget;</action></para></listitem>
</varlistentry>
</variablelist>


</sect2>

<sect2>
<title>The <guimenu>View</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Show Log Window</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Opens a log window that shows the events that have occurred. This is useful
for seeing what happened during a lengthy download. Here you can see if any
packages were skipped or if a connection timed out. 
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_logwindow.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Drop Target</guimenuitem>
</menuchoice></term>
<listitem><para><action>The drop target is a desktop icon that allows for hiding
and restoring of &kget;. This is used on a cluttered desktop when you want to
periodically check the status of a download.
The shortcut button is <inlinemediaobject><imageobject>
    <imagedata fileref="cr22-action-tool_drop_target.png" format="PNG"/>
	  </imageobject></inlinemediaobject> </action></para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>The Transfer Menu</title>
<note><para>
In order for the entries in this menu to become active (not grayed out), you
must highlight a download by clicking on the entry with the &LMB;.
</para></note>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Copy &URL; to Clipboard</guimenuitem>
</menuchoice></term>
<listitem><para><action>
This pastes a highlighted line into the &kde; clipboard (Klipper).
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Open Individual Window</guimenuitem>
</menuchoice></term>
<listitem><para><action> Displays the selected download in its own window.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Move To Beginning</guimenuitem>
</menuchoice></term>
<listitem><para><action>Moves a highlighted entry to the top of the download
list.</action>
<note><para>The topmost &URL; in &kget; is downloaded first.</para>
</note>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Move To End</guimenuitem>
</menuchoice></term>
<listitem><para><action>Moves a highlighted entry to the bottom of the download
list.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Resume</guimenuitem>
</menuchoice></term>
<listitem><para><action>Resumes a download that has been paused.
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_resume.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Pause</guimenuitem>
</menuchoice></term>
<listitem><para><action>Pauses a download that is running.
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_pause.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Delete</guimenuitem>
</menuchoice></term>
<listitem><para><action>Deletes a highlighted item from the &kget; main window.
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_delete.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Restart</guimenuitem>
</menuchoice></term>
<listitem><para><action>Combines the functions of Resume and Pause in one
button. The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_restart.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Queue</guimenuitem>
</menuchoice></term>
<listitem><para><action>Causes the highlighted entries in &kget; to begin 
downloading. The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_queue.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Timer</guimenuitem>
</menuchoice></term>
<listitem><para><action>Delays the download of the highlighted items by one
minute. This is useful if you need to pause the download to check email or go
to a website. 
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_timer.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Transfer</guimenu>
<guimenuitem>Delay</guimenuitem>
</menuchoice></term>
<listitem><para><action>Delays the download of the highlighted items
indefinitely.</action>
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_delay.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
<note><para>
<inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_queue.png" format="PNG"/>
	  </imageobject></inlinemediaobject>,
<inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_timer.png" format="PNG"/>
	  </imageobject></inlinemediaobject> and
<inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_delay.png" format="PNG"/>
	  </imageobject></inlinemediaobject> are radio buttons. Only one of
	  the these three can be selected.</para>
</note>
</para></listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title>The Options Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Options</guimenu>
<guimenuitem>Expert Mode</guimenuitem>
</menuchoice></term>
<listitem><para><action>Turns off prompting. 
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_expert.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Options</guimenu>
<guimenuitem>Use Last Folder Mode</guimenuitem>
</menuchoice></term>
<listitem><para><action>&kget; will ignore the current folder settings and
place all new transfers in the folder where the last transfer was placed. 
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_uselastdir.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu>Options</guimenu>
<guimenuitem>Offline Mode</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles &kget; from being online (ready to download),
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_offline_mode_on.png" format="PNG"/>
	  </imageobject></inlinemediaobject>, to offline, 
<inlinemediaobject><imageobject>
 <imagedata fileref="cr22-action-tool_offline_mode_off.png" format="PNG"/>
	  </imageobject></inlinemediaobject>. The offline mode is used when
	  you want to copy &URL;'s into &kget; without them being downloaded 
immediately.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Options</guimenu>
<guimenuitem>Auto-Disconnect Mode</guimenuitem>
</menuchoice></term>
<listitem><para><action>Causes &kget; to disconnect the modem.</action> Usually this
would be &kppp;.  The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_disconnect.png" format="PNG"/>
	  </imageobject></inlinemediaobject>. Expert Mode
<inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_expert.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
must be on to use this feature.
<note><para>
For SuSE users the command  <userinput><command>cinternet <option>-i</option> 
<parameter>ppp0</parameter> <option>-0</option></command></userinput> must be
substituted for <userinput><command>kppp <option>-k </option></command></userinput>in the <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure KGet...</guimenuitem></menuchoice>
<guilabel> Automations</guilabel> menu. For Fedora Core users the command
should be <userinput><command>/usr/sbin/usernetctl 
<parameter>ppp0</parameter> <option>down</option></command></userinput>
</para>
</note>
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Options</guimenu>
<guimenuitem>Use Auto Shutdown Mode</guimenuitem>
</menuchoice></term>
<listitem><para><action>Closes &kget; after all the downloads are
completed. The Expert Mode must be turned on. 
The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_shutdown.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Help</guimenu> Menu</title>


&help.menu.documentation;

</sect2>

</sect1>
</chapter>

<chapter id="credits">

<title>Credits and License</title>

<para>
&kget;
</para>
<para>
Program copyright 1998 Matej Moss 
</para>
<para>
Contributors:
<itemizedlist>
<listitem><para>Patrick Charbonnier<email>pch@freeshell.org</email></para>
</listitem>
<listitem><para>Carsten Pfeiffer<email>pfeiffer@kde.org</email></para>
</listitem>
</itemizedlist>
</para>

<para>
Documentation Copyright &copy; 2003 Jonathan Drews <email>j.e.drews@att.net</email>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;               <!-- FDL: do not remove -->


&underGPL;        	 <!-- GPL License -->

</chapter>

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

<sect1 id="getting-kapp">
<title>How to obtain &kget;</title>

&install.intro.documentation;

</sect1>



<sect1 id="compilation">
<title>Compilation and Installation</title>


&install.compile.documentation;

</sect1>

<sect1 id="configuration">
<title>Special Configurations</title>
<sect2>
<title>Configuration of Auto-Disconnect</title>

<para>
This feature is used for automatically disconnecting your modem once a
download has been completed. To configure &kget; for auto-disconnect do:
</para>

<itemizedlist>
<listitem><para>
Go to <menuchoice><guimenu>Options</guimenu><guimenuitem>Auto-Disconnect Mode
</guimenuitem></menuchoice>
<action> to disconnect the modem.</action> Usually this
would be &kppp;.  The shortcut button is <inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_disconnect.png" format="PNG"/>
	  </imageobject></inlinemediaobject>. Expert Mode
<inlinemediaobject><imageobject>
	    <imagedata fileref="cr22-action-tool_expert.png" format="PNG"/>
	  </imageobject></inlinemediaobject>
must be on to use this feature.</para>
</listitem>

<listitem><para>
For SuSE users the command  <userinput><command>cinternet <option>-i</option> 
<parameter>ppp0</parameter> <option>-0</option></command></userinput> must be
substituted for <userinput><command>kppp <option>-k </option></command></userinput>in the <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure &kget;...</guimenuitem></menuchoice>
<guilabel> Automations</guilabel> menu.</para>
</listitem>

<listitem><para>
 For Fedora Core users the command should be 
<userinput><command>/usr/sbin/usernetctl 
<parameter>ppp0</parameter> <option>down</option></command></userinput></para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title> Downloading Into Designated Folders</title>

<para>
To download jpeg files into a designated folder do:
</para>
<itemizedlist>
<listitem><para>
 Go to <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure &kget;...</guimenuitem></menuchoice>
<guilabel> Folders</guilabel> menu.</para>
</listitem>

<listitem><para>
Enter the files you wish to download using the extensions
<filename>.jpg</filename> and <filename>.jpeg</filename> as shown below:
</para>
<screenshot>
<screeninfo>Screenshot of Kget</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kget5.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Downloading into designated files</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</listitem>

<listitem>
<para>Click on <interface>Apply</interface> and
<interface>OK</interface>. When you  download any
<filename>.jpeg</filename> files they will be stored in
<filename>/home/kdecvs/pics/JPEG</filename>. </para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab 
-->
