<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&konqueror;">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
  
  
]>

<book lang="&language;"> 

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

<authorgroup>

<author>
<firstname>Erwan</firstname>
<surname>Loisant</surname>
<affiliation>
<address><email>erwan@loisant.org</email></address>
</affiliation>
</author>

<author>
<firstname>Pamela</firstname>
<surname>Roberts</surname>
<affiliation>
<address><email>pam.roberts@btinternet.com</email></address>
</affiliation>
</author>

<othercredit role="developer">
<othername>The KDE Team</othername>
<contrib>Developers</contrib>
</othercredit>

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

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

<copyright>
<year>2000</year> <year>2001</year>
<holder>Erwan Loisant, Pamela Roberts</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2001-02-03</date>
<releaseinfo>2.01.00</releaseinfo>

<abstract><para>&konqueror; is &kde;'s advanced File Manager, Web Browser and
/Document Viewer.</para>
<para>This document describes &konqueror; version 2.1</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Konqueror</keyword>
<keyword>Kdebase</keyword>
<keyword>File Manager</keyword>
<keyword>Browser</keyword>
<keyword>Viewer</keyword>
</keywordset>

</bookinfo>

<chapter id="basics">
<title>&konqueror; Basics</title>

<important><para> A three button mouse can be useful when you are running
&konqueror; or any other &kde; application. If your mouse only has two buttons
then you should be able to set your system up so that you can simulate a &MMB;
by pressing both buttons at the same time.  </para></important>

<sect1 id="konq-start">
<title>Starting &konqueror;</title>

<para>Being a combined File Manager and Browser, &konqueror; will automatically
switch between the two modes as needed when it is running, but it is convenient
to be able to choose which mode is to be used when you start it up.</para>

<itemizedlist>
<listitem><para>If you have a <guiicon>house</guiicon> shaped icon on the panel
or desktop, then &LMB; click on it to open &konqueror; as a file
manager.</para></listitem>

<listitem><para>Or &LMB; click on <guiicon>world</guiicon> shaped icon on the
panel or desktop to open &konqueror; in browser mode.</para></listitem>

<listitem><para>From the <guimenu>K</guimenu> menu, select
<menuchoice><guisubmenu>System</guisubmenu><guimenuitem>
Konqueror</guimenuitem></menuchoice> to start &konqueror; as a file manager or
select <menuchoice><guisubmenu>Internet</guisubmenu><guimenuitem>
Konqueror Web Browser</guimenuitem></menuchoice> to start it as a browser.
</para></listitem>

<listitem><para><keycombo
action="simul"><keycap>Alt</keycap><keycap>F2</keycap></keycombo> will open a
<guilabel>Run Command</guilabel> dialog box, type
<userinput><command>konqueror</command></userinput> (lower case) and press
<keycap>Enter</keycap> or the <guibutton>Run</guibutton> button to start in file
manager mode, or just enter a <acronym>URL</acronym> to start &konqueror; as a
browser.</para></listitem>

</itemizedlist>

<para>&konqueror; is also started automatically when you 
<mousebutton>left</mousebutton> click on a desktop icon that represents a 
directory, such as the <guiicon>Trash</guiicon> icon, or a 
<acronym>URL</acronym>.</para>

<caution><para>If you are used to having to double-click to perform an action,
then take care, because in common with the rest of &kde;, &konqueror; defaults
to single-clicking.</para></caution>

</sect1>

<sect1 id="parts">
<title>The Parts of &konqueror;</title>

<para>A brief look at the main parts of &konqueror;'s window:</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="parts.png"/></imageobject>
<textobject>
<phrase>Here's a screenshot of &konqueror;</phrase>
</textobject>
</mediaobject>

<para>The <interface>Titlebar</interface> is the strip across the top of
&konqueror;'s window, and operates in the same way as for other &kde;
applications. <mousebutton>Right</mousebutton> click on the central portion to
bring up the neat Titlebar menu.</para>

<para>The <interface>Menubar</interface> is the strip containing the names of
the drop-down menus, <mousebutton>left</mousebutton> click on a name to 
alternately show and hide that menu, or you can use <keycombo 
action="simul"><keycap>Alt</keycap><keycap>the underlined 
letter</keycap></keycombo> in the name as a hot key, for example <keycombo 
action="simul"><keycap>Alt</keycap><keycap>E</keycap></keycombo> to show the 
<guimenu>Edit</guimenu> menu. The various menus are described in the <link 
linkend="menubar">Menubar</link> section of this document.</para>

<para><interface>The Toolbar</interface> contains icons for commonly used
operations. Hover the mouse pointer over an icon to see a brief description of
what that icon does, <mousebutton>left</mousebutton> click to activate the icon. 
Click the <mousebutton>right</mousebutton> mouse button on a clear area of the 
Toolbar to change the appearance and position of the Toolbar.</para>

<para><interface>The Locationbar</interface> shows the path to the directory,
<acronym>URL</acronym> or file being viewed. You can type a path or
<acronym>URL</acronym> here and press <keycap>Enter</keycap> to go to it. The
black icon at the left hand end of the Locationbar clears the text entry
box.</para>

<para><interface>The Bookmark Toolbar</interface> is the area under the
<interface> Locationbar</interface> in the previous screenshot. You can add
frequently used bookmarks here, see the <link linkend="orgbmark">Organising Your
Bookmarks</link> section of this document.</para>

<para><interface>The Window</interface> is the main area of &konqueror; and can
show you the contents of a directory, a web page, or a document. Using the <link
linkend="menu-window"><guimenu>Window</guimenu></link> menu you can split
&konqueror;'s main window into one or more separate views, useful for drag and
drop operations.</para>

<para><interface>The Status Bar</interface> runs across the bottom of the window
and often shows general information about whatever the mouse pointer is hovering
over. If you have split the main window into a number of views you will get an
Status Bar for each view, and it will include a small light at the left hand end
to show which is the <quote>active</quote>
view. <mousebutton>Right</mousebutton> clicking on the Status Bar brings up the
Status Bar <mousebutton>Right </mousebutton> Mouse Button Menu.</para>

<note><para>Don't worry if your &konqueror; doesn't look exactly like this
screenshot, it is highly configurable and there is no <quote>standard</quote>
way of setting it up. In particular:</para>

<itemizedlist>
<listitem><para>You can use the <link
linkend="menu-settings"><guimenu>Settings</guimenu></link> menu 
to choose whether to show or hide the Menubar, Toolbar, Locationbar and
Bookmark Toolbar.</para></listitem>
<listitem><para>You can also <quote>flatten</quote> the Toolbar, Locationbar and
Bookmark Toolbar by &LMB; clicking on the vertical lines at the left hand end of
the bars or move them around by holding the &LMB; mouse button down while you
drag these bars around. </para></listitem>
</itemizedlist>

<para>For more details of how to change &konqueror;'s appearance, see the <link
linkend="config">Configuring &konqueror;</link> section</para></note>

</sect1>

<sect1 id="bubble">
<title>Bubble Help and What's This ?</title>

<para>You can find out a lot about how &konqueror; works without needing to read
this entire document if you take advantage of the Bubble Help and
<guimenuitem>What's This?</guimenuitem> features.</para>

<para>Bubble Help means that if you hover the mouse pointer over a Toolbar
button it should bring up a terse description of what that button does.</para>

<para><guimenuitem>What's This?</guimenuitem> is invoked by the Menubar
<menuchoice><guimenu>Help</guimenu><guimenuitem>What's This
?</guimenuitem></menuchoice> item, by the
<keycombo action="simul"><keycap>Shift</keycap><keycap>F1</keycap></keycombo> hotkey, or by
just &LMB; clicking on the question mark near the top right hand corner of a
window. It changes the cursor to show a question mark alongside the
arrow.</para>

<para>When this question mark is visible, a &LMB; click won't actually do
anything until you have clicked on a control (or the text alongside it) which
supports <guimenuitem>What's This ?</guimenuitem>, in which case it will display
a reasonably comprehensive description of what the control is supposed to do.
Most of the dialog boxes that &konqueror; brings up support the
<guimenuitem>What's This?</guimenuitem> feature.</para>

</sect1>

<sect1 id="lmb-mmb">
<title><mousebutton>Left</mousebutton> and <mousebutton>Middle</mousebutton>
Mouse Button Actions</title>

<para>If you click the &LMB; on an item in &konqueror;'s window it will be
<quote>activated</quote>. Thus</para>

<itemizedlist>

<listitem><para><mousebutton>Left</mousebutton> click on an icon in the Toolbar
to do whatever that icon is supposed to do. </para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on an item in the Menubar
to make that menu drop down.</para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on a menu item to do that
thing.</para></listitem> 
<listitem><para><mousebutton>Left</mousebutton> click on a link in a web page to
make &konqueror; follow that link.</para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on a directory icon or name
and &konqueror; will descend into (show the contents of) that
directory.</para></listitem>
<listitem><para><mousebutton>Left</mousebutton> click on a file name or icon and
&konqueror; will do whatever it thinks appropriate, based on the file type. In
general this means opening <acronym>HTML</acronym> pages, or previewing text, image or
<application>KOffice</application> files, embedding them within &konqueror;'s
window. (<quote>Preview</quote> means that you can see the file but not change
it).</para> 

<para>&konqueror; decides what the file type is by matching the filename
extension against against a list of known types. If that fails it tries to guess
the type from the file contents. You can change the list of known file types and
associated actions and add new types, see the section <link
linkend="file-associations">File Associations</link>.</para></listitem>

</itemizedlist>

<para>Clicking the &MMB; on a file or directory name or icon does essentially
the same as <mousebutton>left</mousebutton> clicking except that it does it in a
new &konqueror; window.</para>

</sect1>

<sect1 id="rmb-menus">
<title><mousebutton>Right</mousebutton> Mouse Button Menus</title>

<para>Clicking the &RMB; on almost any part of &konqueror;'s window
will bring up an appropriate menu:</para>

<variablelist>

<varlistentry>
<term>On the Titlebar</term>
<listitem><para><mousebutton>Right</mousebutton> clicking on any free area of
the Titlebar brings up the Titlebar Menu, allowing you to control the position
of &konqueror;'s window as well as the decoration applied to all &kde; program
windows. </para></listitem>
</varlistentry>

<varlistentry>
<term>On the Toolbar</term>
<listitem><para><mousebutton>Right</mousebutton> click on any free area of the
Toolbar to bring up the Toolbar Menu.  You can use it to control whether the
Toolbar is at the top, bottom, left or right of &konqueror;'s window.
You can also use the Toolbar Menu to set the size of the buttons on the Toolbar,
and whether they are shown as icons, text or both.</para></listitem> 
</varlistentry>

<varlistentry>
<term>On the Locationbar</term>
<listitem><para><mousebutton>Right</mousebutton> click in the <acronym>URL</acronym>
entry box area to perform Cut, Copy, Paste or Clear operations in this area, or
to change the <link linkend="path-complete">auto completion</link>
features.</para></listitem> 
</varlistentry>

<varlistentry>
<term>On the Bookmark Toolbar</term>
<listitem><para> If you have the Bookmark Toolbar showing, then
<mousebutton>right</mousebutton> click on any free part of it to bring up the
Bookmark Toolbar Menu which lets you change its position and whether items are
shown as text, icons, or both. </para></listitem> 
</varlistentry>

<varlistentry>
<term>Within a View</term>
<listitem><para>If you <mousebutton>right</mousebutton> click on any free area
of a view then you will get this menu, which contains the <guiicon>Up</guiicon>,
<guiicon>Back</guiicon>, <guiicon>Forward</guiicon> and
<guiicon>Reload</guiicon> navigation commands as well as the <guimenuitem>Create
new</guimenuitem> option from the <guimenu>Edit</guimenu> menu. </para></listitem>
</varlistentry>

<varlistentry>
<term>On a File or Directory</term>
<listitem><para>This is a most useful feature. <mousebutton>Right</mousebutton>
clicking on the name or icon of any file or directory not only
<quote>selects</quote> that item but also brings up a menu allowing you to
<guiicon>Cut</guiicon>, <guiicon>Copy</guiicon> or Remove the item in various
ways, add it to your <guimenu>Bookmarks</guimenu>, open it with the program of
your choice or preview it, rename it, or edit the file type or 
properties.</para></listitem> </varlistentry>

<varlistentry>
<term>On the Status Bar</term>
<listitem><para><mousebutton>Right</mousebutton> click on the Status Bar at the
bottom of a window or view to add or remove a view within &konqueror;'s
window.</para></listitem> 
</varlistentry>
</variablelist>

</sect1>

</chapter>

<chapter id="filemanager">
<title>&konqueror; the File Manager</title>

<note><para>In &Linux; all directories are arranged in a simple inverted tree
structure descending and branching down from from a single top level
<quote>root</quote> directory. This means that you can get from any directory to
any other by going <quote>up</quote> until you reach a common point then
<quote>down</quote> through the appropriate sub-directories until you reach your
target. </para>  

<para>The position of any file or directory in the tree can be described by its
<quote>path</quote>, which is a simple list of the directories you would have to
descend through to get to the target directory. For example <filename
class="directory">/home/pam</filename> is the subdirectory <filename
class="directory">pam</filename> of the subdirectory <filename
class="directory">home</filename> of the top level directory, which is
represented by the leading <quote>/</quote>.</para>

<para>Note that every accessible drive on your system, including your floppy and
cdrom, will appear in the tree descending from /. Their exact paths will depend
on how your system was set up, but will usually be something like <filename
class="directory">/mnt/floppy</filename> and <filename
class="directory">/mnt/cdrom</filename>. See also the section on <link
linkend="floppy-cd">Floppy and &CD-ROM; Drives.</link></para></note>

<sect1 id="navigation">
<title>Navigation</title>

<para>&konqueror; is basically a file manager, and as such will display the
names of the files and sub-directories held in a directory. The
<quote>path</quote> of the directory you are looking at is shown in the Titlebar
and also in the Locationbar.</para>

<para>Sub-directories are usually displayed with an icon that looks a little
like a folder, although some special directories, such as
<filename>Trash</filename> and <filename>Desktop</filename>, may have different,
distinctive, icons. Files have their own icons, which may indicate what type of
file it is - or at least what &konqueror; thinks it is. </para>

<para>You can <quote>select</quote> a file or sub-directory by using the
keyboard arrow keys to move through the displayed items. The appearance of the
selected item will change and some information about it will be displayed in the
Status Bar.</para>

<para>To move between directories you can simply step up and down the
tree:</para>

<itemizedlist>
<listitem><para>To descend into a sub-directory &LMB; click on its name or icon,
or if you have <quote>selected</quote> it then just press
<keycap>Enter</keycap>.</para></listitem> <listitem><para>To go up the directory
tree, click on the <guiicon>Up</guiicon> button in the Toolbar, or use <keycombo
action="simul"><keycap>Alt</keycap><keysym>Up Arrow</keysym></keycombo>, or use
the Menubar
<menuchoice><guimenu>Go</guimenu><guimenuitem>Up</guimenuitem></menuchoice>
option.</para></listitem>
</itemizedlist>

<para>You can also go directly to any directory by typing its path into the
Locationbar window or into the dialog box invoked by the Menubar
<menuchoice><guimenu>Location</guimenu><guimenuitem>Open
Location</guimenuitem></menuchoice> item or by <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>. Don't forget
that in &Linux; file and directory names are case sensitive, although
<acronym>WWW</acronym> <acronym>URL</acronym>s are not.</para>

<para>Once you have moved to a new directory then you can go back to your
previous choice by using the Toolbar <guiicon>Back</guiicon> button, the Menubar
<menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice>
item, or <keycombo action="simul"><keycap>Alt</keycap><keysym>Left
Arrow</keysym></keycombo>.</para>

<para>Once you have gone back you can go forward. Use the Toolbar
<guiicon>Forward</guiicon> button, the Menubar <menuchoice><guimenu>Go</guimenu>
<guimenuitem>Forward</guimenuitem></menuchoice> item or <keycombo
action="simul"><keycap>Alt</keycap><keysym>Right
Arrow</keysym></keycombo>.</para>

<tip><para>Holding the &LMB; pressed while the mouse pointer is
over the Toolbar <guiicon>Up</guiicon>, <guiicon>Back</guiicon> or
<guiicon>Forward</guiicon> buttons brings up a menu of recently visited
locations.</para></tip>

<sect2 id="path-complete">
<title>Auto Path Completion</title> 

<para>You can get &konqueror; to help you when you are typing a path into the
Locationbar by enabling one of the <guimenuitem>Completion</guimenuitem>
features. To do this <mousebutton>right</mousebutton> click on a clear part of
the Locationbar text entry box and select
<guisubmenu>Completion</guisubmenu>. This will let you choose between the
following possibilities:</para>

<variablelist>

<varlistentry>
<term>None</term>
<listitem><para>What you get is what you type.</para></listitem>
</varlistentry>

<varlistentry>
<term>Manual</term>
<listitem><para>If you type
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>E</keycap></keycombo> while you are
entering a path into the Locationbar window &konqueror; will complete it as far
as it can without ambiguity. For example if the directory contains the two files
<filename>testfile19.txt</filename> and <filename>testfile20.txt</filename>
entering <userinput>t</userinput> followed by
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>E</keycap></keycombo> will extend the
filename shown in the Locationbar window to <filename>testfile</filename>, you
can then type <userinput>2</userinput>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>E</keycap></keycombo> and the complete
name <filename>testfile20.txt</filename> will appear.</para></listitem> 
</varlistentry>

<varlistentry>
<term>Popup</term>
<listitem><para>A popup window will appear as you type, showing the possible
matches to what you have typed so far. When the path that you want appears in
the window use the <keysym>Down Arrow</keysym> and <keysym>Up Arrow</keysym>
keys to select it then press <keycap>Enter</keycap>.</para></listitem>
</varlistentry>

<varlistentry>
<term>Automatic</term>
<listitem><para>As you type into the Locationbar window &konqueror; will
automatically extend what you type by highlighting one possible
completion or partial completion. Continue typing if that's not what you 
wanted or press <keycombo 
action="simul"><keycap>Ctrl</keycap><keycap>E</keycap></keycombo> to accept 
the highlighted portion. When the file or directory name you want is fully shown 
then press <keycap>Enter</keycap>.</para></listitem> </varlistentry>

<varlistentry>
<term>Semi-Automatic</term>
<listitem><para>This is like the Automatic mode except that it 
restricts itself to more sensible suggestions.</para></listitem> </varlistentry>

</variablelist>
</sect2>

<sect2 id="sidebar">
<title>The Sidebar</title>
<mediaobject>
<imageobject><imagedata format="PNG" fileref="dirtree.png"/></imageobject>
<textobject>
<phrase>With the Sidebar</phrase>  
</textobject>
</mediaobject>

<para>If you want a better view of the directory structure, or easy access 
to your Bookmarks, History and Network, then the  
<menuchoice><guimenu>Window</guimenu><guimenuitem>Show 
Sidebar</guimenuitem></menuchoice> option splits the window into two views as 
shown above.</para>

<para>The left, Sidebar, view contains five trees, labelled
<guilabel> Bookmarks</guilabel>, <guilabel>History</guilabel>, <guilabel>Home
Directory </guilabel>, <guilabel>Network</guilabel> and <guilabel>Root
Directory</guilabel>.  The right hand view shows the selected directory or web
page. For this screenshot the Menubar
<menuchoice><guimenu>View</guimenu><guimenuitem>View
Mode...</guimenuitem></menuchoice> and <menuchoice><guimenu>View</guimenu>
<guimenuitem>Show details...</guimenuitem></menuchoice> options have been used
to get a text listing of the directory contents in the right hand view rather
than one using icons.
</para>

<para>When &konqueror; is showing more than one view, there will be a small box
at the bottom right of each view. <mousebutton>Left</mousebutton> clicking on
the box toggles an almost invisibly small icon on and off. Views showing this
icon are linked so that a change of directory in one view makes the other view
change to the new directory. In this way selecting any item in the Sidebar view 
will automatically show its contents in the other view.</para>

<para>To navigate through the items in the Sidebar using your mouse;</para>

<itemizedlist>
<listitem><para><mousebutton>Left</mousebutton> click on a
<guilabel>+</guilabel> symbol to show any subdirectories.</para></listitem>
<listitem><para>To collapse a sub-tree &LMB; click on the <guilabel>-</guilabel>
symbol.</para></listitem>
<listitem><para>Once you can see the wanted item, &LMB; click on its name or
icon to open it in the other window. </para></listitem>
</itemizedlist>

<para>Or, once you have selected an item in the Sidebar, you can navigate from 
the keyboard;</para>

<itemizedlist>
<listitem><para>Use the <keysym>Up</keysym> and <keysym>Down Arrow</keysym> keys
to move up and down. </para></listitem>
<listitem><para>The <keysym>Right Arrow</keysym> key will descend into a
directory.</para></listitem>
<listitem><para>The <keysym>Left Arrow</keysym> key to collapse a
sub-directory.</para></listitem>
<listitem><para>Once you have reached the wanted item then
<keycap>Enter</keycap> will open it in the other view.</para></listitem>
</itemizedlist>

<para>The <guilabel>Bookmarks</guilabel> tree in the Sidebar contains your 
bookmarks, just as displayed by the Bookmarks menu.</para>

<para>The <guilabel>History</guilabel> tree contains <acronym>URL</acronym>s for
the most recently visited web sites.</para>

<para>The <guilabel>Home Directory</guilabel> shown in the Sidebar is actually 
your personal home directory, which will have a path such as <filename 
class="directory">/home/pam2</filename> if your username is 
<quote>pam2</quote>.</para>

<para>The <guilabel>Root Directory</guilabel> tree has the path <filename
class="directory">/</filename>, and is the base directory of your system's local
files. If you expand the <quote>Root</quote> directory you will find another
directory called <filename class="directory">root</filename>. This belongs to
the system administrator or Super User and is her home directory. You will also
find a directory called <filename class="directory">home</filename>, in which
you should be able to find your own <quote>Home</quote> directory again.</para>

<para>The <guilabel>Network</guilabel> tree holds details of files or web pages
you can reach over your network (if you are connected to one).</para>
</sect2>

<sect2 id="file-find">
<title>Finding Files and Directories</title>

<para>If you don't know or can't remember where a file or directory is within
your system, then use the Toolbar <guiicon>Find file</guiicon> button or the
Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Find 
file</guimenuitem></menuchoice> option.  This will embed the file finder 
application &kfind; into &konqueror;'s window. See the <quote>Finding Your Lost 
Files</quote> section of the &kde; User's manual for more details about &kfind;. 
</para>

<note><para>If the name of a file or directory begins with a period (dot), then
it is a <quote>hidden</quote> file or directory, and will not normally be shown
by &konqueror;.</para>

<para>To see the hidden files or sub-directories use the Menubar
<menuchoice><guimenu>View</guimenu><guimenuitem>Show Hidden
Files</guimenuitem></menuchoice> option.</para></note>

</sect2>

<sect2 id="floppy-cd">
<title>Floppy and &CD-ROM; Drives</title>

<para>Any floppy disk or &CD; drive that you have on your system will usually
appear in the <filename class="directory">/mnt</filename> directory, having a
path something like <filename class="directory">/mnt/floppy</filename> or
<filename class="directory">/mnt/cdrom</filename>, the details will depend on
how your system was set up.</para>

<para>&Linux; requires that you <command>mount</command> a floppy disk or
&CD-ROM; when you have inserted it into the drive, so that &Linux; can see
what's on it. You also need to unmount it before removing the disk so &Linux;
can register that it is no longer available. </para>

<para>How you do this will depend on how your system:</para>

<itemizedlist>
<listitem><para>You may have an <application>Automount</application> facility,
in which case you don't have to bother about explicitly mounting and unmounting,
although you may find that the &CD-ROM; occasionally starts up by itself for no
apparent reason.</para></listitem>

<listitem><para>You may have <guiicon>Floppy</guiicon> and &CD-ROM; icons on
your desktop, in which case &LMB; click on the icon to mount a disk. Doing this
should also bring up a &konqueror; window showing the contents of the floppy or
&CD-ROM;. To unmount <mousebutton>right</mousebutton> click on the icon and
choose the <guimenuitem>Unmount</guimenuitem> item.  Visit the section <link
linkend="making">Create New...</link> to see how to create such an
icon.</para></listitem>

<listitem><para>Or you can do it the traditional way by typing into a text
console window:</para>

<screen>
<userinput><command>mount</command> <option><replaceable>/mnt/floppy</replaceable></option></userinput>
</screen>

<para>to mount, for example, the floppy drive, and</para>

<screen>
<userinput><command>umount</command> <option><replaceable>/mnt/floppy</replaceable></option></userinput></screen>

<para>to unmount it. Type <command>umount</command> not <command>unmount</command>.
</para>

<note><para>Rather than having to open a text console to type the <command>mount
</command> or <command>umount</command> commands, you may prefer to use
&konqueror;'s <menuchoice><guimenu> Tools</guimenu><guimenuitem>Execute Shell
Command</guimenuitem></menuchoice>
(<keycombo action="simul"><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>) feature.
</para></note>

</listitem>

</itemizedlist>
</sect2>

</sect1>

<sect1 id="deleting">
<title>Deleting Files and Directories</title>

<para>&konqueror; gives you three ways to dispose of an unwanted file or
directory:</para>

<itemizedlist>
<listitem><para>You can move it to the <filename>Trash</filename> directory,
which is the safest method as you can get it back when you realise that you have
made a mistake.</para></listitem>
<listitem><para>You can just plain Delete it, which removes the entry from
the directory and adds the disk area occupied by the file(s) to the system's
list of free disk areas.</para></listitem>
<listitem><para>Or you can Shred it, which is like Delete, but also overwrites
the disk area occupied by the file(s) with random data. Useful for disposing of
incriminating departmental memos or similar files when you don't want any trace
of them to remain on your system.</para></listitem>
</itemizedlist>

<note><para>Theoretically, even <quote>shredded</quote> files can be recovered
by someone with enough skill and determination.</para></note> 

<para>The simplest way of removing a file or directory is to position the mouse
pointer over its name or icon and press the &RMB; mouse button, which will
bring up a menu containing the options <guimenuitem>Move to Trash</guimenuitem>,
<guimenuitem>Delete</guimenuitem> and <guimenuitem>Shred</guimenuitem>.</para>

<para>Or, if you have <quote>selected</quote> the item, the Menubar
<guimenu>Edit</guimenu> menu will give you the choice of
<quote><guimenuitem>Move to Trash</guimenuitem></quote>,
<quote><guimenuitem>Delete</guimenuitem></quote> and
<quote><guimenuitem>Shred</guimenuitem></quote> options.</para>

<para><keycap>Del</keycap> will move a selected item or items to Trash.</para>

<para><keycombo
action="simul"><keycap>Shift</keycap><keycap>Del</keycap></keycombo> will
really, truly and irrevocably delete the selected item or items.</para>

<para><keycombo action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap>
<keycap>Del</keycap></keycombo> will shred the selected item or items.</para>

<note><para>You won't be able to remove a file or directory if you don't have
the necessary permissions, see the section on <link linkend="super-user">Super
User Mode</link> for further details.</para></note>

</sect1>

<sect1 id="moving">
<title>Moving and Copying</title>

<para>To copy a file or sub-directory between directories you can:</para>

<itemizedlist>
<listitem><para>Position the mouse pointer over its name or icon and hold down
the &RMB;, which will bring up a menu containing the
<guimenuitem>Copy</guimenuitem> option. Choose that.</para>

<para>Or if the item is <quote>selected</quote> you can use the
<guiicon>Copy</guiicon> button on the Toolbar or the Menubar
<menuchoice><guimenu>Edit</guimenu> <guimenuitem>Copy</guimenuitem></menuchoice>
item, or the <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>
hotkey.</para></listitem>

<listitem><para>Navigate to the directory you want to copy the item into then
Paste the item into the new directory by using the Toolbar
<guiicon>Paste</guiicon> button or the Menubar
<menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem></menuchoice> option or the <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo> hotkey, or by
moving the mouse pointer to a clear area of the window and holding the &RMB;
down to bring up a menu containing the <guimenuitem>Paste</guimenuitem> option.
</para></listitem>
</itemizedlist>

<para>Moving a file or sub-directory between directories can be done in the same
way as copying, except that you choose the <guimenuitem>Cut</guimenuitem> option
or <keycombo action="simul"><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>
instead of <guimenuitem>Copy</guimenuitem>. The item that you have
<guimenuitem>Cut</guimenuitem> will be removed from the original directory when
you do the <guimenuitem>Paste</guimenuitem> into the new directory.</para>

<note><para>You may not be able to copy or move a file or directory if you don't
have the necessary permissions. See the section on <link
linkend="super-user">Super User Mode</link> for further details.</para></note>

<sect2>
<title>Using Drag 'n Drop</title>

<para>&konqueror; also supports Drag and Drop copying and moving of files and
directories.</para>

<para>If you have set up &konqueror; to show the Sidebar as described in a 
previous section, then:</para>

<procedure>
<step><para>Make sure the two views are not linked (the small boxes at the
bottom right of each view should be empty, &LMB; click on one of them if they
not empty).</para></step>
<step><para>Navigate through the Sidebar View so that you can see the
directory you want to copy or move into.</para></step>
<step><para>Set the main view to show the item you wish to copy or move. Position the
mouse pointer over its name or icon then, holding the &LMB;
pressed, <quote>drag</quote> it over to the Sidebar view and position the
mouse pointer over the target directory. Release the button and you will be
presented with a menu choice of <guimenuitem>Copy</guimenuitem> or
<guimenuitem>Move</guimenuitem>.</para></step> 
</procedure>

<para>You can also set up &konqueror; to show more than one directory and drag &amp;
drop between them.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="dragdrop.png"/></imageobject>
<textobject>
<phrase>Split Views for Drag &amp; Drop</phrase>
</textobject>
</mediaobject>

<para>For this screenshot we have used the Menubar
<menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View
Left/Right</guimenuitem></menuchoice> option, also available with the hotkey
<keycombo
action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>L</keycap></keycombo>,
to split the main &konqueror; window into two views, each showing the contents
of a different directory.</para>

<para>With this arrangement it is easy to drag and drop between the directories,
but take care to <quote>drop</quote> the item into an empty area of the target
directory view - dropping it on top of another file name or icon can cause
problems.</para>

<para>When the window is split into two (or more) views it is usually best to
make sure that they are not linked - the little boxes at the bottom right of
each view should be empty.</para>

<para>The <quote>active</quote> view, that is the one whose path is shown in the
Locationbar and which responds to navigation and Menubar commands, is shown by
the little green light in the bottom left corner. To make a view active &LMB;
click on an empty area of the view or on its Status Bar.</para>

<para>To remove an active view from &konqueror;'s window use the <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>R</keycap></keycombo>
hotkey, or the Menubar <menuchoice><guimenu>Window</guimenu> <guimenuitem>Remove
Active View</guimenuitem></menuchoice> option, or &RMB; click on the Status Bar
and choose the <guimenuitem>Remove Active View</guimenuitem> option from the
resulting menu.</para>

<note><para>You can also drag and drop between different instances of
&konqueror;.</para></note>

</sect2>
</sect1>

<sect1 id="multiple">
<title>Selecting Multiple Files</title>

<para>You sometimes want to delete, copy or move a number of files that are
similar in some way. For example you may wish to move all of the .png graphics
files from one directory to another. &konqueror; makes this easy by letting you
select multiple files based on similarities in their file names.</para>

<para>Use the Menubar <menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Select...</guimenuitem></menuchoice> item or the hotkey <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>+</keycap></keycombo>. This brings
up a little dialog box in which you enter a filename containing the wildcard
characters <keycap>*</keycap>, which matches any number of characters, and
<keycap>?</keycap> which matches a single character. Press
<guibutton>OK</guibutton> and &konqueror; will highlight all files with matching
names. For example;</para>
      
<itemizedlist>
<listitem><para> <userinput><filename>flag*.png</filename></userinput> will
select all filenames starting with the letters <quote>flag</quote> and ending
with <quote><filename>.png</filename></quote>.</para></listitem>
<listitem><para><userinput><filename>memo?.txt</filename></userinput> will
select <filename>memo1.txt</filename> and <filename>memo9.txt</filename> but not
<filename>memo99.txt</filename>.</para></listitem>
</itemizedlist>

<para>When you have selected a range of files, you can narrow down the selection
by uing the Menubar <menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Unselect...</guimenuitem></menuchoice> option or <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>-</keycap></keycombo> to specify
which of the selected files should be removed from the selection.</para>

<para>Use <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>U</keycap></keycombo> or the Menubar
<menuchoice><guimenu>Edit</guimenu> <guimenuitem>Unselect
All</guimenuitem></menuchoice> option or just &LMB; click on a clear area of the
view to cancel the selection(s).</para>

<para>You can even invert the selection, that is deselect all selected files and
select those that were previously unselected. Use the Menubar
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Invert
Selection</guimenuitem></menuchoice> option or <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>*</keycap></keycombo> to do
this.</para>

<para>Once you have selected the right files then the normal delete, copy or
move commands will act on all of the selected files at once. </para>

<note><para>Depending on your keyboard type and locale, you will probably find
that the <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>+</keycap></keycombo>, <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>-</keycap></keycombo> and <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>*</keycap></keycombo> hotkeys only
work with the Numeric keypad <keycap>+</keycap>, <keycap>-</keycap> and
<keycap>*</keycap> keys.</para></note>

</sect1>

<sect1 id="making">
<title>Create New...</title>

<para>When &konqueror; is in File Manager mode picking <guisubmenu>Create New...
</guisubmenu> from the <guimenu>Edit</guimenu> menu or from the drop-down menu
you get by <mousebutton>right</mousebutton> clicking on a free area in a
directory view gives you a sub-menu letting you create any of the following in
the current directory:</para>

<variablelist>

<varlistentry>
<term><guimenuitem>Link To Application...</guimenuitem></term>
<listitem><para>This option is most useful if you want to create an icon that
will open a particular application. It opens a dialog box with four tabbed
pages. The first, <guilabel>General</guilabel>, is where you choose an Icon and
the text that will appear with it. The second page,
<guilabel>Permissions</guilabel>, lets you select who can use or modify the
icon. In the <guilabel>Execute</guilabel> page you must enter the command that
will run the application, for example <userinput>kedit</userinput> to start up
the &kedit; text editor. <userinput>kedit /home/pam/todo.txt</userinput> would
open the file <filename>/home/pam/todo.txt</filename> in &kedit;. You can
generally leave the <guilabel>Application</guilabel> page blank. </para>

<para>To make the application icon appear on your desktop, create the link in
your <filename class="directory">~/Desktop</filename> directory or get to the
<guisubmenu>Create New...  </guisubmenu> sub menu by
<mousebutton>right</mousebutton> clicking on a free area of the desktop.</para>

<para>If you have a lot of specialised application links and don't want to
clutter up the desktop, then why not create them in your Applications
directory. You can get there in &konqueror; by choosing
<menuchoice><guimenu>Go</guimenu>
<guimenuitem>Applications</guimenuitem></menuchoice>. Then create a single icon
on your desktop to open your Applications directory, which is usually at
<filename class="directory">~/.kde/share/applink</filename>.</para>

<para>To put an application link icon into the panel, first create it in the
Applications directory then drag the icon onto a clear area of the panel.</para>

</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Link To Location (URL)...</guimenuitem></term>
<listitem><para>This lets you create an icon to open &konqueror; at a particular
directory or web page. As with <guimenuitem>Link To Application...</guimenuitem>
you can make the application icon appear on your desktop by creating the link in
your <filename>~/Desktop</filename> directory or going to the <guisubmenu>Create
New...</guisubmenu> sub menu by right clicking on a free area of the
desktop. When you first create it the text shown with the icon will be the full
path or &URL;, you can change it by right clicking on the icon, selecting
<guimenuitem>Properties... </guimenuitem> and entering the preferred text in the
<guilabel>General </guilabel> tab page.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Floppy Device...</guimenuitem></term>
<listitem><para>Use this option to create an icon that will mount a floppy disk
and open an instance of &konqueror; showing the disk's contents. To unmount the
disk when you have finished with it <mousebutton>right</mousebutton> click on
the icon and select <guimenuitem> Unmount</guimenuitem>. In practice it doesn't
have to be a floppy disk but can be any hard disk or partition on your system
that is not normally mounted.  In most cases you will want to create the icon in
your Desktop.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>CD-ROM Device...</guimenuitem></term>
<listitem><para>This option is similar to <guimenuitem>Floppy
Device...</guimenuitem> but for a &CD-ROM; drive.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Directory...</guimenuitem></term>
<listitem><para>An easy way of creating a new (sub)directory.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Text File...</guimenuitem></term>
<listitem><para>Use this to create an ordinary, empty, text file. A little
dialog box will be opened for you to enter the name of your new
file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>HTML File...</guimenuitem></term>
<listitem><para>Creates a skeleton <acronym>HTML</acronym> source file. When you
type the new file's name into the little dialog box is is probably best to give
it a <literal role="extension">.html </literal> extension to avoid
confusion.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Presentation Document...</guimenuitem></term>
<listitem><para>Creates a skeleton <application>Koffice</application>
&kpresenter; document. Give its name a <literal role="extension">.kpr</literal>
extension.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Text Document...</guimenuitem></term>
<listitem><para>Creates a skeleton <application>KOffice</application> &kword;
document using the standard &kword; style template. Give its name a <literal
role="extension">.kwd</literal> extension.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Spread Sheet Document...</guimenuitem></term>
<listitem><para>Use this to create a new <application>KOffice</application>
&kspread; spreadsheet file, and name it with a <literal
role="extension">.ksp</literal> extension.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Illustration Document...</guimenuitem></term>
<listitem><para>Creates a new <application>KOffice</application> &killustrator;
document. Name it with the extension <literal
role="extension">.kil</literal>.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="newname">
<title>Changing Name and Permissions</title>

<para>The easiest way to change the name of a file or directory is to 
<mousebutton>right</mousebutton> click on it and select 
<guimenuitem>Rename</guimenuitem>.</para>

<para>Or, to change the name or permissions of a file or directory 
<mousebutton>right</mousebutton> click on its name or icon and select the 
<guimenuitem>Properties...</guimenuitem> item. Or, if you have 
<quote>selected</quote> the file or directory, then you can use the Menubar 
<menuchoice><guimenu>Edit</guimenu> 
<guimenuitem>Properties</guimenuitem></menuchoice> option.</para>

<para>This will bring up the Properties dialog box which has two tabs:</para>

<itemizedlist>
<listitem><para><guilabel>General</guilabel>, which gives you some
information about the item and lets you change its name and, for a directory,
the associated icon.</para></listitem>
<listitem><para><guilabel>Permissions</guilabel>, which shows you the item"s
ownership and access permissions and lets you change the
permissions.</para></listitem>
</itemizedlist>

<sect2 id="super-user">
<title>Super User Mode</title>

<para>If you are running as a normal user and try to access files outside of
your own home directory you will often be prevented from doing so and get an
error message such as <errorname>Access Denied</errorname>. </para>

<para>To access these files you need to be logged in as the system
administrator, often known as the Super User or <quote>root</quote>. </para>

<para>Rather than logging out then in again, you can launch &konqueror; from the
<guimenu>K</guimenu> Menu in Super User Mode by selecting
<menuchoice><guisubmenu>System</guisubmenu><guimenuitem>File Manager (Super User
Mode)</guimenuitem></menuchoice>. You will be asked for the <quote>root</quote>
login password but as long as you can provide that &konqueror; will be started
up with full access privileges to all files on your system.</para>

<warning><para>Take care.  As Super User (root), you have complete control of
your system, and a wrong command can easily do irrevocable damage.</para>
<para>Also, connecting to the internet as root is an extremely bad idea, as it
seriously increases your vulnerability to hacking.</para></warning>

</sect2>
</sect1>

<sect1 id="commandline">
<title>At the Command Line</title>

<para>Although &konqueror; is a very powerful and flexible
<acronym>GUI</acronym> file manager, there are occasions when the experienced
&Linux; user wants to get down to the basics and work at the text command line
level.</para>

<para>She could, of course, open an instance of &konsole;, perhaps with
&konqueror;'s Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Open
Terminal</guimenuitem></menuchoice> option or with <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>T</keycap></keycombo>.</para>

<para>But &konqueror; has yet another nice feature here, the Menubar
<menuchoice><guimenu>Window</guimenu><guimenuitem>Show Terminal
Emulator</guimenuitem></menuchoice> option opens up a terminal window as a new
view within &konqueror;, and as long as the link icon is visible at the bottom
right corner of each view, the terminal will follow any directory changes you
make in the normal file manager view.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="cmndline.png"/></imageobject>
<textobject>
<phrase>Including the terminal emulator</phrase>
</textobject>
</mediaobject>

</sect1>

</chapter>

<chapter id="browser">
<title>&konqueror; the Web Browser</title>

<note><para>When you start &konqueror; as a browser for the first 
time it should display an introduction to &konqueror;'s main features. If you 
forgot to add this introduction to your Bookmarks you can always view it by 
entering <userinput>about:konqueror</userinput> in the 
Locationbar.</para></note>

<sect1 id="conn-inet">
<title>Connecting to the Internet</title>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="konqorg.png"/></imageobject>
<textobject>
<phrase>Browsing www.konqueror.org</phrase>
</textobject>
</mediaobject>

<para>Once you are connected to the Internet you can use &konqueror; to browse
the Web just as easily as you can use it to handle your local files. Just type a
<acronym>URL</acronym> into the Locationbar window, press
<keycap>Enter</keycap>, and you are away!</para>

<itemizedlist>

<listitem><para>If you use a dial-up modem connection, then you will be using
&kppp; or a similar dialler program to make the connection.</para></listitem>

<listitem><para>If your machine is connected to a local area network
(<acronym>LAN</acronym>) that gives you a proxy connection to the Internet then
you will have to set &konqueror; up for the proxy connection as described in the
<link linkend="configure-proxy">Proxy Configuration</link>
section. </para></listitem>

<listitem><para>If you are lucky enough to have a high speed cable connection,
then the service provider will probably give you an external cable modem which
needs an ethernet connection to your machine. Unfortunately the details of how
to establish the connection depend on the service provider and to some extent on
which Linux distribution you are using.  Some <acronym>ISP</acronym>s connect
their customers to the Internet through a proxy server, in which case see the
<link linkend="configure-proxy">Proxy Configuration</link> section of this
document.  You may find it useful to search the archives of your distribution's
user group mailing list for help.</para></listitem>
</itemizedlist>

<note><para>An error message such as <errorname>Unknown Host</errorname> usually
means that &konqueror; cannot find a connection to the Internet or that you have
entered an incorrect <acronym>URL</acronym>.</para></note>

</sect1>

<sect1 id="surf">
<title>Surfing and Searching</title>

<para>Once you have a connection to the Internet, then you can surf with
&konqueror; just as you can with any other browser.</para>

<itemizedlist>
<listitem><para>Type a &URL; into the Locationbar window, press
<keycap>Enter</keycap>, and &konqueror; will download and display that
page. You can use the auto &URL; completion feature to help
you type, this is similar to the <link linkend="path-complete">auto Path
completion</link> feature but bases its choices on your browsing
history instead of your system file directories.</para></listitem>

<listitem><para><mousebutton>Left</mousebutton> click on a link in the page to go there.</para></listitem>

<listitem><para>To open a link in a new instance of &konqueror;, leaving the old
page still visible, then &RMB; click on the link and select the <guimenuitem>New
View</guimenuitem> option.</para>

<para>You can also select the multiple view mode with <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>L</keycap></keycombo>
or the Menubar <menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View
Left/Right</guimenuitem></menuchoice> option which will let you see different
pages at the same time. This can be useful if you are looking through a
complicated set of pages such as this document, but make sure the little link
box at the bottom right hand corner is empty when you are doing
this.</para></listitem>


<listitem><para>To go back to the previous page use the <keycombo
action="simul"><keycap>Ctrl</keycap><keysym>Left Arrow</keysym></keycombo>
hotkey, the <guiicon>Back</guiicon> button on the Toolbar, or the Menubar
<menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice>
option, just as you do when navigating through your own files.</para></listitem>
<listitem><para>Similarly, once you have gone back you can go forward by using
<keycombo action="simul"><keycap>Ctrl</keycap><keysym>Right
Arrow</keysym></keycombo>, the <guiicon>Forward</guiicon> button, or the Menubar
<menuchoice><guimenu>Go</guimenu>
<guimenuitem>Forward</guimenuitem></menuchoice> option.</para></listitem>
</itemizedlist>

<para>If you want to stop the download for any reason then use the
<keycap>Esc</keycap> key, the Toolbar <guiicon>Stop</guiicon> button or the
Menubar <menuchoice><guimenu>View</guimenu>
<guimenuitem>Stop</guimenuitem></menuchoice> item.</para>

<para>When you are viewing a web page you should see two new icons in the
Toolbar, looking like magnifying glasses with small <guiicon>+</guiicon> and
<guiicon>-</guiicon> symbols. Use these to adjust the size of the text in the
page if you find it difficult to read, although whether this works or not will
depend on how the <acronym>HTML</acronym> page has been constructed.</para>

<para>Some people seem to spend more time searching for a web page than actually
reading it. Do you know that you can just type the subject you are looking for
into the Locationbar window, and &konqueror; will automatically submit it to a
Web search engine? Try it by entering the name of your home town.</para>

<para>Or you can tell it to use a particular search engine. For example entering
<userinput>altavista:konqueror</userinput> or just
<userinput>av:konqueror</userinput> will use Altavista to do the search. For
more details about &konqueror;'s advanced search features see the <link
linkend="configure-enhanced-browsing">Enhanced Browsing</link> section.</para>


</sect1>

<sect1 id="save-print-web">
<title>Saving and Printing Web Items</title>

<para>When you are viewing a web page you can save it (or at least the basic
<acronym>HTML</acronym> or similar source text) to your local disk with the
Menubar <menuchoice><guimenu>Location</guimenu><guimenuitem>Save
As...</guimenuitem></menuchoice> item or <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>. If the page
you are viewing uses frames, then you will also be given the
<menuchoice><guimenu>Location</guimenu><guimenuitem>Save Frame
As...</guimenuitem></menuchoice> option.</para>

<para>If the page uses a background image, you can get and save that with the
Menubar <menuchoice><guimenu>Location</guimenu><guimenuitem>Save Background
Image As...</guimenuitem></menuchoice> option.</para>

<para>But if what you really want is that glorious picture of the latest
Ferrari, then &RMB; clicking on the image will give you a drop-down menu with a
<guimenuitem>Save Image As...</guimenuitem> option. If you choose
<guimenuitem>Copy Image Location</guimenuitem> instead then the
<acronym>URL</acronym> will be copied into the clipboard so you can then paste
it anywhere you wish. Be sure to respect the owners copyright, and ask for
permission before using any pictures saved this way for anything other than your
own viewing pleasure.</para>

<para><mousebutton>Right</mousebutton> click on a link (which may be an image)
and choose <guimenuitem>Copy Link Location</guimenuitem>. This copies the
<acronym>URL</acronym> to the clipboard so you can then paste it into, say, an
e-mail to a friend telling her about this wonderful new site.</para>

<para>Printing a copy of the page you are viewing is easily done with the
Menubar <menuchoice><guimenu>Location</guimenu>
<guimenuitem>Print...</guimenuitem></menuchoice> or <guimenuitem>Print
Frame</guimenuitem> option, with <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>P</keycap></keycombo> or with the
Toolbar <guiicon>Print</guiicon> button.</para>

</sect1>

<sect1 id="ftp">
<title>&FTP;</title>

<para>&FTP;, or File Transfer Protocol, is one of the the earliest, and still
perhaps the best, way of transferring files between computers over the
Internet.</para>

<para>With &FTP; you can see files and directories on the distant computer just
as if they were on your own system, download them onto your computer using
&konqueror;'s normal <guimenuitem>Copy</guimenuitem> and
<guimenuitem>Paste</guimenuitem> or Drag 'n Drop methods and, if allowed, upload
files from your machine to the other computer's filesystem. To try it, type the
<acronym>URL</acronym>.</para>

<screen>
<userinput>ftp://ftp.kde.org/pub/kde</userinput>
</screen>

<para>into the Locationbar and press <keycap>Enter</keycap>. As long as you are
connected to the Internet, and as long as the &kde;'s &FTP; site is not too
busy, you should end up seeing the <filename
class="directory">/pub/kde</filename> directory at ftp.kde.org</para>

<note><para>Although, strictly speaking, &FTP; <acronym>URL</acronym>'s should
be entered starting with <userinput>ftp://</userinput> and <abbrev>WWW</abbrev>
<acronym>URL</acronym>s starting with <userinput>http://</userinput> &konqueror;
is usually smart enough to figure out what is meant, and insert these characters
for you if you leave them out.</para></note>

<para>When you access an &FTP; site it will usually need some form of username
and password from you. To simplify things, most &FTP; sites that offer files for
free downloading will accept the word <systemitem><!-- on move to 4.1 add -->
<!-- class="username" -->anonymous</systemitem> as a username and your email
address as a password, and to make your life even easier &konqueror; will
automatically supply these without troubling you. </para>

<para>Sites that are more concerned with security will need a proper username
and password, in which case &konqueror; will ask you for them or you can include
the username in the <acronym>URL</acronym> you type into the Locationbar, as for
example</para>

<screen>
<userinput>ftp://<replaceable>username</replaceable>@ftp.cia.org</userinput></screen>

<para>&konqueror; will then prompt you for the password.</para>

</sect1>

</chapter>

<chapter id="bookmarks">
<title>Using Bookmarks</title>

<para>Although you can use &konqueror;'s bookmarks to record the locations of
your own files and directories, they are most useful when you are surfing the
Web, letting you build up a list of useful sites.</para>

<para>To open the <guimenu>Bookmarks</guimenu> drop-down list you may either
<mousebutton>left</mousebutton> click on the Menubar
<guimenu>Bookmarks</guimenu> item, or use the <keycombo
action="simul"><keycap>Alt</keycap><keycap>B</keycap></keycombo> hotkey. Once
the list is visible, you can navigate through it with the arrow keys or with
your mouse, then press <keycap>Enter</keycap> or &LMB; click to visit the
selected location.</para>

<para>To add a new item to the list use the Menubar <link
linkend="menu-bookmarks"><menuchoice><guimenu>Bookmarks</guimenu>
<guimenuitem>Add Bookmark</guimenuitem></menuchoice></link> item or <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>B</keycap></keycombo> or
<mousebutton>right</mousebutton> click and select <guimenuitem>Add To
Bookmarks</guimenuitem> when you are viewing the desired directory or web
page.</para>

<para>The <guimenu>Bookmarks</guimenu> list can contain folders containing other
bookmarks, or even other folders.</para>

<itemizedlist>
<listitem><para>If you are also using &Netscape;, then a &Netscape; Bookmarks
folder will automatically be added to &konqueror;'s bookmark list so you can use
your current &Netscape; bookmarks in &konqueror;.  </para></listitem>
<listitem><para>Items in you Bookmark Toolbar will usually appear in a folder 
called <quote>Toolbar</quote> although this can be changed 
with the <guilabel>Bookmark Editor</guilabel>.</para></listitem> 
<listitem><para>To add a bookmark into a sub-folder rather than into the main 
Bookmark list, select that folder from the <guimenu>Bookmarks</guimenu> menu and 
use the <guimenuitem>Add Bookmark</guimenuitem> item in that 
folder.</para></listitem></itemizedlist>

<para>If you have a dual-boot &Linux;/&Windows; system, then
<application>Internet Explorer</application>'s
<menuchoice><guimenu>File</guimenu><guisubmenu>Import and
Export</guisubmenu><guimenuitem>Export Favorites</guimenuitem></menuchoice>
option will create a <filename>.htm</filename> file containing links to your
<application>IE</application> favourites. From within &konqueror; you can then,
as long as you have access to the <application>Windows</application> partition,
find that file and add it to your bookmarks. In this way you can access all of
your old <application>IE</application> favourites.</para>

<sect1 id="orgbmark">
<title>Organising Your Bookmarks</title>

<para>The <menuchoice><guimenu>Bookmarks</guimenu> <guimenuitem>Edit
Bookmarks...</guimenuitem> </menuchoice> option opens the <guilabel>Bookmark
Editor</guilabel> in a new window. Here is where you can:</para>

<itemizedlist>
<listitem><para>Move items around, with Drag 'n Drop or by using
<guimenuitem>Cut</guimenuitem> and <guimenuitem>Paste</guimenuitem>, or
<guimenuitem>Delete</guimenuitem> unwanted bookmarks and folders. The order in
the <guilabel>Bookmark Editor</guilabel> is the order they will appear in the
<guimenu>Bookmarks</guimenu> drop down list. You can make the list look even
neater by including the occasional separator with the
<menuchoice><guimenu>File</guimenu><guimenuitem>Insert
separator</guimenuitem></menuchoice> option or <keycombo
action="simul"><keycap>Ctrl</keycap>
<keycap>I</keycap></keycombo>.</para></listitem>

<listitem><para>Create new folders and sub folders using the <guimenuitem>Create
New Folder</guimenuitem> option in the <guimenu>File</guimenu> menu or from the
drop down menu you get when you <mousebutton>right</mousebutton> click on the
main part of the window, or with <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></para></listitem>

<listitem><para>Change a bookmark's name by selecting an item and using
<keycap>F2</keycap> or the
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Rename</guimenuitem></menuchoice>
option or by <mousebutton>right</mousebutton> clicking on the item and
selecting <guimenuitem>Rename</guimenuitem>.</para></listitem>

<listitem><para>Change a bookmark's <acronym>URL</acronym> by
<mousebutton>left</mousebutton> clicking twice on the
<acronym>URL</acronym>.</para></listitem>

<listitem><para>Change the folder used to hold the Bookmark Toolbar 
items by selecting that folder then <mousebutton>left</mousebutton> click on the 
<guimenuitem>Set As Toolbar Folder</guimenuitem> in the 
<guimenu>Settings</guimenu> menu.</para></listitem> 

<listitem><para>Convert to or from &Netscape; and 
Mozilla bookmarks.</para></listitem> 

</itemizedlist>

<note><para>If you can't get the Bookmark Toolbar to appear when 
you check the <guimenuitem>Show Bookmark Toolbar</guimenuitem> box in 
&konqueror;'s <guimenu>Settings</guimenu> menu then select a suitable folder in 
the <guilabel>Bookmark Editor</guilabel> and <mousebutton>left</mousebutton> 
click on the <guimenuitem>Set As Toolbar Folder</guimenuitem> in the 
<guimenu>Settings</guimenu> menu.</para></note>

</sect1> 
</chapter>

<chapter id="save-settings">
<title>Saving Settings &amp; Profiles</title>

<para>Your current <guimenu>View</guimenu> menu settings (such as the
<guimenuitem> View Mode</guimenuitem>, <guimenuitem>Use index.html</guimenuitem>
and <guimenuitem>Show Hidden Files</guimenuitem> items) are automatically saved
by &konqueror; as the default options.</para>

<para>But you can also specify different <guimenu>View</guimenu> menu settings
for any individual directory. To do this check the <guimenuitem>View Properties
Saved in Directory</guimenuitem> box in the <guimenu>Settings</guimenu> menu,
change the <guimenu>View</guimenu> settings to whatever you want and uncheck the
<guimenuitem>View Properties saved in Directory</guimenuitem> box. Doing this
creates a <filename>.directory</filename> file in that directory to hold the
directory <guimenu>View</guimenu> settings. Use the <menuchoice><guimenu>
Settings</guimenu><guimenuitem>Remove Directory
Properties</guimenuitem></menuchoice> option to remove the directory specific
settings (or just delete the <filename>.directory</filename> file).</para>
<note><para>One nice use of this feature is if you have a directory full of
pictures. You can set that particular directory to display thumbnails of the
pictures (by choosing <guimenuitem>Icon View</guimenuitem> and
<guimenuitem>Image Preview</guimenuitem> from the <guimenu>View</guimenu> menu)
when you open it, while not displaying images as thumbnails in other
directories.  </para></note>

<para>Your current settings for the Menubar, Toolbar, Locationbar and Bookmark
Toolbar are also saved as defaults.</para>

<para>&konqueror;'s overall appearance when you start it up is determined by one
of two profiles, depending on whether you start it as a File Manager or as a
Browser. These control the window size, whether the window is split into two or
more views, whether the Sidebar or Terminal Emulator are shown, and the
starting directory or <acronym>URL</acronym>.</para>

<para>To change this start up behaviour, simply set &konqueror; to whatever you
want, then in the <guimenu>Window</guimenu> menu select <guimenuitem>Save View
Profile File Management</guimenuitem> or <guimenuitem>Save View Profile Web
Browsing</guimenuitem> depending on which mode you are in. If you want 
&konqueror; to start up with an empty window enter 
<userinput>about:blank</userinput> into the location bar before saving 
the profile.</para>     

<para>You can also create extra start up profiles and 
save them with the <menuchoice><guimenu>Window </guimenu><guimenuitem>Configure 
View Profiles...</guimenuitem></menuchoice> option. You can then select them 
from the <menuchoice><guimenu>Window</guimenu><guimenuitem>Load View 
Profile</guimenuitem> </menuchoice> drop down menu. </para>
    
<note><para> You can create a desktop icon to start &konqueror; with your new
profile. First create a desktop icon by dragging the &konqueror; icon from the
<guimenu>K</guimenu> menu onto the desktop and selecting <guimenuitem>Copy
Here</guimenuitem>.  Then &RMB; click on the new icon, select
<guimenuitem>Properties...</guimenuitem> and change <guilabel>Program
Name</guilabel> in the <guilabel>Execute</guilabel> tab page to
<userinput><command>kfmclient</command> <option>openProfile
<replaceable>MyNewProfile</replaceable></option></userinput>,
<replaceable>MyNewProfile</replaceable> being what you called the new
profile. Then in the <guilabel>General</guilabel> tab page change the name to
something like <filename>MyNewProfile.desktop</filename> and pick a more
suitable icon.</para></note>

</chapter>

<chapter id="man-info">
<title>Viewing Man and Info Pages</title>
<para>
If you want to read &UNIX; Man pages &konqueror; makes it easy, for 
example type <userinput>man:touch</userinput> or 
<userinput>#touch</userinput> into the locationbar to see the page for 
the touch command.</para> 

<para>And it makes browsing through Info pages an almost pleasant experience. 
<userinput>info:/dir</userinput> takes you to Info's top level directory 
then it's just a matter of clicking on the right links to find the page 
you want.</para> 

</chapter>

<chapter id="config">
<title>Configuring &konqueror;</title>

<para>In common with the rest of &kde;, &konqueror; is highly configurable, so
you can really get the look and feel that best fits your needs and
wishes.</para>

<sect1 id="configure-bars">
<title>Changing Bars</title>

<para>When &kde; is newly installed, &konqueror;'s window contains a Menubar, a
Toolbar, a Locationbar and possibly a Bookmark Toolbar.</para>

<itemizedlist>
<listitem><para>Maybe you don't need all these bars. To hide one of them, go 
into the <guimenu>Settings</guimenu> menu and uncheck its box. To show a hidden
bar, just check the box.</para></listitem> 
<listitem><para>On the left hand end of each bar you can see some vertical
lines. By &LMB; clicking on them, you <quote>flatten</quote> the bar, meaning
that it is hidden but can be quickly restored by clicking on the now horizontal
lines.</para></listitem>
<listitem><para>You can also drag a bar into a new position with these 
lines.</para></listitem> 

<listitem><para>If you &RMB; click on the Toolbar or the Bookmark Toolbar, you 
will get a menu to configure this bar. You can choose the orientation, text 
position and icon size</para></listitem> </itemizedlist>


<note><para>If you hide the Menubar, you won't be able to access the
<guimenu>Settings</guimenu> menu! To restore it, &RMB; click on the view and
check <guimenuitem>Show Menubar</guimenuitem>.</para></note>

<para>The icons shown in the various bars can be changed by using the 
<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure 
Toolbars...</guimenuitem></menuchoice> option, which brings up the 
<guilabel>Configure Toolbars</guilabel> Dialog Box which lets you change the 
icons in</para>

<itemizedlist>
<listitem><para>The <guilabel>Main Toolbar
&lt;Konqueror&gt;</guilabel>.</para></listitem>

<listitem><para>The <guilabel>locationToolBar
&lt;Konqueror&gt;</guilabel>. There's not really much point in changing this.
</para></listitem>

<listitem><para>The <guilabel>Main Toolbar &lt;khtmlpart&gt;</guilabel>. This 
normally contains the <guiicon>Increase</guiicon> and 
<guiicon>Decrease</guiicon> Font Sizes and <guiicon>Security</guiicon> icons 
that are only displayed when &konqueror; is in Browser mode.  </para></listitem>
</itemizedlist>

<para>Note that you can rearrange the position of buttons in a Toolbar by
clicking on the up and down arrow buttons.</para>

</sect1>

<sect1 id="configfm">
<title>File Manager</title>

<para>Choose
<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure 
Konqueror...</guisubmenu><guimenuitem>File Manager</guimenuitem></menuchoice> or 
from the <guimenu>K</guimenu> menu select 
<menuchoice><guimenu>Preferences</guimenu><guisubmenu>File 
Browsing</guisubmenu><guimenuitem>File Manager</guimenuitem></menuchoice>.  This 
will bring up a dialog box with four tabbed pages; 
<guilabel>Appearance</guilabel>, <guilabel>Trash</guilabel>, 
<guilabel>Behaviour</guilabel> and <guilabel>Other</guilabel>. </para>

<sect2>
<title>Behaviour</title> 

<para>Here you can choose whether Konqueror will open up a new window when you
open a directory, or show that directory's contents in the current view.</para>
<para>The <guilabel>Home URL</guilabel> used to let you choose the
<guilabel>Home URL</guilabel>, which is where &konqueror; jumps to when you
press the <guiicon>Home</guiicon> button (this is usually your home directory
<filename>~</filename>), but this selection is overridden by the current <link
linkend="save-settings">profile</link> setting.</para>

</sect2>

<sect2>
<title>Appearance</title>

<para>This page lets you set the font size and color used by &konqueror; and how
text associated with icons is displayed.  </para>

</sect2>

<sect2>
<title>Trash</title>

<para>Here you can choose whether or not &konqueror; asks for confirmation
before deleting items.</para>

</sect2>

<sect2>
<title>Other</title>

<para>This page lets you choose the terminal application (such as &konsole; or
<application>xterm</application>) used when you open a terminal window with
<guimenuitem>Open Terminal</guimenuitem> or <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>T</keycap></keycombo>.</para>

</sect2>

</sect1>


<sect1 id="file-associations">
<title>File Associations</title>

<para>What &konqueror; does when you click on a file name or icon is determined
by the file type and the list of actions that &konqueror; keeps for the various
file types and can be changed to suit your taste or to add a new file
type.</para>

<para><mousebutton>Right</mousebutton> click on a text file and select the
<guimenuitem>Edit File Type</guimenuitem> item.  This will bring up a dialog
box.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="filetype1.png"/></imageobject>
<textobject>
<phrase><guimenuitem>Edit File Type</guimenuitem> dialog,
<guimenu>General</guimenu> tab</phrase>
</textobject>
</mediaobject>

<para>Under the <guilabel>General</guilabel> tab, the <guilabel>Application
Preference Order</guilabel> section defines what appears in the
<guimenuitem>Open With</guimenuitem> menu for this type of file. You can change
these applications and their order. You can also change the icon that
&konqueror; uses for this file type by &LMB; clicking on the icon, and you can
add the extensions (<guilabel>Filename Patterns</guilabel>) for any other types
of file that you want to be handled in the same way.</para>

<note><para>&konqueror; is clever enough to recognise most plain text files and
treat them as such even though they don't have the <filename>.txt</filename>
extension.</para></note>

<para>The <guimenuitem>Embedding</guimenuitem> (which actually refers to the
Preview) tab page controls what happens when you &LMB; click on a
filename. </para>

<note><para>File types are divided into several groups;
<guimenuitem>application</guimenuitem>, <guimenuitem>audio</guimenuitem>,
<guimenuitem>image</guimenuitem>, <guimenuitem>inode</guimenuitem>,
<guimenuitem>message</guimenuitem>, <guimenuitem>text</guimenuitem> and
<guimenuitem>video</guimenuitem>.</para></note>

<para>&konqueror; can be configured to associate any file type with an installed
application.</para>

<para>For example, the Targa image type doesn't exist in &konqueror;. If you
have such a file on your disk, it will have a question mark as an icon. If you
&LMB; click on it, &konqueror; will ask you which application you want to
use. You could just type in the name of a suitable application each time you
select a Targa file, but the best approach is to tell &konqueror; what to do
with a Targa image.</para>

<para>Let's add the Targa mime type to &konqueror;.</para>

<procedure>

<step><para>Open the <menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Configure Konqueror...</guisubmenu> <guimenuitem>File
Associations</guimenuitem></menuchoice> dialog box.</para></step>
<step><para>Click on the <guibutton>Add...</guibutton> button at the lower left,
this will bring up a little dialog box..</para></step>

<step><para>Select <guimenuitem>Image</guimenuitem> in the
<guilabel>Group</guilabel> Drop Down Box, type <userinput>Targa</userinput> in
the <guilabel>Type name</guilabel> Text Box, and press
<guibutton>OK</guibutton>.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="filetype3.png"/></imageobject>
<textobject>
<phrase>Adding the Targa type, step 2</phrase>
</textobject>
</mediaobject>
</step>

<step><para>Now have a look at the upper right hand corner of the File
Associations Dialog Box.  Click on the icon and choose a nice one, here the best
seems to be the <guiicon>image</guiicon> icon. In the <guilabel>Filename
Patterns</guilabel> Text Box, add the patterns <userinput>*.tga</userinput> and
<userinput>*.TGA</userinput> by clicking on the upper right
<guibutton>Add...</guibutton> button. It means that every file with the <literal
role="extension">.tga</literal> or <literal role="extension">.TGA</literal>
(case is important) extension will now be considered as a Targa
image.</para></step>

<step><para>&konqueror; now knows what a Targa file is, but it doesn't know what
to do with it. We need to tell &konqueror; which application to launch to view a
Targa file. At the lower right hand corner in the <guilabel>Application
Preference Order</guilabel> area, click on the <guibutton>Add...</guibutton>
button bring up the following Dialog Box.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="filetype4.png"/></imageobject>
<textobject>
<phrase>Adding the Targa type, step 3</phrase>
</textobject>
</mediaobject>
</step>

<step><para>You can choose an application from the <guilabel>Known
Applications</guilabel> List Box, but as we want to use
<application>Gimp</application> which is not listed, type
<userinput>gimp</userinput> into the <guilabel>Add Application</guilabel>
box.</para></step>

<step><para><application>Gimp</application> is really nice but it is big and not
designed for quick viewing. Click once more on the <guibutton>Add...</guibutton>
button at the lower right hand corner of the File Associations Dialog Box to
bring up the little Application Dialog Box, and in the <guilabel>Add
Application</guilabel> Text Box, type
<userinput><application>xv</application></userinput> or the name of any other
suitable application you can have on your system.  </para></step>

<step><para>Now you have two application in the list. The first one will be the
default application, you can arrange them as you prefer with the <guibutton>Move
Up</guibutton> and <guibutton>Move Down</guibutton> buttons. You should choose
an application for quick viewing as the default application.  </para></step>

</procedure>

<para>All Targa files will now be recognized.</para>

</sect1>

<sect1 id="configure-browser">
<title>Konqueror Browser</title>

<para>Choose
<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure 
Konqueror...</guisubmenu> <guimenuitem>Konqueror 
Browser</guimenuitem></menuchoice> or from the K menu select 
<menuchoice><guimenu>Preferences</guimenu><guimenu>Web 
Browsing</guimenu><guimenuitem>Konqueror Browser</guimenuitem></menuchoice>. 
This will bring up a dialog box with five tabbed pages; 
<guilabel>HTML</guilabel>, <guilabel>Appearance</guilabel>, 
<guilabel>Java</guilabel>, <guilabel>JavaScript</guilabel> and 
<guilabel>Plugins</guilabel>.</para>

<sect2>
<title>HTML</title>

<para>This tab page lets you decide whether &konqueror;'s cursor should change
from a pointer to a hand when it is over a link in the page (advisable as
otherwise you may miss links which are shown as images rather than text), and
whether text links should be shown underlined.</para> <para>It also lets you
decide whether images are to be loaded or, for faster browsing, only when you
wish.</para>

</sect2>

<sect2>

<title>Appearance</title>

<para>This page lets you set the font type, size, character set and default
encoding to be used when browsing.</para>

</sect2>

<sect2>
<title>Java</title>

<para>&Java; is not JavaScript but a full featured language.
<acronym>HTML</acronym> pages using &Java; can cause &Java; programs,
usually called <quote>applets</quote>, to be downloaded and run on your
machine.</para>

<para>The <guilabel>Java</guilabel> tab page lets you set &konqueror;'s
global and domain-specific policies for &Java;.</para>

<para>The <guilabel>Enable Java globally</guilabel> check box controls
whether &konqueror; will generally accept or ignore Java applets, but this can 
be modified by adding Domain-specific Accept or Reject policies. The full domain
name must be entered here, for example to enable (or disable) Java for the
site http://news.bbc.co.uk you have to enter
<userinput>news.bbc.co.uk</userinput> in the Host/Domain field, just putting
<userinput>bbc.co.uk</userinput> or <userinput>*.bbc.co.uk</userinput> will not
work.</para>

<para>To run &Java; applets, you need a Java Virtual Machine
(<acronym>JVM</acronym>) installed on your machine and &konqueror; needs to know
where it is. You can usually just enter <userinput>java</userinput> into the 
<guilabel>Path to java executable</guilabel> text box, but if that doesn't work 
or if you have several virtual machines installed and you want &konqueror; to 
use a particular one then enter the full path to your &Java; installation, such as 
<filename>/usr/java/bin</filename>.</para>

<warning><para>As with any browser, enabling active content (Java or JavaScript)
can weaken your system's security. It is recommended that the <guilabel>Use
Security Manager</guilabel> option in the <guilabel>Java</guilabel> tab page is 
selected if you are enabling &Java;. This requires that the &Java; installation 
on your machine is Java2 compliant. </para></warning>

<note><para>
Visit <ulink url="http://www.konqueror.org">http://www.konqueror.org</ulink> for 
up to date information about how well various &Java; <acronym>JVM</acronym>'s 
work with &konqueror;. </para></note>

</sect2>

<sect2>
<title>JavaScript</title>

<para>Javascript is a small scripting language often used to add animation or
other features to <acronym>HTML</acronym> pages. &konqueror; includes an
ECMAScript compatible interpreter to handle scripting languages such as
&Netscape;'s JavaScript and &Microsoft;'s JScript.</para>
		
<para>The <guilabel>Enable JavaScript globally</guilabel> check box controls
whether &konqueror; will generally accept or ignore Javascript, but this can be
modified by adding Domain-specific Accept or Reject policies as for 
&Java;.</para>

<para>In the <guilabel>Miscellaneous JavaScript Settings</guilabel> area of the
dialog box, the <guilabel>Disable "window.open()"</guilabel> option may be
useful if you regularly visit web sites that make annoying use of this command
to pop up advertisement banners, but be aware that certain sites require the
window.open() function for proper operation. The <guilabel>Show debugger
window</guilabel> option displays information and warnings from the JavaScript
interpreter in a separate window.</para>
</sect2>

<sect2>
<title>Plugins</title>
<para>This tab page lets you globally enable or disable the excution of plugins. 
For more information about plugins see the section <link 
linkend="plugin">Netscape Plugins</link>. </para> 
</sect2>

</sect1>

<sect1 id="configure-enhanced-browsing">
<title>Enhanced Browsing</title>

<para>Use the Menubar
<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure 
Konqueror...</guisubmenu> <guimenuitem>Enhanced 
Browsing</guimenuitem></menuchoice> or the K menu 
<menuchoice><guimenu>Preferences</guimenu><guisubmenu>Web Browsing</guisubmenu> 
<guimenuitem>Enhanced Browsing</guimenuitem></menuchoice> selection to bring up 
the <guilabel>KDE Control Module</guilabel> <guilabel>Enhanced 
Browsing</guilabel> dialog box.</para>

<para>If the <guilabel>Enable Internet Keywords</guilabel> box is checked you
can simply type normal words and phrases such as linux into the Locationbar and
you will either be redirected to the appropriate site or presented with a list
of possible links. To do this &konqueror; submits the word(s) to
<filename>www.internetkeywords.org</filename> which will redirect you if it
finds a matching Internet Keyword.</para>

<para>The <guilabel>Search Fallback</guilabel> drop down box lets you pick a
search engine that will be used if an exact Internet Keyword match isn't
found. If you select <guilabel>None</guilabel> then
<filename>www.internetkeywords.org</filename> will be used.</para>

<para>If you check the <guilabel>Enable Search Shortcuts</guilabel> box
&konqueror; will let you use the <guilabel>Shortcuts</guilabel> defined in the
selection box to choose a particular search engine. For example you can type
<userinput>av:linux</userinput> into the Locationbar to search for
<quote>linux</quote> using Altavista.</para>
</sect1>

<sect1 id="cookies">
<title>Cookies</title>

<para>Use the Menubar
<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure 
Konqueror...</guisubmenu> <guimenuitem>Cookies...</guimenuitem></menuchoice> or 
the K menu <menuchoice><guimenu>Preferences</guimenu><guisubmenu>Web 
Browsing</guisubmenu> <guimenuitem>Cookies</guimenuitem></menuchoice> selection 
to bring up a dialog box with two tabbed pages; <guilabel>Policy</guilabel> and
<guilabel>Management</guilabel>.</para>

<sect2>
<title>Policy</title>

<para>This page allows you to decide whether &konqueror; will handle cookies at
all, and whether it should ask you for confirmation before accepting
them.</para>
<para>You can also set domain specific cookie policies and even share 
them with other people by using the <guibutton>Import</guibutton> and 
<guibutton>Export</guibutton> options.</para> 
</sect2>

<sect2>
<title>Management</title>

<para>This tab page is interesting because it lets you see what
cookies have been placed on your machine and allows you to delete
any or all of them.</para>

</sect2>

</sect1>

<sect1 id="configure-proxy">
<title>Proxy Configuration</title>

<para>The <guilabel>Proxies</guilabel> dialog box is invoked with the Menubar
<menuchoice><guimenu>Settings</guimenu> <guisubmenu>Configure 
Konqueror...</guisubmenu> <guimenuitem>Proxies
</guimenuitem></menuchoice> 
option, or with the K menu 
<menuchoice><guimenu>Preferences</guimenu><guisubmenu>Web Browsing 
</guisubmenu><guimenuitem>Proxies</guimenuitem></menuchoice> choice.</para>

<para>A <quote>proxy</quote> connection to the Internet is one that is made
through another machine, usually a <acronym>LAN</acronym> (Local Area Network)
server, and can give you improved security by separating the computers connected
to the local network from the wide open world of the Internet itself. A proxy
server can also cache downloaded files to give you faster access to recent
downloads.</para>

<para>Proxy servers are traditionally associated with a local intranet within an
organisation, but are now also used by some Cable Network
<acronym>ISP</acronym>s who connect their customers living near to each other
onto a local area network to improve the overall average performance of the
cable network. </para>

<para>If you are on a <acronym>LAN</acronym>, the proxy is perhaps the only way
you can connect to the web, in which case you need to ask your system
administrator or <acronym>ISP</acronym> for connection details.</para>

<procedure>
<step><para>To configure &konqueror; to work with your proxy server, open the
Proxies Configuration dialog box, check <guilabel>Use Proxy</guilabel> and fill
the fields according what your system administrator or <acronym>ISP</acronym>
has told you.</para></step>
<step><para>Of course, the proxy shouldn't be used to access a machine on your
local network. So, in the <guilabel>No Proxy for:</guilabel> field, type the
names of local machines on your network separated by commas. This is usually the
domain name of your <acronym>ISP</acronym> or your company. For example, if
you're on the Ireste school network, you would type <userinput>ireste.fr,
intranet</userinput>, <quote>intranet</quote> being the machine where the
intranet web server is located. This is important if you are on a
<acronym>LAN</acronym> because the proxy won't find the internal
machines.</para></step>
</procedure>

<note><para>The <guilabel>Use Cache</guilabel> option in the dialog box is not
really a proxy option. It allows you to choose to store (cache) downloaded pages
on your local disk so they need not be downloaded again the next time you access
them. We advise you to use this option (whether you use a proxy or not) unless
you are short of disk space in your home directory. </para></note>

</sect1>

<sect1 id="crypto">
<title>Cryptography</title>

<para>Choosing the Menubar
<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure 
Konqueror...</guisubmenu> <guimenuitem>Crypto</guimenuitem></menuchoice> or the 
K menu <menuchoice><guimenu>Preferences</guimenu><guisubmenu>Personalization
</guisubmenu><guimenuitem>Crypto</guimenuitem></menuchoice> option brings up a
dialog box that lets you choose which <acronym>SSL</acronym> options are to be
used when browsing secure (https) sites. Use the Default settings unless you
really know what you are doing.</para> </sect1>

<sect1 id="configure-user-agent">
<title>User Agent</title>

<para>Some web sites tailor their <acronym>HTML</acronym> pages according to the
browser you are using to view them. This is done to cope with differences
between browsers and is done by the web server asking for the browser's
<quote>User Agent</quote> and then comparing it against a list of known
browsers. Unfortunately very few web sites recognise
<quote>&konqueror;</quote>.</para>

<para>To overcome this problem, you can control what &konqueror; reports as it's
User Agent. Selecting
<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure 
Konqueror...</guisubmenu> <guimenuitem>User Agent</guimenuitem></menuchoice> or 
the K menu <menuchoice><guimenu>Preferences</guimenu><guisubmenu>Web
Browsing</guisubmenu><guimenuitem>User Agent</guimenuitem></menuchoice> will
bring up a dialog box allowing you to set the User Agent string for selected
servers or domains.</para>

<para>Some example (and possibly useful) User Agent strings can be seen in the
<guilabel>Login as</guilabel> drop down box.</para>

</sect1>

<sect1 id="plugin">
<title>&Netscape; Plugins</title>

<para>Currently, &konqueror; supports &Netscape; 4.x plugins.</para>

<para>If you select
<menuchoice><guisubmenu>Preferences</guisubmenu><guisubmenu>Web
Browsing</guisubmenu><guimenuitem>Netscape Plugins</guimenuitem></menuchoice>
from the K menu you will get a dialog box with two tabbed pages;
<guilabel>Scan</guilabel> and <guilabel>Plugins</guilabel>.</para>

<sect2>
<title>Scan</title>

<para>This page lets you make &kde; scan for new &Netscape; plugins, either
manually by pressing the <guibutton>Scan for new plugins</guibutton> button or
automatically each time &kde; starts up.</para>
	
<para>The scan is done by looking through the directories listed in the
<guilabel>Scan Directories</guilabel> list for <literal
role="extension">.so</literal> files containing plugin code. It examines every
such file to find out which <acronym>MIME</acronym> types the plugin
supports. It then creates <acronym>MIME</acronym> type definitions for &kde; in
the user's <filename class="directory"> ~/.kde/share/mimelnk</filename>
directory to make other applications aware of the new mime types.</para>

</sect2>

<sect2>
<title>Plugins</title>

<para>This page shows you the &Netscape; plugins that &kde; has found, and for
each plugin it lists the <acronym>MIME</acronym> types and the filename suffixes
it uses to recognise them.</para>

</sect2>
</sect1>

</chapter>

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

<sect1 id="menubar">
<title>The Menubar</title>

<sect2 id="menu-location">
<title>The <guimenu>Location</guimenu> Menu</title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>N</keycap></keycombo></shortcut>
<guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem>New <accel>W</accel>indow</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open</action> another &konqueror;
window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>D</keycap></keycombo></shortcut>
<guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem><accel>D</accel>uplicate Window</guimenuitem>
</menuchoice></term>
<listitem><para>Open another &konqueror; window, <action>duplicating the current
one.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>
</shortcut><guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem><accel>O</accel>pen Location</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open a directory or file</action> by entering its path (for
example <filename class="directory">/home/pam</filename> or
<filename>/home/pam/fred.txt</filename>) in a simple dialog
box.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem>Save <accel>B</accel>ackground Image As...</guimenuitem>
</menuchoice></term>
<listitem>
<para>Only applies if you are viewing a web page with a background image. Opens
the <guilabel>Save As dialog</guilabel> box  to let you save the background
image file to your own computer.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
</shortcut><guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem><accel>S</accel>ave As...</guimenuitem>
</menuchoice></term>
<listitem><para>Only applies if you are viewing a document or web page, uses the
<guilabel>Save As</guilabel> dialog box to let you save a copy to your own
computer.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem>Save <accel>F</accel>rame As...</guimenuitem>
</menuchoice></term>
<listitem><para>Similar to <guimenuitem>Save As</guimenuitem> but for
use with a web site that uses frames.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>P</keycap></keycombo></shortcut>
<guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem><accel>P</accel>rint...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Print.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>P</keycap></keycombo></shortcut>
<guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem>Print Frame</guimenuitem>
</menuchoice></term>
<listitem><para><action>Print selected frame of a Web
page.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem>Open With Netscape</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open the web page you are 
viewing in &konqueror; with Netscape as well.</action></para></listitem> 
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap>
<keycap>Q</keycap></keycombo></shortcut>
<guimenu><accel>L</accel>ocation</guimenu>
<guimenuitem><accel>Q</accel>uit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Close</action> down &konqueror;.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-edit">
<title>The <guimenu>Edit</guimenu> Menu</title>

<note><para>Most items in the Toolbar <guimenu>Edit</guimenu> menu can also be
found by &RMB; clicking on a free area of a view.</para></note>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Und<accel>o</accel></guimenuitem>
</menuchoice></term>
<listitem><para><action>Sometimes lets you reverse a mistaken
action.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>C<accel>u</accel>t</guimenuitem>
</menuchoice></term>
<listitem><para><action>Puts selected item(s) into the clipboard.</action>  If
you then do a  a <guimenuitem>Paste</guimenuitem> the item(s) will be moved
from the original location to the new one.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>C</accel>opy</guimenuitem>
</menuchoice></term>
<listitem><para><action>Copy selected item(s) to the
clipboard.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>P</accel>aste</guimenuitem>
</menuchoice></term>
<listitem><para><action>Paste item(s) from clipboard to the currently viewed
directory.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F2</keycap>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>R</accel>ename</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lets you rename a file or directory</action> without having to
open the <guimenuitem>Properties...</guimenuitem> dialog box.
</para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<shortcut><keycap>Del</keycap></shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>M</accel>ove to Trash</guimenuitem>
</menuchoice></term>
<listitem><para><action>Move selected item(s) to the Trash
directory.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Shift</keycap><keycap>Del</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>D</accel>elete</guimenuitem>
</menuchoice></term>
<listitem><para><action>Delete the selected item(s).</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>Del</keycap></keycombo>
</shortcut>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>S</accel>hred</guimenuitem>
</menuchoice></term>
<listitem><para><action>Shred the selected item(s).</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Create <accel>N</accel>ew</guimenuitem>
</menuchoice></term>
<listitem><para><action>Create a link</action> to an application,
<acronym>URL</acronym>, Floppy or &CD-ROM; device, or create a new Directory or
text or <acronym>HTML</acronym> file. See the <link linkend="making">Create
New...</link>section for more details.</para></listitem> 
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Edit File Type..</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open</action> the <guilabel>Edit File Type</guilabel>
dialog box</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Properties..</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open</action> the <guilabel>Edit Properties</guilabel>
dialog box</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>+</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>S</accel>elect</guimenuitem>
</menuchoice></term>
<listitem><para>Together with the <guimenuitem>Unselect</guimenuitem>,
<guimenuitem>Unselect All</guimenuitem> and <guimenuitem>Invert</guimenuitem>
Selection commands, this provides an easy and powerful way of selecting multiple
files.</para>
<para><action>It brings up a simple dialog box where you can enter a file
name</action> using the wild card characters * and ?, for example entering
<literal role="extension">*.html</literal> will select all files ending with
<literal role="extension">.html</literal> while <filename>?a*</filename> will
select all files which have the letter a as the second character in their
filename.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>-</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>U</accel>nselect</guimenuitem>
</menuchoice></term>
<listitem><para><action>Unselect file or folder.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>U<accel>n</accel>select All</guimenuitem>
</menuchoice></term>
<listitem><para><action>Unselect all selected files or
folders.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>*</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>I</accel>nvert Selection</guimenuitem>
</menuchoice></term>
<listitem><para><action>Invert current selection.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>U</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem>Select <accel>A</accel>ll</guimenuitem>
</menuchoice></term>
<listitem><para><action>Selects all text in a HTML 
page or in a text page being previewed</action>, you can then 
<guimenuitem>Copy</guimenuitem> it and <guimenuitem>Paste</guimenuitem> it into 
a text editor.</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>F</accel>ind</guimenuitem>
</menuchoice></term>
<listitem><para><action>Find a text string</action> in a text
page you are previewing or in an <acronym>HTML</acronym> page.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>
</shortcut><guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>F</accel>ind in Frame</guimenuitem>
</menuchoice></term>
<listitem><para><action>Find a text string</action> in an
<acronym>HTML</acronym> frame.</para></listitem> 
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu>
<guimenuitem><accel>G</accel>o to Line...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Go to a particular line number in a text
page you are previewing.</action></para></listitem>
</varlistentry>


</variablelist>

</sect2>

<sect2 id="menu-view">

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

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guisubmenu>View Mode...</guisubmenu>
</menuchoice></term>
<listitem><para><action>Selects</action> <guimenuitem>Icon</guimenuitem>,
<guimenuitem>MultiColumn</guimenuitem>, <guimenuitem>Tree</guimenuitem>,
<guimenuitem>Detailed List</guimenuitem> 
or <guimenuitem>Text</guimenuitem> view mode.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem><accel>U</accel>se index.html</guimenuitem>
</menuchoice></term>
<listitem><para>If a selected directory contains a file 
<filename>index.html</filename>, it will be <action>opened as a web
page</action> rather than showing the directory as a list of
files.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Lock to current location</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lock to current location.
</action></para></listitem>
</varlistentry>
	  
<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Unlock all views</guimenuitem>
</menuchoice></term>
<listitem><para><action>Unlock all views.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Link View</guimenuitem>
</menuchoice></term>
<listitem><para><action>Link current view to others in a multiple view
window.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F5</keycap></shortcut>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem><accel>R</accel>eload</guimenuitem>
</menuchoice></term>
<listitem><para><action>Reload.</action></para></listitem>
</varlistentry>
	  
<varlistentry>
<term><menuchoice>
<shortcut><keycap>Esc</keycap></shortcut>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem><accel>S</accel>top</guimenuitem>
</menuchoice></term>
<listitem><para><action>Stop load (particularly useful when web
browsing).</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Icon Size</guimenuitem>
</menuchoice></term>
<listitem><para><action>Select size of icons used when
wiewing a directory in Icon Mode.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Sort...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Choose order in which items are presented in the
window when in Icon or MultiColumn View mode.</action></para></listitem>
</varlistentry>
	  
<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Case Insensitive Sort</guimenuitem>
</menuchoice></term>
<listitem><para><action>Choose whether the sort order in Tree, Detailed List
or Text View modes is case sensitive.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>View Document Source</guimenuitem>
</menuchoice></term>
<listitem><para><action>View document source text.</action></para>
<para>Only available if you are viewing a document or <acronym>HTML</acronym>
page.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>View Frame Source</guimenuitem>
</menuchoice></term>
<listitem><para><action>View frame source text</action></para>
<para>Only applies if you are viewing a web site that uses frames. Similar to 
<guimenuitem>View Document Source</guimenuitem>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Security...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Tells you whether the current browser connection is
secured</action> with <acronym>SSL</acronym> and lets you bring up the
<guilabel>Cryptography Configuration...</guilabel> dialog
box. <mousebutton>Left</mousebutton> clicking on the Menubar padlock icon does
the same thing.</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Set <accel>E</accel>ncoding</guimenuitem>
</menuchoice></term>
<listitem><para><action>Set encoding</action></para>
<para>Allows you to choose the character encoding used to display
<acronym>HTML</acronym> pages. <guimenuitem>Auto</guimenuitem> is usually the best
choice.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guisubmenu>Preview</guisubmenu>
</menuchoice></term>
<listitem><para><action>Lets you choose to show thumbnails of images, text files
or HTML pages instead of the normal icons in Icon or
MultiColumn View modes.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Show Hidden Files</guimenuitem>
</menuchoice></term>
<listitem><para><action>Show hidden (dot) files.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Show details...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lets you choose which file and directory details are
shown in Tree, Detailed List and Text views.</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Background Color...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Select background color for the File Manager mode.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu>
<guimenuitem>Background Image...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Select background image for the File Manager mode.
</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-go">
<title>The <guimenu>Go</guimenu> Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Alt</keycap><keysym>Up Arrow</keysym></keycombo>
</shortcut><guimenu><accel>G</accel>o</guimenu>
<guimenuitem><accel>U</accel>p</guimenuitem>
</menuchoice></term>
<listitem><para><action>Go up a level in the directory
hierarchy.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Alt</keycap><keysym>Left Arrow</keysym></keycombo>
</shortcut><guimenu><accel>G</accel>o</guimenu>
<guimenuitem><accel>B</accel>ack</guimenuitem>
</menuchoice></term>
<listitem><para><action>Go back</action> to the previous view.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Alt</keycap><keysym>Right Arrow</keysym></keycombo>
</shortcut><guimenu><accel>G</accel>o</guimenu>
<guimenuitem><accel>F</accel>orward</guimenuitem>
</menuchoice></term>
<listitem><para>You can only <action>go forward</action> if you've just gone 
back.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Home</keycap></keycombo>
</shortcut><guimenu><accel>G</accel>o</guimenu>
<guimenuitem>Home URL</guimenuitem>
</menuchoice></term>
<listitem><para><action>Go to your home directory.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>App<accel>l</accel>ications</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open the directory holding your
applications.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>SideBar Configuration</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the directory holding details of your SideBar in a 
separate window.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>Trash</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open</action> your <filename class="directory">Trash</filename>
directory in a separate window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>Templates</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open</action> the <filename
class="directory">Templates</filename> directory  in a separate
window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>G</accel>o</guimenu>
<guimenuitem>Autostart</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open</action> your <filename
class="directory">Autostart</filename> directory in a separate
window.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-bookmarks">
<title>The <guimenu>Bookmarks</guimenu> Menu</title>

<note><para>See the section <link linkend="bookmarks">Using Bookmarks</link>
in this manual for a fuller description of these menu items.
</para></note>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>B</keycap></keycombo>
</shortcut>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem><accel>A</accel>dd Bookmark</guimenuitem>
</menuchoice></term>
<listitem><para><action>Add current selection to your
bookmarks.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem><accel>E</accel>dit Bookmarks...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open your bookmarks directory in a separate
window.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem><accel>N</accel>ew Folder</guimenuitem>
</menuchoice></term>
<listitem><para><action>Create a new folder in your Bookmarks
dirctory.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem>Netscape Bookmarks</guimenuitem>
</menuchoice></term>
<listitem><para>To see and use your &Netscape; bookmarks.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>B</accel>ookmarks</guimenu>
<guimenuitem>Bookmark Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>To see, edit and use your Bookmark Toolbar
entries.</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-tools">
<title>The <guimenu>Tools</guimenu> Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Alt</keycap><keycap>F2</keycap></keycombo></shortcut>
<guimenu><accel>T</accel>ools</guimenu>
<guimenuitem><accel>R</accel>un Command...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Run a program</action> by entering its name in a simple
dialog box.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>T</keycap></keycombo></shortcut>
<guimenu><accel>T</accel>ools</guimenu>
<guimenuitem>Open <accel>T</accel>erminal...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open</action> a &konsole; terminal window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>T</accel>ools</guimenu>
<guimenuitem><accel>F</accel>ind File...</guimenuitem>
</menuchoice></term>
<listitem><para>Open the &kfind; application.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-settings">
<title>The <guimenu>Settings</guimenu> Menu</title>

<note><para>See also the section <link linkend="save-settings">Saving Settings
and Profiles</link>.</para></note>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show <accel>M</accel>enubar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Show/Hide the menubar.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show <accel>T</accel>oolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Show/Hide the toolbar.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show <accel>E</accel>xtra Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lets you have a second
Toolbar.</action></para></listitem> </varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show <accel>L</accel>ocation Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Show/Hide the locationbar.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Show <accel>B</accel>ookmark Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Show/Hide the Bookmark
Toolbar.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>View Properties Saved in <accel>D</accel>irectory</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save View properties to current directory.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Remove Directory Properties</guimenuitem>
</menuchoice></term>
<listitem><para><action>Remove directory properties.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice> <guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Configure <accel>K</accel>ey Bindings...</guimenuitem>
</menuchoice></term> <listitem><para><action>Lets you
see and change &konqueror;'s key bindings</action>, i.e. the
associations between actions such as <guimenuitem>Copy</guimenuitem> and keys or
combinations of keys such as
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>.</para>
</listitem></varlistentry>

<varlistentry>
<term><menuchoice> <guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem>Configure Tool<accel>b</accel>ars...</guimenuitem>
</menuchoice></term> <listitem><para><action>
Lets you configure the Main, Extra and Location Toolbars.</action> See the
section <link linkend="configure-bars">Changing Bars</link>. 
</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice> <guimenu><accel>S</accel>ettings</guimenu>
<guimenuitem><accel>C</accel>onfigure...</guimenuitem> </menuchoice></term>
<listitem><para><action>Lets you configure the File manager, File Associations,
Browser, Internet Keywords, Cookies, Proxies, Cryptography, User Agent, Key Bindings or Toolbars by
bringing up the appropriate dialog box.</action></para></listitem>
</varlistentry>


</variablelist>

</sect2>

<sect2 id="menu-window">
<title>The <guimenu>Window</guimenu> Menu</title>

<note><para>See also the section <link linkend="save-settings">Saving Settings
and Profiles</link>.</para></note>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>L</keycap></keycombo></shortcut>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>Split View <accel>L</accel>eft/Right</guimenuitem>
</menuchoice></term>
<listitem><para><action>Split View Left/Right.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>T</keycap></keycombo></shortcut>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>Split View <accel>T</accel>op/Bottom</guimenuitem>
</menuchoice></term>
<listitem><para><action>Split View Top/Bottom.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>New View On Right</guimenuitem>
</menuchoice></term>
<listitem><para><action>Add a new view at the right</action> of &konqueror;'s
window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>New View At Bottom</guimenuitem>
</menuchoice></term>
<listitem><para><action>Add a new view at the bottom</action> of &konqueror;'s
window.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>R</keycap></keycombo></shortcut>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem><accel>R</accel>emove Active View</guimenuitem>
</menuchoice></term>
<listitem><para><action>Remove Active View.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>Show Sidebar</guimenuitem>
</menuchoice></term>
<listitem><para><action>Show the Sidebar.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>Show Terminal Emulator</guimenuitem>
</menuchoice></term>
<listitem><para><action>Open a small text terminal view at the bottom of the main 
window.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem><accel>S</accel>ave View Profile "File
Management"</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save the current view profile as the default one for File
Management mode.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem><accel>S</accel>ave View Profile "Web
Browsing"</guimenuitem>
</menuchoice></term>
<listitem><para><action>Save the current view profile as the default one for Web
Browsing mode.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>Configure View Profiles...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Lets you change an existing view profile or create a new one.
</action></para></listitem>
</varlistentry>


<varlistentry>
<term><menuchoice>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>Load <accel>V</accel>iew Profile</guimenuitem>
</menuchoice></term>
<listitem><para><action>Load View Profile.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>F</keycap></keycombo></shortcut>
<guimenu><accel>W</accel>indow</guimenu>
<guimenuitem>Fullscreen Mode</guimenuitem>
</menuchoice></term>
<listitem><para><action>Fullscreen Mode.</action></para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-help">
<title>The <guimenu>Help</guimenu> Menu</title>

<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><action>Contents</action></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><action>Draws a question mark (?) beside the mouse pointer</action>, 
clicking on a window item such as the <guiicon>Stop</guiicon> button will then
display a brief explanation. See <link linkend="bubble">Bubble Help and What's
This ?</link> .</para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>R</accel>eport Bug...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Report bug.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem><accel>A</accel>bout konqueror...</guimenuitem>
</menuchoice></term>
<listitem><para>About &konqueror;</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu><accel>H</accel>elp</guimenu>
<guimenuitem>About <accel>K</accel>DE...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Shows</action> you &konqueror;'s version number,
authors and the License agreement.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>
</chapter>

<chapter id="faq">
<title>Questions and Answers</title>

<qandaset>

<qandaentry>
<question><para>How can I browse web sites using non latin scripts?</para></question>
<answer><para>Detailed instructions can be found at <ulink
url="http://www.konqueror.org/i18n.html">http://www.konqueror.org/i18n.html</ulink></para></answer>
</qandaentry>

<qandaentry>
<question><para>Can I run &konqueror; from another window
manager?</para></question>

<answer><para>Just install &Qt;, kdelibs and kdebase, and from your favourite
window manager, just launch &konqueror;. It should work just fine, but if it
doesn't (&kde; developers don't test that case often), report it to <ulink
url="http://bugs.kde.org">http://bugs.kde.org</ulink> and try running
<application>kdeinit</application> before running &konqueror;, it usually
helps.</para></answer>
</qandaentry>

<qandaentry>
<question><para>Where does &konqueror; keep all its configuration
data?</para></question>
<answer><para>Generally in the <filename>~/.kde</filename> (or
<filename>~/.kde2</filename>) directories. Don't alter these files unless you
really know what you are doing.</para>

<itemizedlist>

<listitem><para>The <filename
class="directory">~/.kde/share/apps/konqueror/profiles</filename> directory
holds individual files containing settings for each of your <link
linkend="save-settings">profiles.  </link></para></listitem>

<listitem><para>Your bookmarks are held in <filename
class="directory">~/.kde/share/apps/konqueror/bookmarks.xml</filename></para></listitem>

<listitem><para>Cookies are held in <filename
class="directory">~/.kde/share/apps/kcookiejar/cookies</filename></para></listitem>

<listitem><para>Your history, as used for the auto-completion feature,  is in
<filename>~/.kde/share/config/konq_history</filename></para></listitem>

<listitem><para>In the directory <filename
class="directory">~/.kde/share/config/</filename> the files
<filename>konqiconviewrc</filename>, <filename>konqlistviewrc</filename> and
<filename>konquerorrc</filename> hold a whole lot of general configuration
settings.</para></listitem>

<listitem><para>The directory
<filename class="directory">~/.kde/share/apps/kio_http/cache/</filename> 
contains the browser cache.</para></listitem>

<listitem><para>The Sidebar View uses the files and subdirectories in
<filename
class="directory">~/.kde/share/apps/konqueror/dirtree</filename></para></listitem>

</itemizedlist>

<para>Any directory specific view settings are put into <literal
role="extension">.directory</literal> files in the individual
directories.</para></answer>
</qandaentry>

<qandaentry>
<question><para>How do I clear out the history file (it's getting rather
large)?</para></question>
<answer><para>The only way at the moment is to delete the
<filename>~/.kde/share/config/konq_history</filename> file, &konqueror; will
create a new, empty, one next time you use it. But note that you can't use
&konqueror; to delete this file; you have to open a text terminal and do
<userinput><command>rm</command>
<option>~/.kde/share/config/konq_history</option></userinput></para></answer>
</qandaentry>

<qandaentry>
<question><para>How do I enable, disable or clear the browser
cache?</para></question> <answer>
<para>For some reason this is done using the Proxies dialog box, choose
<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure 
Konqueror...</guisubmenu><guimenuitem>Proxies</guimenuitem></menuchoice></para>
</answer>
</qandaentry>

<qandaentry>
<question><para>&konqueror; can't run the &Netscape;
<application>Flash</application> player plugin.</para></question>
<answer><para>This is a problem with the <application>Flash</application> plugin
itself. It won't start up until it can grab the audio device, in
&kde; <application>artsd</application> holds onto this.</para></answer>
</qandaentry>

</qandaset>

</chapter>


<chapter id="credits">

<title>Credits and License</title>

<para>&konqueror;. Program copyright 1999-2001, the &konqueror; developers:</para>

<variablelist>

<varlistentry>
<term>David Faure <email>faure@kde.org</email></term>
<listitem><para>developer (parts, I/O lib) and maintainer</para></listitem>
</varlistentry>

<varlistentry>
<term>Simon Hausmann <email>hausmann@kde.org</email></term>
<listitem><para>developer (framework, parts)</para></listitem>
</varlistentry>

<varlistentry>
<term>Michael Reiher <email>michael.reiher@gmx.de</email></term>
<listitem><para>developer (framework)</para></listitem>
</varlistentry>

<varlistentry>
<term>Mattias Welk <email>welk@fokus.gmd.de</email></term>
<listitem><para>developer</para></listitem>
</varlistentry>

<varlistentry>
<term>Alexander Neundorf <email>neundorf@kde.org</email></term>
<listitem><para>developer (list views)</para></listitem>
</varlistentry>

<varlistentry>
<term>Lars Knoll <email>knoll@kde.org</email></term>
<listitem><para>developer (<acronym>HTML</acronym> rendering
engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>Antti Koivisto <email>koivisto@kde.org</email></term>
<listitem><para>developer (<acronym>HTML</acronym> rendering
engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>Dirk Mueller <email>mueller@kde.org</email></term>
<listitem><para>developer (<acronym>HTML</acronym> rendering
engine)</para></listitem>
</varlistentry>

<varlistentry>
<term>Peter Kelly <email>pmk@post.com</email></term>
<listitem><para>developer (<acronym>HTML</acronym> rendering engine,
JavaScript)</para></listitem>
</varlistentry>

<varlistentry>
<term>Waldo Bastian <email>bastian@kde.org</email></term>
<listitem><para>developer (<acronym>HTML</acronym> rendering engine, I/O
lib)</para></listitem>
</varlistentry>

<varlistentry>
<term>Matt Koss <email>koss@miesto.sk</email></term>
<listitem><para>developer (I/O lib)</para></listitem>
</varlistentry>

<varlistentry>
<term>Alex Zepeda <email>jazepeda@pacbell.net</email></term>
<listitem><para>developer (I/O lib)</para></listitem>
</varlistentry>

<varlistentry>
<term>Stephan Kulow <email>coolo@kde.org</email></term>
<listitem><para>developer (I/O lib)</para></listitem>
</varlistentry>

<varlistentry>
<term>Richard Moore <email>rich@kde.org</email></term>
<listitem><para>developer (&Java; applet support)</para></listitem>
</varlistentry>

<varlistentry>
<term>Dima Rogozin <email>dima@mercury.co.il</email></term>
<listitem><para>developer (&Java; applet support)</para></listitem>
</varlistentry>

<varlistentry>
<term>Harri Porten <email>porten@kde.org</email></term>
<listitem><para>developer (JavaScript)</para></listitem>
</varlistentry>

<varlistentry>
<term>Stefan Schimanski <email>1Stein@gmx.de</email></term>
<listitem><para>developer (&Netscape; plugin support)</para></listitem>
</varlistentry>

<varlistentry>
<term>Carsten Pfeiffer <email>pfeiffer@kde.org</email></term>
<listitem><para>developer (framework)</para></listitem>
</varlistentry>

<varlistentry>
<term>George Staikos <email>staikos@kde.org</email></term>
<listitem><para>developer (SSL support)</para></listitem>
</varlistentry>

<varlistentry>
<term>Dawit Alemayehu <email>adawit@kde.org</email></term>
<listitem><para>developer (I/O lib, Authentication support)</para></listitem>
</varlistentry>

<varlistentry>
<term>Carsten Pfeiffer <email>pfeiffer@kde.org</email></term>
<listitem><para>developer (Framework)</para></listitem>
</varlistentry>

<varlistentry>
<term>Torsten Rahn <email>torsten@kde.org</email></term>
<listitem><para>Graphics / icons</para></listitem>
</varlistentry>

<varlistentry>
<term>Torben Weis <email>weis@kde.org</email></term>
<listitem><para>kfm author</para></listitem>
</varlistentry>

</variablelist>

<para>Documentation copyright 2000, 2001</para>

<itemizedlist>
<listitem><para>Erwan Loisant <email>erwan@loisant.org</email></para></listitem>
<listitem><para>Pamela Roberts
<email>pam.roberts@btinternet.com</email></para></listitem>
</itemizedlist>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>

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

<para>&konqueror; is part of the kdebase package which an essential part of
&kde;.</para>

<para>For instructions on acquiring &kde; please see <ulink
url="http://www.kde.org">http://www.kde.org</ulink>.</para>

<para>For further information about &konqueror; you might like to visit 
<ulink url="http://www.konqueror.org">http://www.konqueror.org</ulink>.</para>

</appendix>


&documentation.index; 
</book>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->


