summaryrefslogtreecommitdiffstats
path: root/doc/konqueror
diff options
context:
space:
mode:
Diffstat (limited to 'doc/konqueror')
-rw-r--r--doc/konqueror/Makefile.am4
-rw-r--r--doc/konqueror/basics.docbook386
-rw-r--r--doc/konqueror/bookmarks.docbook129
-rw-r--r--doc/konqueror/browser.docbook482
-rw-r--r--doc/konqueror/cmndline.pngbin0 -> 52222 bytes
-rw-r--r--doc/konqueror/commands.docbook1210
-rw-r--r--doc/konqueror/config.docbook137
-rw-r--r--doc/konqueror/credits.docbook182
-rw-r--r--doc/konqueror/dirtree.pngbin0 -> 50215 bytes
-rw-r--r--doc/konqueror/dragdrop.pngbin0 -> 47960 bytes
-rw-r--r--doc/konqueror/faq.docbook169
-rw-r--r--doc/konqueror/filemanager.docbook898
-rw-r--r--doc/konqueror/index.docbook110
-rw-r--r--doc/konqueror/introduction.docbook64
-rw-r--r--doc/konqueror/konqorg.pngbin0 -> 86855 bytes
-rw-r--r--doc/konqueror/man-kbookmarkmerger.1.docbook112
-rw-r--r--doc/konqueror/parts.pngbin0 -> 34160 bytes
-rw-r--r--doc/konqueror/path-complete.docbook82
-rw-r--r--doc/konqueror/plugins.docbook162
-rw-r--r--doc/konqueror/save-settings.docbook92
-rw-r--r--doc/konqueror/shortcut1.pngbin0 -> 30880 bytes
-rw-r--r--doc/konqueror/shortcut2.pngbin0 -> 14159 bytes
-rw-r--r--doc/konqueror/sidebar.docbook201
23 files changed, 4420 insertions, 0 deletions
diff --git a/doc/konqueror/Makefile.am b/doc/konqueror/Makefile.am
new file mode 100644
index 000000000..da8216ae4
--- /dev/null
+++ b/doc/konqueror/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+KDE_MANS = AUTO
diff --git a/doc/konqueror/basics.docbook b/doc/konqueror/basics.docbook
new file mode 100644
index 000000000..8940df621
--- /dev/null
+++ b/doc/konqueror/basics.docbook
@@ -0,0 +1,386 @@
+<chapter id="basics">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-10-20</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+<title>&konqueror; Basics</title>
+
+<important><para>Like all &kde; applications, &konqueror; is highly
+ configurable. This document describes how &konqueror; behaves with the normal,
+ default settings.</para>
+<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>
+<para>You can read more about mouse usage in <xref
+linkend="lmb-mmb"/></para>
+<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></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 <mousebutton>left</mousebutton> click on it to open
+&konqueror; as a file manager.</para></listitem>
+
+<listitem><para>Or <mousebutton>left</mousebutton> 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>Internet</guisubmenu><guimenuitem>Konqueror Web
+Browser</guimenuitem></menuchoice> to start it as a browser, or
+<guimenuitem>Home</guimenuitem> to launch &konqueror; in file manager mode.
+</para></listitem>
+
+<listitem><para><keycombo action="simul">&Alt;<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 &URL; such as
+ <userinput>http://www.konqueror.org</userinput> 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
+folder, such as a hard disk drive or the <guiicon>Trash</guiicon> icon.
+</para>
+
+
+</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 use <keycombo
+action="simul">&Alt;<keycap>the underlined
+letter</keycap></keycombo> in the name as a hot key, for example <keycombo
+action="simul">&Alt;<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>The <interface>Toolbar</interface> contains icons for commonly used
+operations. <mousebutton>Left</mousebutton> clicking on an icon will activate
+it. If you have enabled tooltips in the Control Center <menuchoice><guimenu>
+Appearance &amp;
+Themes</guimenu><guisubmenu>Style</guisubmenu></menuchoice>
+dialog a brief description of what that icon does will appear when you hover
+the pointer over it.</para>
+
+<para>Some icons, for example the Up and Back icons in the previous screenshot,
+have a small black triangle at their bottom right corner. If you hold the &LMB;
+pressed while the cursor is over this type of icon a small dropdown menu will
+appear.</para> <para><mousebutton>Right</mousebutton> clicking on the
+<interface>Toolbar </interface> will bring up the <link
+linkend="rmb-menus"><guilabel>Toolbar Menu</guilabel></link> which you can use
+to change the <interface>Toolbar</interface>'s appearance and position.</para>
+
+<para>The <interface>Location Toolbar</interface> shows the path to the
+directory, &URL; or file being viewed. You can type a path or &URL; here and
+press &Enter; or <mousebutton>left</mousebutton> click on the
+<guiicon>Go</guiicon> icon at the right hand end of the <interface>Location
+Toolbar</interface> to go to it. The black icon at the left hand end of the
+<interface>Location Toolbar</interface> clears the text entry box.</para>
+
+<para>The <interface>Bookmark Toolbar</interface> is the area under the
+<interface>Location Toolbar</interface> in the previous screenshot. You can add
+frequently used bookmarks here; see the <link
+linkend="orgbmark">Organizing
+Your
+Bookmarks</link> section of this document.</para>
+
+<para>The <interface>Window</interface> is the main area of &konqueror; and
+can show you the contents of a directory, web page, document or image. 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, or set it to contain two or more tabbed views.
+</para>
+
+<para>The <interface>Status Bar</interface> runs across the bottom of the
+&konqueror;'s 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 green 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 <link linkend="rmb-menus"><mousebutton>Right</mousebutton> Mouse
+Button Menu</link>.</para>
+
+<note><para>Don't worry if your &konqueror; doesn't look exactly like this
+screenshot; it is highly configurable. 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, Main Toolbar, Location Toolbar and
+Bookmark Toolbar, or even to add an Extra Toolbar.</para></listitem>
+<listitem><para>You can also <quote>flatten</quote> the toolbars by
+<mousebutton>left</mousebutton> clicking on the vertical lines at the left hand end
+of the bars, or move them around by holding the &LMB; down while you
+drag these bars around. </para></listitem>
+<listitem><para>This screenshot does not show the optional <link linkend="sidebar">
+Navigation Panel</link>.</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>Tooltips 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 <guilabel>Tooltips</guilabel> and
+ the
+<guimenuitem>What's This?</guimenuitem> feature.</para>
+
+<para>If <guilabel>Tooltips</guilabel> have been enabled in &kde; (K menu
+ <menuchoice><guimenu>Control Center</guimenu><guisubmenu>Appearance &amp;
+ Themes</guisubmenu><guisubmenu>Style</guisubmenu></menuchoice>,
+ <guilabel>Style</guilabel> dialog) then when you hover the mouse pointer
+ over a Toolbar or Navigation Panel
+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
+<keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo>, or by
+just &LMB; clicking on the question mark near the top right hand corner of
+&konqueror;'s 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) that
+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 an icon in the
+Bookmark
+ Toolbar
+to open that &URL;.</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 folder icon or
+name and &konqueror; will descend into (show the contents of) that folder.
+</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, showing 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 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 with the <guilabel>File Associations</guilabel> page of
+the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...
+</guimenuitem></menuchoice> dialog.</para></listitem>
+
+</itemizedlist>
+
+<para>Clicking the &MMB; on a file or folder name or icon does essentially the
+same as <mousebutton>left</mousebutton> clicking except that it usually does it
+in a new &konqueror; window, unless the <guilabel>Open links in new tab instead
+of in new window</guilabel> box has been checked in the
+<guimenuitem>Behavior</guimenuitem> page of the
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+
+Konqueror...</guimenuitem></menuchoice> dialog. &konqueror; can open
+links on pages and <menuchoice><guimenu>Bookmarks</guimenu></menuchoice>,
+as well as the
+<guibutton>Home</guibutton>, <guibutton>Up</guibutton>,
+<guibutton>Back</guibutton> and <guibutton>Forward</guibutton>
+entries in a new tab or window.</para>
+
+<para>Holding the &Shift; key down while pressing the &MMB; will open the link
+in the background.</para>
+<important><para>If you click the &MMB; when the mouse cursor is over a blank
+part of the main view (not over a link or file name or icon) &konqueror; will
+copy the contents of the clipboard into the Location Toolbar and try to use
+that as a &URL;.</para></important>
+</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 context menu.</para>
+
+<note><para>If you have enabled the <guilabel>Right click goes back in
+history</guilabel> option in &konqueror;'s <link linkend="othersettings">
+configuration</link> settings a
+simple <mousebutton>right</mousebutton> click is equivalent to clicking on the
+<guibutton>Back</guibutton> button. In this case you can access the context
+menu by moving the mouse with the <mousebutton>right</mousebutton> button held
+down.</para></note>
+
+<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 Main 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 Location Toolbar</term>
+<listitem><para><mousebutton>Right</mousebutton> click in the
+ &URL;
+entry box area to perform Cut, Copy, Paste or Clear operations in this area, or
+to change the automatic <link linkend="path-complete">Text 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 a menu that contains, among other options, the
+ <guiicon>Up</guiicon>,
+<guiicon>Back</guiicon>, <guiicon>Forward</guiicon> and
+<guiicon>Reload</guiicon> navigation commands.
+ </para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>On a File or Folder</term>
+<listitem><para>This is a most useful feature. <mousebutton>Right</mousebutton>
+clicking on the name or icon of any file or folder not only
+<quote>selects</quote> that item but also brings up a menu allowing you to
+<guiicon>Cut</guiicon>, Move, <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>
+
+<sect1 id="man-info">
+<title>Viewing Help, Man and Info Pages</title>
+
+<para>You can view &kde; Help and &UNIX; Man and Info pages directly in
+&konqueror;, without having to start up <application>KHelpCenter</application>.
+</para>
+
+<para>To view a &kde; Help page, enter
+<userinput>help:/<replaceable>application name</replaceable></userinput> (for
+example <userinput>help:/kmail</userinput> to view the &kmail; documentation.)
+into &konqueror;'s Location Toolbar window.
+</para>
+
+<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 Location Toolbar to see the page for
+the <command>touch</command> command.</para>
+
+<para>To browse through &UNIX; Info pages, entering
+<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. Alternatively, use <userinput>info:/<replaceable>command
+name</replaceable></userinput> to go straight to the Info page you want.</para>
+
+<note><para>Unfortunately, &kde; Help pages are stored in such a way that they
+cannot be viewed in other browsers. If you really need to do this your only
+recourse is to go online and visit <ulink url="http://docs.kde.org">
+http://docs.kde.org</ulink>.</para></note>
+</sect1>
+
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/bookmarks.docbook b/doc/konqueror/bookmarks.docbook
new file mode 100644
index 000000000..99eac7ab7
--- /dev/null
+++ b/doc/konqueror/bookmarks.docbook
@@ -0,0 +1,129 @@
+<chapter id="bookmarks">
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-11-05</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+<title>Using Bookmarks</title>
+
+<para>Although you can use &konqueror;'s bookmarks to record the locations of
+your own files and folders, 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> menu you may either
+<mousebutton>left</mousebutton> click on the
+<guimenu>Bookmarks</guimenu> menu or use the <keycombo
+action="simul">&Alt;<keycap>B</keycap></keycombo> shortcut. Once
+the list is visible, you can navigate through it with the arrow keys or with
+your mouse, then press &Enter; or
+<mousebutton>left</mousebutton> click to visit the selected location.</para>
+
+<para>To add a new item to the list use <menuchoice><guimenu>Bookmarks
+</guimenu><guimenuitem>Add Bookmark</guimenuitem></menuchoice> or
+<keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> or
+<mousebutton>right</mousebutton> click on a clear space in the web page or
+folder view and select <guimenuitem>Bookmark this Location</guimenuitem> from
+the pop up menu.</para>
+
+<para>The <guimenu>Bookmarks</guimenu> list can contain subfolders containing
+other bookmarks, you can create these with <menuchoice><guimenu>Bookmarks
+</guimenu><guimenuitem>New Bookmark Folder...</guimenuitem></menuchoice> .
+To add a bookmark into a subfolder rather than into the main Bookmark list,
+select the folder from within the <guimenu>Bookmarks</guimenu> list and use
+the <guimenuitem>Add Bookmark</guimenuitem> item in that folder.</para>
+
+<para>You can also access your bookmarks from the <link linkend="sidebar">
+<guilabel>Navigation Panel</guilabel></link>.</para>
+
+<sect1 id="orgbmark">
+<title>The Bookmark Editor</title>
+
+<para>The <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit
+Bookmarks</guimenuitem> </menuchoice> option opens the <guilabel>Bookmark
+Editor</guilabel>.</para>
+<para>This shows a tree view of your bookmarks and bookmark subfolders.
+As is usual for tree views in &kde;, subfolders are shown with a small square
+at the left of the folder name; if the square contains a <keycap>+</keycap>
+sign <mousebutton>left</mousebutton> clicking on it will expand the view to
+show the contents of that subfolder and the <keycap>+</keycap> sign will
+change to <keycap>-</keycap>, <mousebutton>left</mousebutton> clicking on the
+<keycap>-</keycap> sign will collapse the subfolder view.</para>
+
+<para>To select an item in the list you can <mousebutton>left</mousebutton>
+click on it, or you can navigate through the list by using the <keysym>
+Up arrow</keysym> and <keysym>Down arrow</keysym> keys to move around,
+<keysym>Right arrow</keysym> to expand a subfolder and <keysym>
+Left arrow</keysym> to collapse it.</para>
+
+<para>You can move an item to a different place in the list by using the
+normal Drag and Drop or <guimenuitem>Cut</guimenuitem> and <guimenuitem>
+Paste</guimenuitem> methods. The order in which the items appear in
+the <guilabel>Bookmark Editor</guilabel> is the order they will appear in the
+<guimenu>Bookmarks</guimenu> drop down list. The <menuchoice><guimenu>Insert
+</guimenu><guimenuitem>Insert Separator</guimenuitem></menuchoice> option can
+be used to insert separating lines into the list wherever you wish.</para>
+
+<para>A new subfolder can be created at the selected point in the list by
+using the <guimenuitem>Create New Folder...</guimenuitem> option in the
+<guimenu>Insert</guimenu> menu or from the drop down menu you get when you
+<mousebutton>right</mousebutton> click on an item in the main part of the
+window, or with <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</para>
+
+<para>To change the name of a bookmark or folder select it then press
+<keycap>F2</keycap> or choose the <guimenuitem>Rename</guimenuitem> item from
+the <guimenu>Edit</guimenu> menu or the pop up menu that appears when you
+<mousebutton>right</mousebutton> click on the item. Similarly, you can edit
+the &URL; by pressing <keycap>F3</keycap> or choosing the <guimenuitem>
+Change URL</guimenuitem> menu item.</para>
+
+<para>The <guilabel>Bookmark Editor</guilabel> lets you import bookmarks from
+a range of other browsers into &konqueror;'s bookmark list, putting them into
+ a new folder or replacing all current bookmarks. To do this select
+<guisubmenu>Import</guisubmenu> from the <guimenu>File</guimenu> menu. The
+<menuchoice><guimenu>File</guimenu><guisubmenu>Export</guisubmenu>
+</menuchoice> option can be used to export &konqueror;'s bookmarks to a
+&Netscape; or Mozilla browser.</para>
+
+<para>If you often use the &Netscape; browser as well as &konqueror;, then
+rather than importing your &Netscape; bookmarks into &konqueror; it is
+better to select the <guimenuitem>Show Netscape Bookmarks in Konqueror
+Windows</guimenuitem> item in the <guimenu>Settings</guimenu> menu. If you
+do this any updates to &Netscape;'s bookmarks are automatically seen by
+&konqueror;.</para>
+
+<para>To select which bookmark subfolder is used to hold the Bookmark
+Toolbar items select the subfolder then choose <guimenuitem>Set as Toolbar
+Folder</guimenuitem> from the <guimenu>Edit</guimenu> menu.</para>
+
+<para>If you are tidying up your bookmarks and have forgotten what a
+particular web page is, you can easily open it from within the <guilabel>
+Bookmark Editor</guilabel> by <mousebutton>right</mousebutton> clicking
+on the item and selecting <guimenuitem>Open in Konqueror</guimenuitem> from
+the pop up menu. If you just want to check that the &URL; is still valid
+select <guimenuitem>Check Status</guimenuitem> instead.</para>
+
+<important><para>Don't forget to save your changes with <menuchoice>
+<guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> or
+<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> before you leave
+the <guilabel>Bookmark Editor</guilabel>.
+</para></important>
+</sect1>
+
+
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/browser.docbook b/doc/konqueror/browser.docbook
new file mode 100644
index 000000000..9707e29ad
--- /dev/null
+++ b/doc/konqueror/browser.docbook
@@ -0,0 +1,482 @@
+<chapter id="browser">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-11-05</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+
+<title>&konqueror; the Web Browser</title>
+
+<mediaobject>
+<imageobject><imagedata format="PNG" fileref="konqorg.png"/></imageobject>
+<textobject>
+<phrase>Browsing www.konqueror.org</phrase>
+</textobject>
+</mediaobject>
+
+<sect1 id="conn-inet">
+<title>Connecting to the Internet</title>
+
+<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 &URL; into the <guilabel>Location</guilabel> Toolbar window, press
+&Enter;, 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 dialer 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. This can be
+done with the <guilabel>Proxy</guilabel> page of the <menuchoice><guimenu>
+Settings</guimenu><guimenuitem>Configure Konqueror...</guimenuitem>
+</menuchoice> dialog.</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/&UNIX; distribution you are using. Some <acronym>ISP</acronym>s
+connect their customers to the Internet through a proxy server, in which case
+you will have to set up &konqueror; to use it. 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 &URL;.</para></note>
+
+</sect1>
+
+<sect1 id="surf">
+<title>Surfing and Searching</title>
+
+<para>Once you have a connection to the Internet, you can surf with
+&konqueror; just as you can with any other browser.</para>
+
+<para>Type a &URL; into the Location Toolbar window, press
+&Enter; or <mousebutton>left</mousebutton> click on the
+<guibutton>Go</guibutton> button at the right hand end of the Location
+Toolbar, and &konqueror; will download and display that page.
+If you have visited the page before, &konqueror;'s
+<link linkend="path-complete">Automatic Text Completion</link> feature can help
+you type the &URL; a second time, or you could look through the
+<guilabel>History</guilabel> page in the
+<link linkend="sidebar">Navigation Panel</link>. If you want to use one of
+the web's search engines, &konqueror;'s <link linkend="enhanced-browsing">
+Web Shortcuts</link> feature can make this easier.</para>
+
+<para><mousebutton>Left</mousebutton> click on a link in the page to
+ go there.</para>
+
+<para>To open a link in a new instance of &konqueror;, leaving the
+old page still visible, &MMB; click on the link or <mousebutton> right
+</mousebutton> click on it and select the
+<guimenuitem>Open in New Window</guimenuitem> option. Alternatively, you might want to <guimenuitem>Open in New Tab</guimenuitem>. <link linkend="tabbrowse">Tabbed Browsing</link> will let
+you hold a number of pages in one &konqueror; window and quickly switch
+between them with a single mouse click.</para>
+
+<para>You could also select the multiple view mode with <keycombo
+action="simul">&Ctrl;&Shift;<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 <acronym>HTML</acronym> pages, but make sure the little link
+box at the bottom right hand corner is empty when you are doing
+this.</para>
+<para>To go back to the previous page use the <keycombo
+action="simul">&Alt;<keysym>Left Arrow</keysym></keycombo>
+shortcut, the <guibutton>Back</guibutton> button on the Toolbar, or the Menubar
+<menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice>
+option.</para>
+<para>Similarly, once you have gone back you can go forward by using
+<keycombo action="simul">&Alt;<keysym>Right
+Arrow</keysym></keycombo>, the <guibutton>Forward</guibutton> button, or the
+Menubar
+<menuchoice><guimenu>Go</guimenu>
+<guimenuitem>Forward</guimenuitem></menuchoice> option.</para>
+
+<para>If you want to stop the download for any reason then use the
+<keycap>Esc</keycap> key, the Toolbar <guibutton>Stop</guibutton> 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 <keycap>+</keycap> and
+<keycap>-</keycap> symbols. Use these to adjust the size of the text in the
+page if you find it difficult to read. How well this works will
+depend on how the web page has been constructed.</para>
+</sect1>
+
+<sect1 id="tabbrowse">
+<title>Tabbed Browsing</title>
+<para>By using this feature you can make &konqueror; load multiple web pages in
+the same window, and switch between them using tabbed pages. This way, you can
+preload a page <quote>in the background</quote> while you carry on reading another.</para>
+
+<para>To use tabbed browsing, <mousebutton>right</mousebutton> click on a
+link and choose <guimenuitem>Open in New Tab</guimenuitem> from the drop down
+menu. The page will be downloaded and displayed as normal, but with tabs
+across the top of the view, one tab for each page. <mousebutton>Left
+</mousebutton> click on a tab to view that page, or you can use the shortcuts
+<keycombo action="simul">&Ctrl;<keycap>[</keycap></keycombo> and
+<keycombo action="simul">&Ctrl;<keycap>]</keycap></keycombo> to cycle through
+the tab pages. Alternatively, you can scroll through the tabs using
+the mouse <mousebutton>wheel</mousebutton> while the mouse pointer is
+over the tab bar (presuming that your mouse has one). Also,
+double-clicking over the empty tab bar space will open a new
+tab.</para>
+
+<para>The <guimenuitem>Open in Background Tab</guimenuitem> option in the
+&RMB; menu also downloads the page and shows a new tab for it, but the new
+page will not be displayed until you <mousebutton>left</mousebutton> click
+on the tab.</para>
+
+<para>If you check the <guilabel>Open links in new tab instead of in new window
+</guilabel> box in the <guimenuitem>Web Behavior</guimenuitem> page of the
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...
+</guimenuitem></menuchoice> dialog, &MMB; clicking on a link will open it
+in a new tab page and if you hold the &Shift; key down while clicking the
+&MMB; the link will be opened in a background tab page.</para>
+
+<para><mousebutton>Right</mousebutton> clicking on a tab will bring up a
+menu with the following options:</para>
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>New Tab</guimenuitem></term>
+<listitem><para>This opens a new, blank, tabbed page view.
+You can then download a web page into it by typing the &URL; into the
+Location Bar or by making a selection from the Bookmark Toolbar or the
+<link linkend="sidebar">Navigation Panel</link> history page.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guimenuitem>Duplicate Tab</guimenuitem></term>
+<listitem><para>To create a duplicate tabbed page.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guimenuitem>Detach Tab</guimenuitem></term>
+<listitem><para>This option removes the selected tabbed
+page from the current &konqueror; window and opens it in a new instance of
+&konqueror;.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guimenuitem>Close Tab</guimenuitem></term>
+<listitem><para>To close the selected tab page.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guimenuitem>Reload</guimenuitem></term>
+<listitem><para>Reloads the content of the current tab.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guimenuitem>Reload all Tabs</guimenuitem></term>
+<listitem><para>Reloads the content of every tab.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guimenuitem>Switch to Tab</guimenuitem></term>
+<listitem><para>Displays a submenu showing all other tabs. Choosing a tab from
+this list makes it the active tab.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guimenuitem>Close Other Tabs</guimenuitem></term>
+<listitem><para>To close all but the selected tab page.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="enhanced-browsing">
+<title>Web Shortcuts</title>
+
+<para>If enabled, &konqueror;'s Web Shortcuts
+feature lets you submit a query directly to a search engine or similar web site
+without having to visit the site first.</para> <para>For example, entering
+<userinput>gg:konqueror</userinput> into the Location Bar and pressing &Enter;
+will ask <trademark>Google</trademark> to search for items related to
+&konqueror;.</para> <para>To see what Web Shortcuts are available, and perhaps
+add your own, use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+Konqueror...</guimenuitem></menuchoice> to open the <guilabel>Settings
+</guilabel> dialog box and click on the <guiicon>Web Shortcuts</guiicon>
+icon.</para>
+
+<para>Once there, to make a new Web Shortcut select
+<guibutton>New...</guibutton> and you will now have a new dialog
+requesting the options and specifications of your new Web
+Shortcut. The first field is for the human readable name of the search
+provider; that is, simply the name of the Search provider. For
+example, <trademark>Google</trademark>.</para>
+
+<para>In the next field you should enter the &URI; that is used to do a
+search on the search engine. The whole text to be searched for can be
+specified as <userinput>\{@}</userinput> or
+<userinput>\{0}</userinput>. The recommended version is
+<userinput>\{@}</userinput> since it removes all query variables
+(<replaceable>name</replaceable>=<replaceable>value</replaceable>)
+from the resulting string whereas <userinput>\{0}</userinput> will be
+substituted with the unmodified query string. </para>
+
+<para>You can use <userinput>\{1}</userinput>
+... <userinput>\{n}</userinput> to specify certain words from the
+query and
+<userinput>\{<varname><replaceable>name</replaceable></varname>}</userinput>
+to specify a value given by
+<userinput><varname><replaceable>name</replaceable></varname>=<replaceable>value</replaceable></userinput>
+in the user query. In addition it is possible to specify multiple
+references (names, numbers and strings) at once, like
+<userinput>(\{<varname><replaceable>name1</replaceable></varname>,<varname><replaceable>name2</replaceable></varname>,...,"<replaceable>string</replaceable>"})</userinput>. The first
+matching value (from the left) will be used as substitution value for
+the resulting &URI;. A quoted string can be used as the default value if
+nothing matches from the left of the reference list.</para>
+
+<para>To make a basic Web Shortcut here however, all that is required
+is the &URI; that is used to do a search on the search
+engine. Following our previous example with
+<trademark>Google</trademark>, we would enter
+<userinput>http://www.google.com/search?q=\{@}&amp;ie=UTF-8&amp;oe=UTF-8</userinput>. You
+can often easily find where to place the <userinput>\{@}</userinput>
+by doing a search on the search engine in question, and then analysing
+the &URL; address. For example, doing a <trademark>Google</trademark>
+search for &konqueror; produces the &URL;: <ulink
+url="http://www.google.com/search?q=konqueror&amp;ie=UTF-8&amp;oe=UTF-8">http://www.google.com/search?q=konqueror&amp;ie=UTF-8&amp;oe=UTF-8</ulink>. Now
+you need to merely replace &konqueror; with
+<userinput>\{@}</userinput> in this example to find the appropriate
+&URI; to be entered.</para>
+
+<para>In the third field you need to enter the &URI; shortcut. For
+example, the <userinput>gg</userinput> in
+<userinput>gg:konqueror</userinput>. In the next option &mdash; the
+drop-down menu &mdash; you have the option to select the character set that
+will be used to encode the search query. Once you have entered all the
+options correctly to your satisfaction, press &Enter; and your new Web
+Shortcut should now be available in &konqueror;.</para>
+
+</sect1>
+
+<sect1 id="accesskeys">
+
+<title>Access Keys</title>
+
+<para>&konqueror; has full support for the
+<sgmltag class="attribute">accesskey</sgmltag> &HTML; attribute in
+forms and links. Access keys allow you to use
+the keyboard keys for functions which would perhaps normally be done
+with the mouse, such as following links. The benefit of this is, quite
+simply, that users can interact with a page with devices other than a
+pointing device.</para>
+
+<para>To activate the access keys in &konqueror;, press and release
+&Ctrl;. Once this is pressed, if a particular link on the website has
+the <sgmltag class="attribute">accesskey</sgmltag> attribute in the given link, then the
+character(s) should appear over the link, identifying what needs to be
+pressed. Then, you can enter the character(s) associated with the link
+as an alternative to following the link with the mouse. To disable the
+access keys once activated you can press &Ctrl; again.</para>
+
+<note><para>The proper use of this feature requires that the web
+designer of the page has specifically assigned, using the
+<sgmltag class="attribute">accesskey</sgmltag> attribute, an access key for the
+link. Many web designers might not include the
+<sgmltag class="attribute">accesskey</sgmltag> in their links and forms, and
+consequently this feature will be unusable on the given
+webpage.</para></note>
+
+</sect1>
+
+<sect1 id="useragent">
+<title>Browser Identification</title>
+<para>When &konqueror; connects to a web site it sends some brief browser
+identification information, known as the <quote>User Agent</quote> string.
+Many web sites use this information to customize the pages that they send
+back, based on the strengths and weaknesses of different browsers.</para>
+<para>Unfortunately, some badly designed sites refuse to work properly
+unless you are using a browser that the site recognizes as a
+<quote>valid</quote> one, even though if given a chance, &konqueror; will
+work satisfactorily with the vast majority of web pages.</para>
+<para>To overcome this problem you can change the browser identification
+information that &konqueror; sends for specific sites or domains by
+selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>
+Configure Konqueror...</guimenuitem></menuchoice> to bring up the <guilabel>
+Settings</guilabel> dialog box and clicking the <guiicon>Browser Identification</guiicon>
+icon.</para>
+<note><para>Problems with getting a web page to work properly may also be due
+to its use of &Java; or JavaScript. If you suspect that this may be the case
+check that they have been enabled in the <guiicon>Java &amp; JavaScript
+</guiicon> section of the <guilabel>Settings</guilabel> dialog box.</para></note>
+
+</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
+&HTML; or similar source text) to your local disk with
+<menuchoice><guimenu>Location</guimenu><guimenuitem>Save
+As...</guimenuitem></menuchoice>. 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. <mousebutton>Left</mousebutton> click
+ in the frame you want to save first.</para>
+
+<para>If the page uses a background image, you can get and save that with the
+<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 <mousebutton>right</mousebutton> clicking on the image will
+give you a drop-down menu with a
+<guimenuitem>Save Image As...</guimenuitem> option. Be sure to respect the
+owner's copyright, and ask for permission before using any pictures saved this
+way for anything other than your own viewing pleasure.</para>
+
+<para>If you <mousebutton>right</mousebutton> click on a link (which may be a
+picture) and select <guimenuitem>Save Link As...</guimenuitem> from the pop
+up menu the basic &HTML; or similar source text will be
+downloaded and saved on your local disk.</para>
+
+<para><mousebutton>Right</mousebutton> clicking on a link (which may be a
+picture) and choosing <guimenuitem>Copy Link Location</guimenuitem> will copy
+the &URL; of the link 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><mousebutton>Right</mousebutton> clicking on a picture and choosing
+<guimenuitem>Copy Image Location</guimenuitem> copies the &URL; of the picture
+to the clipboard.</para>
+
+<para>To save a complete web page, including images, select <guimenuitem>
+Archive Web Page...</guimenuitem> from the <guimenu>Tools</guimenu> menu.
+Note that this feature is provided by a <link linkend="konq-plugin">plugin
+</link> and may not have been installed on your system. The web page will be
+saved as a single file with a <literal role="extension">.war</literal>
+extension and can be opened by <mousebutton>left</mousebutton> clicking
+on the filename in &konqueror; running in File Manager mode.</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 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 folders 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 &URL;</para>
+
+<screen>
+<userinput>ftp://ftp.kde.org/pub/kde</userinput>
+</screen>
+
+<para>into the Location Toolbar and press &Enter;. 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> folder at &kde-ftp;</para>
+
+<note><para>Although, strictly speaking, &FTP; &URL;s should
+be entered starting with <userinput>ftp://</userinput> and <acronym>WWW
+</acronym> &URL;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 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>
+
+<note><para>If you try to access an &FTP; site that does not need a proper
+username or password but which is too busy to accept any more connections,
+&konqueror; often interprets the <quote>busy</quote> message as a request for
+a name and password and will therefore pop up a dialog box asking you to
+supply them.</para></note>
+
+<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 &URL; you type into the Location Toolbar, 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>
+
+<para>&konqueror; can also support automatic logins as specified in a
+<filename>.netrc</filename> file. Details of how to enable this feature are
+given at <ulink url="http://www.konqueror.org/faq.html#netrc">
+http://www.konqueror.org/faq.html#netrc</ulink></para>
+
+</sect1>
+
+
+<sect1 id="portnumbers">
+<title>&URL;s with Port Numbers</title>
+<para>If you specify a port number in your &URL;, as in for example
+<userinput>http://intranet.corp.com:1080</userinput>, you might get the error
+message <quote>Access to restricted port in POST denied</quote>. This is done
+for security reasons. If you nevertheless need to access a server on this port,
+just add a key line
+<screen><userinput>
+OverridenPorts=CommaSeparatedListOfAllowedPorts
+</userinput></screen>
+to <filename>$KDEDIR/share/config/kio_httprc
+</filename> or
+<filename>~/.kde/share/config/kio_httprc</filename>.</para>
+<para>For example
+<screen><userinput>OverridenPorts=23,15
+</userinput></screen>
+(it should not include any embedded spaces).</para>
+<para>&konqueror; will reject the following ports (the list is hardcoded in
+<filename>kdelibs/kio/kio/job.cpp</filename>):</para>
+<para>
+ 1, 7, 9, 11, 13, 15, 17, 19,
+ 20, 21, 22, 23, 25, 37, 42, 43,
+ 53, 77, 79, 87, 95, 101, 102, 103, 104,
+ 109, 110, 111, 113, 115, 117, 119, 123,
+ 135, 139, 143, 179, 389, 512, 513, 514,
+ 515, 526, 530, 531, 532, 540, 556, 587,
+ 601, 989, 990, 992, 993, 995, 1080,
+ 2049, 4045, 6000, 6667
+</para>
+</sect1>
+
+
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/cmndline.png b/doc/konqueror/cmndline.png
new file mode 100644
index 000000000..380fead0f
--- /dev/null
+++ b/doc/konqueror/cmndline.png
Binary files differ
diff --git a/doc/konqueror/commands.docbook b/doc/konqueror/commands.docbook
new file mode 100644
index 000000000..2b3142ecc
--- /dev/null
+++ b/doc/konqueror/commands.docbook
@@ -0,0 +1,1210 @@
+<chapter id="commands">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-11-06</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+<title>Command Reference</title>
+
+<note><para>The shortcut key combinations shown in this chapter are the
+default ones. They can of course be <link linkend="configshort">changed</link>.
+</para></note>
+
+<sect1 id="specshort">
+<title>Special Shortcuts</title>
+<para>There are some useful shortcuts that are not shown in any of the menus:</para>
+<variablelist>
+
+<varlistentry>
+<term><keycap>F6</keycap></term>
+<listitem>
+<para>Sets the focus to the text entry box in the Location Toolbar.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>]</keycap></keycombo></term>
+<listitem>
+<para>Activate the next tab page.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keycap>[</keycap></keycombo></term>
+<listitem>
+<para>Activate the previous tab page.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+
+</sect1>
+
+<sect1 id="menubar">
+<title>The Menubar</title> <para>Note that some menu entries only appear when
+they are applicable to the file you currently have open in &konqueror;. For
+example, the
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem>
+</menuchoice>
+item will not appear when you are viewing the contents of a directory.</para>
+<sect2 id="menu-location">
+<title>The <guimenu>Location</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>Location</guimenu>
+<guimenuitem>New Window</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open another &konqueror;
+window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>Location</guimenu> <guimenuitem>New Tab</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open another &konqueror; tab, containing a
+blank page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
+</shortcut>
+<guimenu>Location</guimenu>
+<guimenuitem>Duplicate Window</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open another &konqueror; window, duplicating the
+current
+one.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
+</shortcut>
+<guimenu>Location</guimenu>
+<guimenuitem>Open Location...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open a folder or file 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>Location</guimenu>
+<guimenuitem>Send Link</guimenuitem>
+</menuchoice></term>
+<listitem><para>Send an email containing a link to the current
+location.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Location</guimenu>
+<guimenuitem>Send File</guimenuitem>
+</menuchoice></term>
+<listitem><para>Send an email containing the selected file as an
+attachment.</para></listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Location</guimenu>
+<guimenuitem>Save Background 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">&Ctrl;<keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu>Location</guimenu>
+<guimenuitem>Save 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>Location</guimenu>
+<guimenuitem>Save Frame 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">&Ctrl;<keycap>P</keycap></keycombo>
+</shortcut>
+<guimenu>Location</guimenu>
+<guimenuitem>Print...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Print.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Location</guimenu>
+<guimenuitem>Print Frame</guimenuitem>
+</menuchoice></term>
+<listitem><para>Print selected frame of a Web
+page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Location</guimenu>
+<guimenuitem>Open With Netscape/Mozilla</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open the web page you are
+viewing in &konqueror; with &Netscape;/<application>Mozilla</application> as well.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
+</shortcut>
+<guimenu>Location</guimenu>
+<guimenuitem>Quit</guimenuitem>
+</menuchoice></term>
+<listitem><para>Close down this instance of
+&konqueror;.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="menu-edit">
+<title>The <guimenu>Edit</guimenu> Menu</title>
+
+<note><para>Most items in the Menubar <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">&Ctrl;<keycap>Z</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Undo</guimenuitem>
+</menuchoice></term>
+<listitem><para>Sometimes lets you reverse a mistaken
+action.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Cut</guimenuitem>
+</menuchoice></term>
+<listitem><para>Puts selected item(s) into the clipboard. 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">&Ctrl;<keycap>C</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy</guimenuitem>
+</menuchoice></term>
+<listitem><para>Copy selected item(s) to the
+clipboard.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Paste</guimenuitem>
+</menuchoice></term>
+<listitem><para>Paste item(s) from clipboard to the currently viewed
+folder.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycap>F2</keycap>
+</shortcut><guimenu>Edit</guimenu>
+<guimenuitem>Rename</guimenuitem>
+</menuchoice></term>
+<listitem><para>Lets you rename a file or folder without
+ having to
+open the <guimenuitem>Properties...</guimenuitem> dialog box.
+</para></listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycap>Delete</keycap></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Move to Trash</guimenuitem>
+</menuchoice></term>
+<listitem><para>Move selected item(s) to the Trash
+folder.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Shift;<keycap>Delete</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Delete</guimenuitem>
+</menuchoice></term>
+<listitem><para>Delete the selected item(s).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycap>F7</keycap></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy Files</guimenuitem>
+</menuchoice></term>
+<listitem><para>Copy the selected item(s) to another
+folder.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Move Files</guimenuitem>
+</menuchoice></term>
+<listitem><para>Move the selected item(s) to another
+folder.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Create New</guimenuitem>
+</menuchoice></term>
+<listitem><para>Create a link to an application,
+<acronym>URL</acronym>, Floppy or &CD-ROM; device, or create a new Folder or
+text or &HTML; file. See the <link linkend="making">Create
+New...</link>section for more details.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Edit File Type...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open the <guilabel>Edit File Type</guilabel>
+dialog box</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Properties..</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open the <guilabel>Edit Properties</guilabel>
+dialog box</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu>
+</menuchoice></term>
+<listitem><para>Contains a number of options for changing the items selected in
+the &konqueror; window:
+<!-- DANGER: Nested variablelist! Be careful... -->
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guisubmenu>Selection</guisubmenu>
+<guimenuitem>Select...</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>It brings up a simple dialog box where you can enter a file
+name 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">&Ctrl;<keycap>-</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guisubmenu>Selection</guisubmenu>
+<guimenuitem>Unselect...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Unselect files or folders via a dialog similar to the one used
+by <guimenuitem>Select...</guimenuitem>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guisubmenu>Selection</guisubmenu>
+<guimenuitem>Unselect All</guimenuitem>
+</menuchoice></term>
+<listitem><para>Unselect all selected files or
+folders.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>*</keycap></keycombo>
+</shortcut><guimenu>Edit</guimenu>
+<guisubmenu>Selection</guisubmenu>
+<guimenuitem>Invert Selection</guimenuitem>
+</menuchoice></term>
+<listitem><para>Invert current selection.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
+</shortcut><guimenu>Edit</guimenu>
+<guisubmenu>Selection</guisubmenu>
+<guimenuitem>Select All</guimenuitem>
+</menuchoice></term>
+<listitem><para>Selects all text in an &HTML;
+page or in a text page being previewed, you can then
+<guimenuitem>Copy</guimenuitem> it and <guimenuitem>Paste</guimenuitem> it into
+a text editor.</para></listitem> </varlistentry>
+</variablelist>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
+</shortcut><guimenu>Edit</guimenu>
+<guimenuitem>Find...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Find a text string in a text
+page you are previewing or in an &HTML;
+page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycap>F3</keycap></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Find Next</guimenuitem>
+</menuchoice></term>
+<listitem><para>Find the next occurrence of the text string
+in the text or &HTML; page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Go to Line...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Go to a particular line number in a text
+page you are previewing.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="menu-view">
+
+<title>The <guimenu>View</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guisubmenu>View Mode...</guisubmenu>
+</menuchoice></term>
+<listitem><para>Selects <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>View</guimenu>
+<guimenuitem>Use index.html</guimenuitem>
+</menuchoice></term>
+<listitem><para>If a selected folder contains a file
+<filename>index.html</filename>, it will be opened as a web
+page rather than showing the folder as a list of
+files.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Lock to current location</guimenuitem>
+</menuchoice></term>
+<listitem><para>Lock to current location.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Unlock all views</guimenuitem>
+</menuchoice></term>
+<listitem><para>Unlock all views.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Link View</guimenuitem>
+</menuchoice></term>
+<listitem><para>Link current view to others in a multiple view
+window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycap>F5</keycap></shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Reload</guimenuitem>
+</menuchoice></term>
+<listitem><para>Reload.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycap>Esc</keycap></shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Stop</guimenuitem>
+</menuchoice></term>
+<listitem><para>Stop load (particularly useful when web
+browsing).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Icon Size</guimenuitem>
+</menuchoice></term>
+<listitem><para>Select size of icons used when
+viewing a folder in Icon Mode.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guisubmenu>Sort</guisubmenu>
+</menuchoice></term>
+<listitem><para>Choose order in which items are presented in the
+window when in Icon or MultiColumn View mode.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Case Insensitive Sort</guimenuitem>
+</menuchoice></term>
+<listitem><para>Choose whether the sort order in Tree, Detailed List
+or Text View modes is case sensitive.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap>
+</keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>View Document Source</guimenuitem>
+</menuchoice></term>
+<listitem><para>View document source text.</para>
+<para>Only available if you are viewing a document or &HTML;
+page.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>View Frame Source</guimenuitem>
+</menuchoice></term>
+<listitem><para>View frame source text</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>
+<shortcut><keycombo action="simul">&Ctrl;<keycap>I</keycap>
+</keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>View Document Information</guimenuitem>
+</menuchoice></term>
+<listitem><para>View document information, such as title, &URL;, and &HTTP;
+headers used in retrieving the document.</para>
+<para>Only available if you are viewing an &HTML;
+page.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Security...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Tells you whether the current browser connection is
+secured 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>View</guimenu>
+<guimenuitem>Set Encoding</guimenuitem>
+</menuchoice></term>
+<listitem><para>Set encoding</para>
+<para>Allows you to choose the character encoding used to display
+&HTML; pages. <guimenuitem>Auto</guimenuitem> is usually the
+ best
+choice.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guisubmenu>Preview</guisubmenu>
+</menuchoice></term>
+<listitem><para>Lets you choose to show thumbnails of images, text
+files
+or &HTML; pages instead of the normal icons in Icon or
+MultiColumn View modes.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Show Hidden Files</guimenuitem>
+</menuchoice></term>
+<listitem><para>Show hidden (dot) files.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Show details...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Lets you choose which file and folder details are
+shown in Tree, Detailed List and Text views.</para></listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Background Color...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Select background color for the File Manager mode.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Background Image...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Select background image for the File Manager mode.
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="menu-go">
+<title>The <guimenu>Go</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Alt;<keysym>Up Arrow</keysym></keycombo>
+</shortcut><guimenu>Go</guimenu>
+<guimenuitem>Up</guimenuitem>
+</menuchoice></term>
+<listitem><para>Go up a level in the folder
+hierarchy.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Alt;<keysym>Left Arrow</keysym></keycombo>
+</shortcut><guimenu>Go</guimenu>
+<guimenuitem>Back</guimenuitem>
+</menuchoice></term>
+<listitem><para>Go back to the previous
+view.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Alt;<keysym>Right Arrow</keysym></keycombo>
+</shortcut><guimenu>Go</guimenu>
+<guimenuitem>Forward</guimenuitem>
+</menuchoice></term>
+<listitem><para>You can only go forward if you've just gone
+back.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo>
+</shortcut><guimenu>Go</guimenu>
+<guimenuitem>Home URL</guimenuitem>
+</menuchoice></term>
+<listitem><para>Go to your home folder.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Go</guimenu>
+<guimenuitem>Applications</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open the folder holding your
+applications.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Go</guimenu>
+<guimenuitem>Trash</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open your <filename
+ class="directory">Trash</filename>
+folder in a separate window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Go</guimenu>
+<guimenuitem>Templates</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open the <filename
+class="directory">Templates</filename> folder in a separate
+window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Go</guimenu>
+<guimenuitem>Autostart</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open your <filename
+class="directory">Autostart</filename> folder in a separate
+window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Go</guimenu>
+<guisubmenu>Most Often Visited</guisubmenu>
+</menuchoice></term>
+<listitem>
+<para>Displays a submenu showing the &URL;s you visit most often. Selecting one
+of these will make &konqueror; open that &URL;.</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">&Ctrl;<keycap>B</keycap></keycombo>
+</shortcut>
+<guimenu>Bookmarks</guimenu>
+<guimenuitem>Add Bookmark</guimenuitem>
+</menuchoice></term>
+<listitem><para>Add current selection to your
+bookmarks.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Bookmarks</guimenu>
+<guimenuitem>Bookmark Tabs as Folder...</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>Create a bookmark folder containing links to all of the &URL;s currently
+open in &konqueror; tabs. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Bookmarks</guimenu>
+<guimenuitem>Edit Bookmarks...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open the <link linkend="bookmarks">Bookmark Editor</link>.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Bookmarks</guimenu>
+<guimenuitem>New Bookmark Folder...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Create a new folder in your Bookmarks
+folder.</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<sect2 id="menu-tools">
+<title>The <guimenu>Tools</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo></shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Run Command...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Run a program by entering its name in a
+simple dialog box.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Open Terminal</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open a &konsole; terminal
+ window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Find File...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open the &kfind; application.</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>If you have &konqueror; plugins installed there will be additional
+entries in the <guimenu>Tools</guimenu> menu. See the <link
+linkend="konq-plugin">&konqueror; Plugins</link> chapter for further
+details.</para>
+</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>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show Menubar</guimenuitem>
+</menuchoice></term>
+<listitem><para>Show/Hide the menubar.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Toolbars</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens a sub menu where you can choose to show or hide
+the various Toolbars.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;
+<keycap>F</keycap></keycombo>
+</shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Full Screen Mode</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>Changes &konqueror; to full screen mode, in which the &konqueror; window
+takes up the whole screen, and does not have the usual window decorations. To
+exit full screen mode, click on the <guiicon>Exit Full Screen Mode</guiicon>
+icon on the toolbar, or press <keycombo action="simul">&Ctrl;&Shift;
+<keycap>F</keycap></keycombo>.</para>
+</listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>View Properties Saved in Folder</guimenuitem>
+</menuchoice></term>
+<listitem><para>Save View properties to current
+ folder. If this is selected, a <filename>.directory</filename> file will be
+written in the current directory storing the settings you last used to view the
+directory. These settings are then loaded when you open the directory in &konqueror;.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Remove Folder Properties</guimenuitem>
+</menuchoice></term>
+<listitem><para>Remove settings stored in folder by <guimenuitem>View
+Properties Saved in Folder</guimenuitem>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guisubmenu>Load View Profile</guisubmenu>
+</menuchoice></term>
+<listitem><para>Load the settings associated with a particular view profile.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Save View Profile "<replaceable>ProfileName</replaceable>"...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Save the current settings to the current view profile.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure View Profiles...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Lets you change an existing view profile or create a
+new one.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice> <guimenu>Settings</guimenu>
+<guimenuitem>Configure Shortcuts...</guimenuitem>
+</menuchoice></term> <listitem><para>Lets you
+see and change &konqueror;'s shortcut key bindings, i.e. the
+associations between actions such as <guimenuitem>Copy</guimenuitem> and keys
+or combinations of keys such a <keycombo
+action="simul">&Ctrl;<keycap>V</keycap></keycombo>. If you do
+this take care not to duplicate an existing shortcut.</para>
+</listitem></varlistentry>
+
+<varlistentry>
+<term><menuchoice> <guimenu>Settings</guimenu>
+<guimenuitem>Configure Toolbars...</guimenuitem>
+</menuchoice></term> <listitem><para>
+Lets you configure the Main, Extra and Location Toolbars. See the
+section <link linkend="configure-bars">Changing Bars</link>.
+</para></listitem> </varlistentry>
+
+<varlistentry>
+<term><menuchoice> <guimenu>Settings</guimenu>
+<guimenuitem>Configure &konqueror;...</guimenuitem> </menuchoice></term>
+<listitem><para>Lets you configure the File manager, File Associations,
+Browser, Internet Keywords, Cookies, Proxies, Cryptography, User Agent, or
+Toolbars by bringing up the appropriate dialog box.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice> <guimenu>Settings</guimenu>
+<guimenuitem>Configure Spell Checking...</guimenuitem> </menuchoice></term>
+<listitem>
+<para>Displays the spell checking configuration dialog box, in which you can
+change settings associated with spell checking in &konqueror;.</para>
+</listitem>
+</varlistentry>
+
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="menu-window">
+<title>The <guimenu>Window</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Split View Left/Right</guimenuitem>
+</menuchoice></term>
+<listitem><para>Split View Left/Right.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo
+action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Split View Top/Bottom</guimenuitem>
+</menuchoice></term>
+<listitem><para>Split View Top/Bottom.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo
+action="simul">&Ctrl;&Shift;<keycap>R</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Remove Active View</guimenuitem>
+</menuchoice></term>
+<listitem><para>Remove Active View.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>New Tab</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open a new, empty, tab page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Duplicate Current Tab</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open a duplicate tab page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Detach Current Tab</guimenuitem>
+</menuchoice></term>
+<listitem><para>Show the current tab page in a new instance of
+&konqueror;.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Close Current Tab</guimenuitem>
+</menuchoice></term>
+<listitem><para>Close the current tab page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>Left</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Move Tab Left</guimenuitem>
+</menuchoice></term>
+<listitem><para>Move the current tab one place left in the list of tabs.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>Left</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Move Tab Right</guimenuitem>
+</menuchoice></term>
+<listitem><para>Move the current tab one place right in the list of tabs.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Window</guimenu>
+<guimenuitem>Show Terminal Emulator</guimenuitem>
+</menuchoice></term>
+<listitem><para>Open a small text terminal view at the bottom of the
+ main
+window.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul"><keycap>F9</keycap></keycombo></shortcut>
+<guimenu>Window</guimenu>
+<guimenuitem>Show Navigation Panel</guimenuitem>
+</menuchoice></term>
+<listitem><para>Toggles the display of the &konqueror; navigation panel. See
+<xref linkend="sidebar"/>.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<sect2 id="menu-help">
+<title>The <guimenu>Help</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Help</guimenu>
+<guimenuitem>&konqueror; Handbook</guimenuitem>
+</menuchoice></term>
+<listitem><para>View this document.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo
+ action="simul">&Shift;<keycap>F1</keycap></keycombo></shortcut>
+<guimenu>Help</guimenu>
+<guimenuitem>What's This?</guimenuitem>
+</menuchoice></term>
+<listitem><para>Draws a question mark (?) beside the mouse
+pointer, clicking on a window item such as the
+<guiicon>Stop</guiicon> button will then display a brief explanation. See
+<link linkend="bubble">Tooltips and What's This?</link> .</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Help</guimenu>
+<guimenuitem>&konqueror; Introduction</guimenuitem>
+</menuchoice></term>
+<listitem><para>Revisit the introductory pages that you got when
+&konqueror; was first started.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Help</guimenu>
+<guimenuitem>Report Bug...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Report bug.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Help</guimenu>
+<guimenuitem>About &konqueror;...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Display some brief information about
+&konqueror;'s version number, authors and license agreement.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Help</guimenu>
+<guimenuitem>About KDE...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Show some information about the version of &kde; that
+you are running.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+</sect1>
+
+
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/config.docbook b/doc/konqueror/config.docbook
new file mode 100644
index 000000000..18ebfaa4f
--- /dev/null
+++ b/doc/konqueror/config.docbook
@@ -0,0 +1,137 @@
+<chapter id="config">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-11-06</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+
+<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>Toolbars</title>
+
+<para>When &kde; is newly installed, &konqueror;'s window contains a Menubar,
+Main and Location Toolbars and possibly a Bookmark Toolbar.</para>
+
+<para>Maybe you don't need all these toolbars. To hide one of them, go into
+the <menuchoice><guimenu>Settings</guimenu><guisubmenu>Toolbars</guisubmenu>
+</menuchoice> menu and uncheck its box. To show a hidden toolbar, just check
+the box.</para>
+
+<para>The Menubar itself can be toggled on and off with the shortcut key
+combination <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>.
+</para>
+
+<!-- FIXME -->
+<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. You can also drag a bar into a new position with these
+lines.</para>
+
+<para>If you <mousebutton>right</mousebutton> click on a Toolbar, you
+will get a menu to configure this bar. You can choose the orientation, text
+position and icon size</para>
+
+<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. The Main and Extra Toolbars
+are divided into sections, such as Main Toolbar &lt;&konqueror;&gt;, Main
+Toolbar &lt;khtmlpart&gt; and Extra Toolbar &lt;khtmlsettingsplugin&gt;. The
+number and type of these sections will depend on whether &konqueror; is in Web
+Browser or File Manager mode and whether you have &konqueror; plugins
+installed.</para>
+
+</sect1>
+
+<sect1 id="configshort">
+<title>Shortcuts</title>
+<para>To change the shortcut key arrangements used by &konqueror; select
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...
+</guimenuitem></menuchoice>. This will launch a dialog box as shown below.
+</para>
+<mediaobject>
+<imageobject>
+<imagedata fileref="shortcut1.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Shortcut config screenshot 1</phrase>
+</textobject>
+</mediaobject>
+<para>Search through the combo box to find the action you want to add or
+change the shortcut keys for and select it by <mousebutton>left</mousebutton>
+clicking on the name. You will then be able to change the shortcut by
+selecting the <guilabel>None</guilabel>, <guilabel>Default</guilabel> or
+<guilabel>Custom</guilabel> radio button or by clicking on the large button in
+the <guilabel>Shortcut for Selected Action</guilabel> area.</para>
+
+<para>If you select <guilabel>Define Shortcut</guilabel>, and then
+select <guilabel>Advanced</guilabel>, the dialog box below will be shown:
+</para>
+<mediaobject>
+<imageobject>
+<imagedata fileref="shortcut2.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Shortcut config screenshot 2</phrase>
+</textobject>
+</mediaobject>
+<para>Choose whether you want to change the <guilabel>Primary</guilabel> or
+<guilabel>Alternate</guilabel> shortcut then press the key combination you
+want to act as the shortcut, for example <keycombo action="simul">
+&Ctrl;&Shift;<keycap>S</keycap></keycombo>.
+If the <guilabel>Auto-Close</guilabel> box is checked the dialog will vanish
+as soon as you enter the key combination, otherwise it will remain until you
+press <guibutton>OK</guibutton> or <guibutton>Cancel</guibutton>. Clicking on
+the little black icon with a white cross in it clears the shortcut.</para>
+
+<sect2 id="userdefmenus">
+<title>User Defined Menus</title>
+<para>You can add your own pop up menu to &konqueror; so that pressing one key
+combination will make the menu appear then pressing a second key, or using the
+<keysym>Up arrow</keysym> and <keysym>Down arrow</keysym> keys and pressing
+<keycap>Enter</keycap>, will select an item from it.</para>
+<para>To do this add a <guilabel>Custom</guilabel> shortcut for each of the
+actions you want to appear in the menu and in the <guilabel>Define Shortcut
+</guilabel> dialog check the <guilabel>Multi-Key</guilabel> box, press the
+key combination that you want to bring up your new menu then, separately,
+press the key that will choose that item from the menu.</para>
+</sect2>
+</sect1>
+
+<sect1 id="othersettings">
+<title>Other Settings</title>
+<para>Selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>
+Configure Konqueror...</guimenuitem></menuchoice> brings up a dialog box
+which you can use to control most aspects of &konqueror;'s behavior.
+It contains several sections which are selected by <mousebutton>left
+</mousebutton> clicking on one of the icons at the left of the dialog
+box.</para>
+<para>Pressing the <guibutton>Help</guibutton> button will give you
+detailed instructions about how to use each of these sections, or you can
+use the <link linkend="bubble">What's This?</link> feature.</para>
+</sect1>
+
+
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/credits.docbook b/doc/konqueror/credits.docbook
new file mode 100644
index 000000000..ed63a9b5f
--- /dev/null
+++ b/doc/konqueror/credits.docbook
@@ -0,0 +1,182 @@
+<chapter id="credits">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-11-06</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+
+<title>Credits and License</title>
+
+<para>&konqueror;. Program copyright 1999-2003, the &konqueror;
+ developers:</para>
+
+<variablelist>
+
+<varlistentry>
+<term>&David.Faure; &David.Faure.mail;</term>
+<listitem><para>developer (parts, I/O lib) and maintainer</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Simon.Hausmann; &Simon.Hausmann.mail;</term>
+<listitem><para>developer (framework, parts)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Michael.Reiher; &Michael.Reiher.mail;</term>
+<listitem><para>developer (framework)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Mattias.Welk; &Mattias.Welk.mail;</term>
+<listitem><para>developer</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Alexander.Neundorf; &Alexander.Neundorf.mail;</term>
+<listitem><para>developer (list views)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Michael.Brade; &Michael.Brade.mail;</term>
+<listitem><para>developer (list views, I/O lib)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Lars.Knoll; &Lars.Knoll.mail;</term>
+<listitem><para>developer (<acronym>HTML</acronym> rendering
+engine)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Antti.Koivisto; &Antti.Koivisto.mail;</term>
+<listitem><para>developer (<acronym>HTML</acronym> rendering
+engine)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Dirk.Mueller; &Dirk.Mueller.mail;</term>
+<listitem><para>developer (<acronym>HTML</acronym> rendering
+engine)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Peter.Kelly; &Peter.Kelly.mail;</term>
+<listitem><para>developer (<acronym>HTML</acronym> rendering engine,
+JavaScript)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Waldo.Bastian; &Waldo.Bastian.mail;</term>
+<listitem><para>developer (<acronym>HTML</acronym> rendering engine, I/O
+lib)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Matt.Koss; &Matt.Koss.mail;</term>
+<listitem><para>developer (I/O lib)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Alex.Zepeda; &Alex.Zepeda.mail;</term>
+<listitem><para>developer (I/O lib)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Stephan.Kulow; &Stephan.Kulow.mail;</term>
+<listitem><para>developer (I/O lib)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Richard.J.Moore; &Richard.J.Moore.mail;</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>Wynn Wilkes <email>wynnw@calderasystems.com</email></term>
+<listitem><para>developer (&Java;2 manager support and other major improvements
+to applet support)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Harri.Porten; &Harri.Porten.mail;</term>
+<listitem><para>developer (JavaScript)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Stefan Schimanski <email>schimmi@kde.org</email></term>
+<listitem><para>developer (&Netscape; plugin support)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</term>
+<listitem><para>developer (framework)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&George.Staikos; &George.Staikos.mail;</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>&Torsten.Rahn; &Torsten.Rahn.mail;</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>
+
+<varlistentry>
+<term>&Joseph.Wenninger; &Joseph.Wenninger.mail;</term>
+<listitem><para>developer (navigation panel framework)</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&Stephan.Binner; &Stephan.Binner.mail;</term>
+<listitem><para>developer (misc stuff)</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+<para>Documentation copyright 2000-2003</para>
+
+<itemizedlist>
+<listitem><para>&Erwan.Loisant; &Erwan.Loisant.mail;</para></listitem>
+<listitem><para>&Pamela.Roberts; &Pamela.Roberts.mail;</para></listitem>
+</itemizedlist>
+
+<para>Documentation updated for &kde; 3.2 by &Philip.Rodrigues; &Philip.Rodrigues.mail;.</para>
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+&underGPL;
+
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/dirtree.png b/doc/konqueror/dirtree.png
new file mode 100644
index 000000000..fc20b2cc6
--- /dev/null
+++ b/doc/konqueror/dirtree.png
Binary files differ
diff --git a/doc/konqueror/dragdrop.png b/doc/konqueror/dragdrop.png
new file mode 100644
index 000000000..8994a5c89
--- /dev/null
+++ b/doc/konqueror/dragdrop.png
Binary files differ
diff --git a/doc/konqueror/faq.docbook b/doc/konqueror/faq.docbook
new file mode 100644
index 000000000..5429c71e7
--- /dev/null
+++ b/doc/konqueror/faq.docbook
@@ -0,0 +1,169 @@
+<chapter id="faq">
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-11-06</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+<title>Questions and Answers</title>
+
+<qandaset>
+
+<!-- Link is dead, unfortunately. I suppose this is a more general thing anyway
+<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 favorite
+window manager, 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> folder (this may
+be <filename>~/.kde3</filename> on your system, depending on how &kde; 3
+was installed). 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> folder
+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 folder <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 folder
+<filename class="directory">~/.kde/share/cache/http/</filename>
+contains the browser cache.</para></listitem>
+
+<listitem><para>The Navigation Panel uses the files and subfolders in
+<filename
+class="directory">~/.kde/share/apps/konqsidebartng</filename></para></listitem>
+</itemizedlist>
+
+<para>Any folder specific view settings are put into <literal
+role="extension">.directory</literal> files in the individual
+folders.</para></answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>How do I clear out the history file?</para></question>
+<answer><para>There are two <quote>histories</quote>:</para>
+<itemizedlist>
+<listitem><para>One is used for text completion in the Location Toolbar text entry
+box. To clear this <mousebutton>right</mousebutton> click on the text entry
+box and select <guimenuitem>Clear History
+</guimenuitem>.</para>
+</listitem>
+<listitem><para>The other is the log of visited locations. Select the History
+page in the Navigation Panel,
+<mousebutton>right</mousebutton> click on an entry and choose
+<guimenuitem>Remove Entry</guimenuitem> to remove just that entry or
+<guimenuitem>Clear History</guimenuitem> to delete all
+entries.</para></listitem>
+
+</itemizedlist>
+
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>How do I enable, disable or clear the browser
+cache?</para></question> <answer>
+<para>If you select <guimenuitem>Cache</guimenuitem> in the dialog launched by
+selecting
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Konqueror...
+</guimenuitem></menuchoice>, you will be presented with a dialog box that lets
+you disable the cache, clear it or set its size, and change the caching
+policy.</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>How can I change the timeout values used by &konqueror;
+when web browsing?</para></question> <answer>
+<para>In the Control Center <menuchoice><guimenu>Internet &amp; Network</guimenu>
+<guimenuitem>Preferences</guimenuitem></menuchoice> page.</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>How do I set my <quote>home</quote> page - the page loaded
+on startup?</para></question>
+<answer><para>Start &konqueror; with the <guiicon>Web Browser</guiicon> icon
+on the panel. Open the page you want to be loaded in any new <quote>Web
+Browser</quote> window and select <guimenuitem>Save View Profile "Web
+Browsing"</guimenuitem> from the <guimenu>Settings</guimenu> menu.</para>
+
+<para>All new &konqueror; windows that are started with the <guiicon>Web
+Browser</guiicon> icon on the panel, or from the <guimenu>location</guimenu>
+menu, and new empty tabs, will now start at this page.</para>
+
+<note><para>This does not change the behavior of the
+<guiicon>Home</guiicon> button on the &konqueror; toolbar, which will
+continue to take you to the &URI; defined in the &konqueror; configuration
+module. You can reach that module from within &konqueror;, via
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+Konqueror</guimenuitem><guilabel>Behavior</guilabel></menuchoice>. By
+default this is set to <userinput>~</userinput>, which is your Home folder.
+You may set this to any &URI;, either local or remote, and pressing the
+<guiicon>Home</guiicon> icon on the toolbar will display it.</para></note>
+
+<para>To have &konqueror; start up with no page loaded, use
+<userinput>about:blank</userinput>.</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>I can't find the answer to my question here.</para></question>
+<answer>
+<para>Take a look at <ulink url="http://www.konqueror.org/faq.html">
+http://www.konqueror.org/faq.html</ulink> or
+<ulink url="http://www.konqueror.org/konq-java.html">
+http://www.konqueror.org/konq-java.html</ulink>.</para>
+</answer>
+</qandaentry>
+
+</qandaset>
+
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/filemanager.docbook b/doc/konqueror/filemanager.docbook
new file mode 100644
index 000000000..c6fb880ba
--- /dev/null
+++ b/doc/konqueror/filemanager.docbook
@@ -0,0 +1,898 @@
+<chapter id="filemanager">
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2005-04-01</date>
+<releaseinfo>3.4</releaseinfo>
+</chapterinfo>
+
+<title>&konqueror; the File Manager</title>
+
+<sect1 id="dirfolders">
+<title>Folders and Paths</title>
+<para>In &UNIX; and &Linux; all folders are arranged in a simple
+inverted tree structure descending and branching down from from a single top
+level folder. This means that you can get from any folder to
+any other by going <quote>up</quote> until you reach a common point then
+<quote>down</quote> through the appropriate subfolders until you reach
+your
+target. </para>
+
+<para>The position of any file or folder in the tree can be described by its
+<quote>path</quote>, which is a simple list of the folders you would have
+to descend through to get to the target folder or file. For example
+<filename class="directory">/home/pam</filename> is the subfolder <filename
+class="directory">pam</filename> of the subfolder <filename
+class="directory">home</filename> of the top level folder, and <filename>
+/home/pam/words.txt</filename> is the file <filename>words.txt</filename> in
+that subfolder. The leading <quote>/</quote> in these paths represents the
+top level folder.</para>
+
+<para>Every folder accessible by your system &mdash; including those on
+other hard disk partitions, your floppy and &CD-ROM; &mdash; will appear
+in the tree descending
+from /, their exact paths will depend on how your system was set up (see
+also
+the section on <link linkend="floppy-cd">Floppy and &CD-ROM; Drives</link>).
+</para>
+<para>Every user on a &UNIX; / &Linux; system has their own <quote>home</quote>
+folder to hold their personal files and settings; for example
+<filename class="directory">/home/john</filename> and
+<filename class="directory">/home/mary</filename>. The
+symbol <keycap>~</keycap> is often used to represent the user's home
+folder, so that <filename>~/letter.txt</filename> refers to the file
+<filename>letter.txt</filename> in my home folder.</para>
+<para>Note that the term <quote>directory</quote> is often used instead of
+<quote>folder</quote>.</para>
+</sect1>
+
+<sect1 id="viewmode">
+<title>View Modes</title>
+<para>In File Manager mode, &konqueror; shows you what files and
+subfolders are held in a folder, and can provide you with some
+information about them.</para>
+<para>The <quote>path</quote> of the folder you are looking at is shown in
+the Titlebar, and also in the Location Toolbar, prefixed with <quote>file:
+</quote> to indicate that the folder is part of your computer's normal file
+system. For example <filename>file:/home/pam</filename>.</para>
+
+<para>The way that &konqueror; displays the files and folders depends mainly
+on your choice of View Mode. This can be selected from the <menuchoice>
+<guimenu>View</guimenu><guisubmenu>View Mode</guisubmenu></menuchoice>
+sub menu, which gives you the following options:
+</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>Icon View</guimenuitem></term>
+<listitem><para>Displays the name and a suitable icon for each file or folder.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>MultiColumn View</guimenuitem></term>
+<listitem><para>Similar to <guimenuitem>Icon View</guimenuitem> except that the
+display is neatly formatted into regular columns.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Detailed List View</guimenuitem></term>
+<listitem><para>Displays each file or folder on a separate line, as a small
+icon followed by the file or folder name followed by information about the
+item. The amount of information shown is controlled by the <menuchoice>
+<guimenu>View</guimenu><guisubmenu>Show Details</guisubmenu></menuchoice>
+sub menu settings.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Text View</guimenuitem></term>
+<listitem><para>Similar to <guimenuitem>Detailed List View</guimenuitem>
+except that icons are not shown and the first character in each line will be
+<quote>/</quote> if the item is a folder.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Tree View</guimenuitem></term>
+<listitem><para>This option is useful for <link linkend="navigation">
+navigating</link> through the folder tree below the current folder.
+The display is similar to <guimenuitem>Detailed List View</guimenuitem>
+except that the start of each line will show a small <keycap>+</keycap> sign
+in a box if the item is a folder.
+<mousebutton>Left</mousebutton> clicking on the box will expand the display to
+show the contents of that folder.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Info List View</guimenuitem></term>
+<listitem><para>Similar to <guimenuitem>Detailed List View</guimenuitem>
+except that, where applicable, it shows the number of lines, words and
+characters and file format for each file.
+</para></listitem>
+</varlistentry>
+</variablelist>
+
+<para>The default file icons shown in <guimenuitem>Icon View</guimenuitem> and
+<guimenuitem>MultiColumn View</guimenuitem> modes can be replaced by small
+preview images of the file contents, see the section <link linkend="previews">
+File Previews</link> of this handbook for more details.</para>
+
+<sect2 id="filetipinfo">
+<title>File Tip Info</title>
+<para>Checking the <guilabel>Show file tips</guilabel> box in the <guilabel>
+Behavior</guilabel> page of the &konqueror; Configuration dialog causes a
+small pop up information
+window to appear when the mouse pointer is hovered over a file or folder name
+or icon in <guimenuitem>Icon View</guimenuitem> or <guimenuitem>
+MultiColumn View</guimenuitem> mode.
+</para>
+<para>If the <guilabel>Show previews in file tips</guilabel> checkbox is
+checked the pop up window will also show a small image of the file contents.
+</para>
+</sect2>
+
+<sect2 id="previews">
+<title>File Previews</title>
+<para>Selecting <menuchoice><guimenu>View</guimenu><guisubmenu>Preview
+</guisubmenu></menuchoice> from the Menubar will bring up a sub menu
+that lets you enable file previews for certain types of file.</para>
+<para>Generally this means that the file's icon will be replaced by a small
+image showing the file contents.</para>
+<para>If file preview is enabled for <guimenuitem>Sound Files</guimenuitem>
+the file will be played whenever the mouse cursor is hovering over the file
+name or icon.</para>
+<para>Note that file previews are only available in <guimenuitem>Icon View
+</guimenuitem> and <guimenuitem>MultiColumn View</guimenuitem> modes.</para>
+<para>Because &konqueror; has to read much more data than just the file name
+details to generate a preview, file previews may not be appropriate
+when viewing files on a floppy or from a remote system. The <guilabel>Previews
+</guilabel> page of the File Manager Configuration
+dialog allows you to disable file previews for protocols such as
+<link linkend="ftp">ftp</link> where reading the extra data would take too
+long.</para>
+</sect2>
+
+</sect1>
+
+<sect1 id="navigation">
+<title>Navigation</title>
+<para>To get to a file with &konqueror; you first need to navigate
+through the folder tree to find the folder containing that
+file.</para>
+
+<para>To move between folders you can simply step up and down the
+tree:</para>
+
+<itemizedlist>
+<listitem><para>To descend into a subfolder <mousebutton>left
+</mousebutton> click on its name or
+icon -- or if you have already <quote>selected</quote> it (see below) -- then just press
+<keycap>Enter</keycap>.</para></listitem>
+<listitem><para>To go up the folder tree you can click on the <guiicon>Up
+</guiicon> button in the Toolbar, use<keycombo action="simul">&Alt;<keysym>Up Arrow</keysym></keycombo>, or use the Menubar
+<menuchoice><guimenu>Go</guimenu><guimenuitem>Up</guimenuitem></menuchoice>
+option.</para></listitem>
+</itemizedlist>
+
+<para>To <quote>select</quote> a file or folder in the displayed folder
+without opening it in any way use the <keysym>up</keysym> and <keysym>down
+</keysym> arrow keys to move through the items.
+The selected item will be highlighted and some information about it
+will be displayed in the Status Bar.</para>
+
+<para>Setting the <link linkend="viewmode">View Mode</link> to <guimenuitem>
+Tree View</guimenuitem> can help you locate folders in the tree below the
+current folder; in this mode each folder is shown with a small box at
+the left. If the box contains a <keycap>+</keycap> sign, <mousebutton>left
+</mousebutton> clicking on the box (not on the folder name or icon) will
+display a sub tree showing files and subfolders contained in that folder.
+The small box will then change to show a <keycap>-</keycap> sign.
+<mousebutton>Left</mousebutton> click on that to collapse the sub tree. Once
+you have found the folder you are looking for, <mousebutton>left
+</mousebutton> click on the folder name or icon to open it.</para>
+
+<para>The <link linkend="sidebar">Navigation Panel</link> can also help you
+find your way around the file system.</para>
+
+<para>You can go directly to any folder by typing its path into the
+Location Toolbar 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">&Ctrl;<keycap>
+O</keycap></keycombo>. &konqueror;'s <link linkend="path-complete">
+Text Completion</link> feature may be useful when you do this. Don't forget
+that in &Linux; / &UNIX; file and folder names are case sensitive.</para>
+
+<para>When you have moved to a new folder 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">&Alt;<keysym>Left
+Arrow</keysym></keycombo>. 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">&Alt;<keysym>Right
+Arrow</keysym></keycombo>.</para>
+
+<para>Alternatively, you can also choose to enter the parent folder by clicking on the Toolbar <guiicon>Up</guiicon>, the <menuchoice><guimenu>Go</guimenu> <guimenuitem>Up</guimenuitem></menuchoice> item, or with <keycombo
+action="simul">&Alt;<keysym>Up
+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="file-find">
+<title>Finding Files and Folders</title>
+
+<para>If you don't know or can't remember where a file or folder 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 &kfind; Handbook
+for help in using &kfind;.
+</para>
+
+<note><para>If the name of a file or folder begins with a period (dot), then
+it is a <quote>hidden</quote> file or folder, and will not normally be shown
+by &konqueror;. To see hidden files or folders use the Menubar <menuchoice>
+<guimenu>View</guimenu><guimenuitem>Show Hidden Files</guimenuitem>
+</menuchoice> option.</para>
+<para>Another reason &konqueror; may not show the file or folder you are
+looking for is that you may have the <link linkend="konq-plugin"><guisubmenu>
+View Filter</guisubmenu></link> plugin set to display only certain types of
+file.</para></note>
+
+</sect2>
+
+<sect2 id="floppy-cd">
+<title>Floppy and &CD-ROM; Drives</title>
+
+<para>Any floppy disk, &CD; drive or other hard disk partition that you have
+on your system will usually appear in the <filename class="directory">/
+</filename>, <filename class="directory">/media</filename>, <filename class="directory">/mnt</filename> or
+<filename class="directory">/auto</filename> folder, having a path something
+like <filename class="directory">/mnt/floppy</filename> or
+<filename class="directory">/cdrom</filename>. The details will depend on
+how your system was set up.</para>
+
+<para>&UNIX; / &Linux; requires that you <command>mount</command> a floppy disk
+or &CD-ROM; when you have inserted it into the drive, and <command>mount
+</command> other hard disk partitions when you want to access them. You also
+need to unmount a floppy disk or &CD-ROM; before removing it to 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>, &CD-ROM; and hard disk
+icons on your desktop, in which case &LMB; click on the icon to mount it.
+Doing this should also bring up a &konqueror; window showing the contents of
+the floppy, &CD-ROM; or partition. 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> in this Handbook
+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>
+
+<para><userinput><command>mount /mnt/floppy</command></userinput></para>
+
+<!-- This markup doesn't work properly, it puts 'mount' and '/mnt/floppy'
+on separate lines
+<screen>
+<userinput><command>mount</command>
+ <option><replaceable>/mnt/floppy</replaceable></option></userinput>
+</screen> -->
+
+<para>to mount, for example, the floppy drive, and</para>
+
+<!-- Same as above
+<screen>
+<userinput><command>umount</command>
+ <option><replaceable>/mnt/floppy</replaceable></option></userinput></screen>
+-->
+
+<para><userinput><command>umount /mnt/floppy</command></userinput></para>
+
+<para>to unmount it (<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">&Ctrl;<keycap>E</keycap></keycombo>)
+ feature.
+</para></note>
+
+</listitem>
+
+</itemizedlist>
+</sect2>
+
+</sect1>
+
+<sect1 id="deleting">
+<title>Deleting Files and Folders</title>
+
+<para>&konqueror; gives you two ways to dispose of an unwanted file or
+folder:</para>
+
+<itemizedlist>
+<listitem><para>You can move it to the <filename>Trash</filename> folder, which
+is the safest method as you can get it back if you realize that you have made a
+mistake.</para></listitem>
+
+<listitem><para>You can just plain Delete it, which
+removes the entry from the folder and adds the disk area occupied by the
+file(s) to the system's list of free disk areas, in the same way as the
+<command>rm</command> command.</para></listitem>
+</itemizedlist>
+
+<para>The simplest way to remove a file or folder is to position
+the mouse pointer over its name or icon and press the &RMB;, which
+will bring up a menu containing the options <guimenuitem>Move to
+Trash</guimenuitem> and <guimenuitem>Delete</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> and
+<quote><guimenuitem>Delete</guimenuitem></quote> options.</para>
+
+<para><keycap>Del</keycap> will move the selected item or items to Trash.</para>
+
+<para><keycombo action="simul">&Shift;<keycap>Del</keycap></keycombo>
+will really, truly and irrevocably delete the selected item or
+items.</para>
+
+<note><para>You won't be able to remove a file or folder 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 subfolder between folders 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">&Ctrl;<keycap>C</keycap></keycombo>
+shortcut key combination. You can also select <link linkend="multiple">multiple</link> files or folders to copy/move as well.</para></listitem>
+
+<listitem><para>Navigate to the folder you want to copy the item into then
+Paste the item into the new folder 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">&Ctrl;<keycap>V</keycap></keycombo> shortcut, 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 subfolder between folders can be done in the
+same
+way as copying, except that you choose the <guimenuitem>Cut</guimenuitem>
+option
+or <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
+instead of <guimenuitem>Copy</guimenuitem>. The item that you have
+<guimenuitem>Cut</guimenuitem> will be removed from the original folder when
+you do the <guimenuitem>Paste</guimenuitem> into the new folder.</para>
+
+<para>You can also copy or move selected item(s) to another folder by using
+<menuchoice><guimenu>Edit</guimenu>
+<guimenuitem>Copy Files</guimenuitem></menuchoice> (<keycap>F7</keycap>) or
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Move Files</guimenuitem>
+</menuchoice> (<keycap>F8</keycap>), or by selecting
+<guimenuitem>Copy To</guimenuitem> or <guimenuitem>Move To</guimenuitem> from
+the drop down menu you get when you <mousebutton>right</mousebutton> click on
+an file or folder name in the File Manager window.</para>
+
+<note><para>You may not be able to copy or move a file or folder 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 id="dnd">
+<title>Using Drag 'n Drop</title>
+
+<para>&konqueror; also supports Drag and Drop copying and moving of files and
+folders.</para>
+
+<para>You can do this by having two instances of &konqueror;, one showing the
+folder you want to copy from, the other showing the target folder.
+Position the mouse pointer over the item you wish to copy or move, then,
+holding the &LMB; pressed, <quote>drag</quote> it to a clear space in the
+target
+
+folder. Release the button and you will be
+presented with a menu choice of <guimenuitem>Copy</guimenuitem> or
+<guimenuitem>Move</guimenuitem>. Take care to <quote>drop</quote> the item into
+ an empty area of the target
+folder view - dropping it on top of another file name or icon can cause
+problems.</para>
+
+<para>You can also set up &konqueror; to show more than one folder within
+its window 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>This screenshot illustrates the use of the Menubar
+<menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View
+Left/Right</guimenuitem></menuchoice> option, also available with the shortcut
+<keycombo
+action="simul">&Ctrl;&Shift;<keycap>L</keycap>
+</keycombo>,
+to split the main &konqueror; window into two views, each showing the contents
+of a different folder.</para>
+
+<para>To be able to show different folders in each view they should not be
+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 Location Toolbar 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, <mousebutton>left</mousebutton> 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">&Ctrl;&Shift;<keycap>R</keycap>
+</keycombo> shortcut, 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>
+
+<para>If you use &konqueror; tabs, you can drag and drop between tabs
+by dragging the file to the tab label, without letting go yet. The
+destination tab will pop to the front, allowing you to continue
+dragging and then drop the file.</para>
+
+</sect2>
+
+<sect2 id="dups">
+<title>Duplicate File Names</title>
+<para>If you try to paste a file into a folder that already
+contains a file with the same name, &konqueror; will pop up a dialog box warning
+you that the file already exists. You can then choose to:
+</para>
+<itemizedlist>
+<listitem><para>
+<guilabel>Overwrite</guilabel> the old file with the newly copied one.
+The <guibutton>Overwrite All</guibutton> button can be used if you have copied
+multiple items.</para></listitem>
+<listitem><para>Cancel the paste operation by pressing the <guibutton>Skip
+</guibutton> or <guibutton>Skip All</guibutton> button.</para></listitem>
+<listitem><para>Give the file that is being copied a different name. You can
+do this by typing a new name into the text entry box or get &konqueror; to
+<guibutton>Propose</guibutton> one. When you have done this press the
+<guibutton>Rename</guibutton> button.</para></listitem>
+</itemizedlist>
+</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 folder 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><guisubmenu>Selection</guisubmenu>
+<guimenuitem>Select...</guimenuitem></menuchoice> item or the shortcut
+<keycombo action="simul">&Ctrl;<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><literal role="extension">.png</literal></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">&Ctrl;<keycap>-</keycap></keycombo> to specify
+which of the selected files should be removed from the selection.</para>
+
+<para>Use <keycombo action="simul">&Ctrl;<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.</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">&Ctrl;<keycap>*</keycap></keycombo> to do this.</para>
+
+<para>You can also select multiple files and folders by holding the <keycap>&Ctrl;</keycap> button while you click on each individual file or folder. This enables you to then move or copy multiple files and folders to a different location at one time by using the same method above.</para>
+
+<para>A number of useful shortcut keys can be used in list, tree and text
+view modes:</para>
+<variablelist>
+
+<varlistentry>
+<term><keycap>Space</keycap></term>
+<listitem>
+<para>Toggle the current selection.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycap>Insert</keycap></term>
+<listitem>
+<para>Toggle the current selection and move down to the next item.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Ctrl;<keysym>Up Arrow</keysym></keycombo>,
+<keycombo action="simul">&Ctrl;<keysym>Down Arrow</keysym></keycombo>,
+<keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo>,
+<keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo>,
+<keycombo action="simul">&Ctrl;<keycap>Page Up</keycap></keycombo>,
+<keycombo action="simul">&Ctrl;<keycap>Page Down</keycap></keycombo>
+</term>
+<listitem>
+<para>Move the selection, toggling the selection of everything on the way.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><keycombo action="simul">&Shift;<keysym>Up Arrow</keysym></keycombo>,
+<keycombo action="simul">&Shift;<keysym>Down Arrow</keysym></keycombo>,
+<keycombo action="simul">&Shift;<keycap>Home</keycap></keycombo>,
+<keycombo action="simul">&Shift;<keycap>End</keycap></keycombo>,
+<keycombo action="simul">&Shift;<keycap>Page Up</keycap></keycombo>,
+<keycombo action="simul">&Shift;<keycap>Page Down</keycap></keycombo>
+</term>
+<listitem>
+<para>Deselect everything, then move the selection, selecting everything on
+the way.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<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 may find
+that the <keycombo
+action="simul">&Ctrl;<keycap>+</keycap></keycombo>, <keycombo
+action="simul">&Ctrl;<keycap>-</keycap></keycombo> and <keycombo
+action="simul">&Ctrl;<keycap>*</keycap></keycombo> shortcuts
+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 context menu you get by &RMB; clicking on a free
+area in a folder view gives you a submenu letting you create any
+of the following in the current folder:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Application...</guimenuitem>
+ </menuchoice></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 three 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>Application</guilabel> page you must enter the <guilabel>Command</guilabel> 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;. Advanced
+options such as the file types which the application can open are also
+available from this page.</para>
+
+<para>To make the application icon appear on your desktop, create the link in
+your <filename class="directory">~/Desktop</filename> folder (this may be
+called something slightly different depending on how &kde; was installed on
+your system) or get to the
+<guisubmenu>Create New...</guisubmenu> sub menu by
+<mousebutton>right</mousebutton> clicking on a free area of the desktop
+instead of within &konqueror;'s window.</para>
+
+<para>If you have a lot of specialized application links and don't want to
+clutter up the desktop, then why not create them in your Applications
+folder. 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 folder, which is usually in
+<filename class="directory">~/.kde/share/applnk</filename>.</para>
+
+<para>To put an application link icon into the panel, first create it in the
+Applications folder then drag the icon onto a clear area of the
+panel.</para>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Location (URL)...</guimenuitem></menuchoice></term>
+<listitem><para>This lets you create an icon to open &konqueror; at a
+particular
+folder 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> folder 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><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Floppy Device...</guimenuitem></menuchoice></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. However, in most cases you will want to create the icon
+on
+your desktop.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Hard Disk...</guimenuitem></term>
+<listitem><para>This option is similar to <guimenuitem>Floppy
+Device...</guimenuitem> but for a hard disk drive or
+ partition.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>CD/DVD-ROM Device...</guimenuitem></term>
+<listitem><para>This option is similar to <guimenuitem>Floppy
+Device...</guimenuitem> but for a <acronym>CD</acronym> or <acronym>DVD</acronym>
+drive.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Folder...</guimenuitem></term>
+<listitem><para>An easy way of creating a new (sub)folder.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Text File...</guimenuitem></term>
+<listitem><para>Use this to create an ordinary, empty, text file. A
+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 dialog box it 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 &koffice;
+&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> &kontour;
+document. Name it with the extension <literal
+role="extension">.kil</literal>.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="newname">
+<title>Changing Names and Permissions</title>
+
+<para>The two easiest ways to change the name of a file or folder is to either
+<mousebutton>right</mousebutton> click on it and select
+<guimenuitem>Rename</guimenuitem>, or select the file or folder and then press the <keycap>F2</keycap> button.</para>
+
+<para>To change the name or permissions of a file or folder
+<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 folder, 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 with two tabbed
+pages:</para>
+
+<itemizedlist>
+<listitem><para><guilabel>General</guilabel>, which gives you some
+information about the item and lets you change its name and, for a folder,
+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="copyrename">
+<title>Copy and Rename</title>
+<para>If you want to make a copy of an existing file with a different name --
+perhaps as a backup -- in the same folder as the original file, do a normal
+<guimenuitem>Copy</guimenuitem> then when you <guimenuitem>Paste</guimenuitem>
+it a dialog box will pop up complaining that the file already exists.
+Just type the new name into the dialog's text box and press the
+<guibutton>Rename</guibutton> button (or if you are feeling lazy pressing the
+<guibutton>Propose</guibutton> button will generate a new name for you).</para>
+</sect2>
+
+<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 folder 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 <systemitem class="username">root</systemitem>. </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 <systemitem class="username">root</systemitem>
+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 (<systemitem class="username">root</systemitem>), you have complete control of
+your system, and a wrong command can easily do irrevocable damage.</para>
+<para>Also, connecting to the internet as <systemitem class="username">root</systemitem> is an extremely bad idea, as it
+seriously increases your vulnerability to malicious hacking.</para></warning>
+
+</sect2>
+</sect1>
+
+<sect1 id="file-associations">
+<title>Configuring File Associations</title>
+
+<!-- TODO: The content should probably be here too, but this'll do for -->
+<!-- now. -->
+<para>&kde; provides many applications which can open many different
+types of file. Most of the time, the defaults will work with no
+problems, but &konqueror; provides a powerful system to allow you to
+change the applications used to open each file type. For more details,
+choose the
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+Konqueror...</guimenuitem></menuchoice> menu item, select
+<guilabel>File Associations</guilabel> in the configuration dialog,
+and click on <guibutton>Help</guibutton>.</para>
+
+</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; / &UNIX; user wants to get down to the basics and work at the text
+command line level.</para>
+
+<para>You can, 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">&Ctrl;<keycap>T</keycap></keycombo>.</para>
+<para>If you only want to launch a program or view a &URL;, the <menuchoice>
+<guimenu>Tools</guimenu><guimenuitem>Run Command</guimenuitem></menuchoice>
+(<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>) option may be
+easier.</para>
+
+<para><menuchoice><guimenu>Tools</guimenu><guimenuitem>Execute Shell Command...
+</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;
+<keycap>E</keycap></keycombo>) opens a small command line dialog window where
+you can enter a shell command such as <userinput>ps -ax | grep kdeinit
+</userinput>. Note that it does not support full featured terminal control
+characters, so applications such as <userinput>top</userinput> and <userinput>
+less</userinput> will not work properly, but it is available immediately
+without the delay involved in starting &konsole;.
+</para>
+
+<para>For more complex operations, &konqueror; has another nice feature: the
+Menubar <menuchoice><guimenu>Window</guimenu><guimenuitem>Show Terminal
+Emulator</guimenuitem></menuchoice> option, which opens up a terminal window as
+a new view within &konqueror;. As long as the link icon is visible at the
+bottom right corner of each view, the terminal will follow any folder 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>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/index.docbook b/doc/konqueror/index.docbook
new file mode 100644
index 000000000..ef4c485d3
--- /dev/null
+++ b/doc/konqueror/index.docbook
@@ -0,0 +1,110 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
+ "dtd/kdex.dtd" [
+ <!ENTITY kappname "&konqueror;">
+ <!ENTITY package "kdebase">
+ <!ENTITY konqueror-introduction SYSTEM "introduction.docbook">
+ <!ENTITY konqueror-basics SYSTEM "basics.docbook">
+ <!ENTITY konqueror-filemanager SYSTEM "filemanager.docbook">
+ <!ENTITY konqueror-browser SYSTEM "browser.docbook">
+ <!ENTITY konqueror-path-complete SYSTEM "path-complete.docbook">
+ <!ENTITY konqueror-bookmarks SYSTEM "bookmarks.docbook">
+ <!ENTITY konqueror-sidebar SYSTEM "sidebar.docbook">
+ <!ENTITY konqueror-save-settings SYSTEM "save-settings.docbook">
+ <!ENTITY konqueror-plugins SYSTEM "plugins.docbook">
+ <!ENTITY konqueror-config SYSTEM "config.docbook">
+ <!ENTITY konqueror-commands SYSTEM "commands.docbook">
+ <!ENTITY konqueror-faq SYSTEM "faq.docbook">
+ <!ENTITY konqueror-credits SYSTEM "credits.docbook">
+ <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+ <!ENTITY % addindex "IGNORE">
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+<title>The &konqueror; Handbook</title>
+
+<authorgroup>
+<author>&Pamela.Roberts; &Pamela.Roberts.mail;</author>
+
+<othercredit role="developer">
+<othername>The KDE Team</othername>
+<contrib>Developers</contrib>
+</othercredit>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<copyright>
+<year>2000</year> <year>2002</year>
+<holder>Erwan Loisant</holder>
+<holder>Pamela Roberts</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2002-09-22</date>
+<releaseinfo>3.1</releaseinfo>
+
+<abstract><para>&konqueror; is &kde;'s advanced File Manager, Web Browser and
+ Universal Viewing Application.</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>Konqueror</keyword>
+<keyword>Kdebase</keyword>
+<keyword>File Manager</keyword>
+<keyword>Browser</keyword>
+<keyword>Viewer</keyword>
+</keywordset>
+
+</bookinfo>
+
+
+&konqueror-introduction;
+&konqueror-basics;
+&konqueror-filemanager;
+&konqueror-browser;
+&konqueror-path-complete;
+&konqueror-bookmarks;
+&konqueror-sidebar;
+&konqueror-save-settings;
+&konqueror-plugins;
+&konqueror-config;
+&konqueror-commands;
+&konqueror-faq;
+&konqueror-credits;
+
+
+<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>
+
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+</appendix>
+
+
+&documentation.index;
+</book>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+End:
+-->
diff --git a/doc/konqueror/introduction.docbook b/doc/konqueror/introduction.docbook
new file mode 100644
index 000000000..14fc2a6c8
--- /dev/null
+++ b/doc/konqueror/introduction.docbook
@@ -0,0 +1,64 @@
+<chapter id="introduction">
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-10-20</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+<title>Overview</title>
+
+<para><emphasis>&konqueror;</emphasis> is an advanced
+<link linkend="filemanager">file manager</link> for the
+K Desktop Environment, providing file management functions ranging from simple
+cut/copy and paste operations to advanced local and remote network file
+browsing. Folder contents can be displayed in a variety of text and icon
+<link linkend="viewmode">view modes</link>, which can include thumbnail
+preview images of file contents. File and folder properties can easily be
+examined and changed and applications launched with a simple click of the
+&LMB;.</para>
+
+<para><emphasis>&konqueror;</emphasis> is an <acronym>HTML</acronym> 4.01
+compliant <link linkend="browser">web browser</link> with built in support for
+JavaScript (ECMA-262), <acronym>CSS</acronym> (Cascading Style Sheets) and
+bidirectional scripts (such as Arabic and Hebrew). It provides support for the secure
+running of &Java; applets, &Netscape; plugins for viewing &Flash;, &RealAudio; and &RealVideo; and <acronym>SSL</acronym> for secure
+communications. Advanced features include automatic &URL; and form completion,
+the ability to import bookmarks from other browsers and tabbed browsing.
+</para>
+
+<para><emphasis>&konqueror;</emphasis> is also an excellent full featured
+<link linkend="ftp">FTP</link> client.</para>
+
+<para><emphasis>&konqueror;</emphasis> is a universal viewing application,
+capable of displaying images and documents without having to launch another
+application. It does this by embedding components (&kde; Parts) provided by
+other applications; from &kview; for image viewing, &kdvi; for
+<acronym>DVI</acronym> viewing, &kghostview; for &PostScript; documents and
+from the various &koffice; applications for their document types.
+</para>
+
+<para><emphasis>&konqueror;</emphasis> is a fully customizable application
+which anyone can <link linkend="config">configure</link> to suit their own
+needs, from changing the overall style and the sizes of text and icons to
+selecting which items appear in the Menubar, changing the number and
+positions of the toolbars and even defining new shortcut key combinations.
+Different configuration <link linkend="save-settings">profiles</link> can be
+saved for easy recall as needed.
+</para>
+
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/konqorg.png b/doc/konqueror/konqorg.png
new file mode 100644
index 000000000..0812aa045
--- /dev/null
+++ b/doc/konqueror/konqorg.png
Binary files differ
diff --git a/doc/konqueror/man-kbookmarkmerger.1.docbook b/doc/konqueror/man-kbookmarkmerger.1.docbook
new file mode 100644
index 000000000..dab890556
--- /dev/null
+++ b/doc/konqueror/man-kbookmarkmerger.1.docbook
@@ -0,0 +1,112 @@
+<?xml version="1.0" ?>
+<!-- vim:set ts=4 noet syntax=xml: -->
+<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+<!ENTITY % English "INCLUDE">
+<!ENTITY kbookmarkmerger "<command>kbookmarkmerger</command>">
+]>
+
+<refentry lang="&language;">
+<refentryinfo>
+ <title>KDE User's Manual</title>
+ <author>
+ &Frerich.Raabe;
+ &Frerich.Raabe.mail;
+ </author>
+ <date>February 1st, 2005</date>
+ <productname>K Desktop Environment</productname>
+</refentryinfo>
+
+<refmeta>
+ <refentrytitle>&kbookmarkmerger;</refentrytitle>
+ <manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+ <refname>&kbookmarkmerger;</refname>
+ <refpurpose>A program for merging a given set of bookmarks into the
+ user's list of bookmarks.</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<cmdsynopsis>
+ &kbookmarkmerger;
+ <arg choice="opt" rep="repeat">Qt Options</arg>
+ <arg choice="opt" rep="repeat">KDE Options</arg>
+ <arg choice="req">directory</arg>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+<title>Description</title>
+<para>&kbookmarkmerger; is a program for merging a given set of bookmarks into
+the user's set of bookmarks; if the user doesn't have any bookmarks created
+yet, a new bookmark list is created and the given bookmarks are inserted into
+it. While doing this, &kbookmarkmerger; keeps track of which files were
+merged in a previous run already, so no bookmark will get installed to the
+user's bookmarks more than once. In case &kde; is running while
+&kbookmarkmerger; is executed, the &kde; bookmark subsystem will be informed
+of any changes to the user's bookmarks, so that all applications accessing
+that information (&ie; &konqueror;) will pick the changes up instantly.</para>
+
+<para>The traditionally used approach to achieve something like this was to
+use carefully crafted skeleton home directories when creating a new user
+account, to provide the user with a standard set of bookmarks. The problem
+with this approach is that after the user account has been created, no new
+bookmarks can be propagated.</para>
+
+<para>This mechanism is useful for system administrators who want to propagate
+a bookmark pointing to a certain document (for instance, important notes about
+the system) to all users. Distributors might find it useful as well, for
+instance by augmenting the software packages they supply with bookmark files
+which &kbookmarkmerger; merges into the user's bookmark list when the
+package is installed. That way, documentation shipped with a software package
+is easily and visibly accessible right after the package has been
+installed.</para>
+
+<para>The only parameter required by &kbookmarkmerger; is the name of a
+directory which shall be scanned for bookmark files. All files in the given
+directory will be considered for being merged into the user's setup. The
+files in the given directory should be valid <acronym>XBEL</acronym>
+files.</para>
+</refsect1>
+
+<refsect1>
+<title>See Also</title>
+<para><ulink url="help:/konqueror/index.html">&konqueror; manual</ulink></para>
+</refsect1>
+
+<refsect1>
+<title>Examples</title>
+<screen>joe@hal9000:~> <command>kbookmarkmerger <filename>/usr/local/extra-bookmarks</filename></command></screen>
+<para>Merges all bookmark files stored in
+<filename>/usr/local/extra-bookmarks</filename> into joe's list of
+bookmarks.</para>
+</refsect1>
+
+<refsect1>
+<title>Standards</title>
+<variablelist>
+<varlistentry><term/><listitem><para>
+ <ulink url="http://pyxml.sourceforge.net/topics/xbel/"><acronym>XBEL</acronym> specification</ulink>
+</para></listitem></varlistentry>
+</variablelist>
+</refsect1>
+
+<refsect1>
+<title>Restrictions</title>
+<para>When determining whether a given bookmark file has been merged into the
+user's bookmarks already or not, &kbookmarkmerger; merely looks at the
+filename of the bookmark file - the contents are not checked at all. This means
+that changing a bookmark file which was already merged into a user's bookmarks
+will not trigger merging it once again.</para>
+
+<para>Also note that in case a user modifies a bookmark which was merged into
+his setup, the original bookmark file will be left unmodified.</para>
+</refsect1>
+
+<refsect1>
+<title>Author</title>
+<para>&Frerich.Raabe; &Frerich.Raabe.mail;</para>
+</refsect1>
+</refentry>
+
diff --git a/doc/konqueror/parts.png b/doc/konqueror/parts.png
new file mode 100644
index 000000000..1439d0b89
--- /dev/null
+++ b/doc/konqueror/parts.png
Binary files differ
diff --git a/doc/konqueror/path-complete.docbook b/doc/konqueror/path-complete.docbook
new file mode 100644
index 000000000..a05f0845c
--- /dev/null
+++ b/doc/konqueror/path-complete.docbook
@@ -0,0 +1,82 @@
+<chapter id="path-complete">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-11-05</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+
+<title>Automatic Text Completion</title>
+
+<para>You can get &konqueror; to help you enter a path or &URL; into the
+Location Toolbar by enabling one of the <guimenuitem>Text Completion</guimenuitem>
+features. To do this <mousebutton>right</mousebutton>
+ click on a clear part of the Location Toolbar text entry box and select
+<guisubmenu>Text Completion</guisubmenu> from the pop up menu. This will let you
+choose between the following options:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>None</guimenuitem></term>
+<listitem><para>What you get is what you type.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Manual</guimenuitem></term>
+<listitem><para>When you have typed part of a path or &URL;, pressing
+<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> will complete the entry if it is
+possible to do so unambiguously.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Automatic</guimenuitem></term>
+<listitem><para>As you type into the Location Toolbar window &konqueror; will
+automatically extend what you type to complete one possible path or &URL;,
+highlighting the characters it has added. Continue typing if that's not what
+you wanted or press &Enter; to accept it.</para></listitem>
+ </varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Dropdown List</guimenuitem></term>
+<listitem><para>A drop-down window will appear as you type, showing the
+possible matches to what you have typed so far. When the path or &URL; that
+you want appears in the window double click on it with the &LMB;.
+You can also use the
+<keysym>Down Arrow</keysym> and <keysym>Up Arrow</keysym>
+keys to select it then press &Enter;.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Short Automatic</guimenuitem></term>
+<listitem><para>This is like Automatic mode except that it only extends
+what you have typed as far as the next <keycap>/</keycap> symbol in the path
+or &URL;. Press <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> to accept the
+suggestion, &Enter; when the complete path or &URL; is
+shown.</para></listitem>
+</varlistentry>
+
+</variablelist>
+<para>You should try out these different modes and pick the one that suits you
+ best.</para>
+<para>The history of recently visited &URL;s that &konqueror; uses for the
+Text Completion function can be viewed and edited in the <guilabel>History
+</guilabel> page of the <link linkend="sidebar">Navigation Panel</link>.</para>
+
+
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/plugins.docbook b/doc/konqueror/plugins.docbook
new file mode 100644
index 000000000..83ca89075
--- /dev/null
+++ b/doc/konqueror/plugins.docbook
@@ -0,0 +1,162 @@
+<chapter id="plugins">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-09-22</date>
+<releaseinfo>3.1</releaseinfo>
+</chapterinfo>
+
+
+<title>Plugins</title>
+
+<sect1 id="netscape-plugin">
+<title>&Netscape; Plugins</title>
+
+<para>Currently, &konqueror; supports &Netscape; 4.x plugins.</para>
+
+<para>Selecting <menuchoice><guimenu>Settings</guimenu><guisubmenu>
+Configure Konqueror...</guisubmenu><guimenuitem>Plugins</guimenuitem>
+</menuchoice> will give you a dialog box with two tabbed pages;
+<guilabel>Scan</guilabel> and <guilabel>Plugins</guilabel>.</para>
+
+<para>The <guilabel>Scan</guilabel> page controls how &kde; scans 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 folders listed in the
+<guilabel>Scan Folders</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>
+folder to make other applications aware of them.</para>
+
+<para>The <guilabel>Plugins</guilabel> 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 recognize them.</para>
+
+<para>The dialog box also contains a checkbox <guilabel>
+Enable plugins globally</guilabel> which you can use to enable or disable
+plugins that can be contained in <acronym>HTML</acronym> pages (these can
+be considered a security risk).</para>
+
+</sect1>
+
+<sect1 id="konq-plugin">
+<title>&konqueror; Plugins</title>
+
+<para>The package kdeaddons contains several useful plugins that interact with
+&konqueror; in various ways. These are explained briefly below, more detailed
+information may be obtained by looking through the <guimenuitem>Konqueror
+Plugins</guimenuitem> section in the &kde; Help Center.</para>
+
+<variablelist>
+
+<varlistentry>
+<term>Web Page Translation</term>
+<listitem><para>This uses AltaVista's BabelFish site to translate the current
+<acronym>HTML</acronym> page to whatever language you want (within reason). It
+can be launched with <menuchoice><guimenu>Tools</guimenu><guisubmenu>Translate
+Web Page</guisubmenu></menuchoice>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Folder View Filter</term>
+<listitem><para>This is controlled by
+<menuchoice><guimenu>Tools</guimenu><guisubmenu>View
+Filter</guisubmenu></menuchoice> and allows you to choose which types of item
+are displayed in a folder.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>DOM Tree Viewer</term>
+<listitem><para>Selecting <menuchoice><guimenu>Tools</guimenu><guisubmenu>Show
+DOM Tree</guisubmenu></menuchoice> opens a new window which displays the
+document object model (DOM) of the current <acronym>HTML</acronym>
+page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>HTML Validator</term>
+<listitem><para>This is started with
+<menuchoice><guimenu>Tools</guimenu><guisubmenu>Validate Web
+Page</guisubmenu><guimenuitem>Validate HTML</guimenuitem></menuchoice>. It
+uses the W3C HTML validator to validate the current page, very useful when
+creating web pages.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>CSS Validator</term>
+<listitem><para>Started with
+<menuchoice><guimenu>Tools</guimenu><guisubmenu>Validate Web
+Page</guisubmenu><guimenuitem>Validate CSS</guimenuitem></menuchoice>, it uses
+the W3C CSS validator to validate the current page's Cascading Style
+Sheets.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>HTML Settings</term>
+<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>HTML
+Settings</guisubmenu></menuchoice> to enable or disable a number of HTML
+settings without going through the <guimenu>Settings</guimenu> dialog.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Image Gallery</term>
+<listitem><para>In File Manager mode, you can select
+<menuchoice><guimenu>Tools</guimenu><guisubmenu>Create Image
+Gallery</guisubmenu></menuchoice> to create an HTML page with
+thumbnails of all the images in the current folder. By default the HTML page
+is called <filename>images.html</filename> and the thumbnails are put into a
+new <filename>thumbs</filename> folder.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>User Agent Changer</term>
+<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>Change
+Browser Identification</guisubmenu></menuchoice> to get a menu that allows
+you to change the User Agent string without going through the <guimenu>Settings
+</guimenu> dialog procedure.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Archive Web Page</term>
+<listitem><para>Invoked with <menuchoice><guimenu>Tools</guimenu><guisubmenu>
+Archive Web Page</guisubmenu></menuchoice>, this tool creates an archive
+(<literal role="extension">.war</literal> ) file containing the web page being
+viewed including the images. <mousebutton>Left</mousebutton> click on the
+archive file name to view the saved page.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Navigation Panel Media Player</term>
+<listitem><para>This is a simple media player, embedded as a tab page in the
+Navigation Panel. You can drag songs or videos onto this page to play them.
+</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+
+
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/save-settings.docbook b/doc/konqueror/save-settings.docbook
new file mode 100644
index 000000000..9fb248815
--- /dev/null
+++ b/doc/konqueror/save-settings.docbook
@@ -0,0 +1,92 @@
+<chapter id="save-settings">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2003-11-06</date>
+<releaseinfo>3.2</releaseinfo>
+</chapterinfo>
+
+<title>Saving Settings &amp; Profiles</title>
+<sect1 id="save-settings-general">
+<title>General Settings</title>
+<para>When you close down &konqueror; 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 not automatically saved as the default
+options; however, you can have &konqueror; remember these settings by
+selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>Save View
+Profile "Web Browsing"...</guimenuitem></menuchoice> and the current
+setting will become the default option to be used the next time
+&konqueror; is started.</para>
+
+<para>But you can also specify different <guimenu>View</guimenu> menu settings
+for an individual folder. To do this check the <guimenuitem>View Properties
+Saved in Folder</guimenuitem> box in the <guimenu>Settings</guimenu> menu,
+change the <guimenu>View</guimenu> settings to whatever you want then uncheck
+the
+<guimenuitem>View Properties saved in Folder</guimenuitem> box. Doing this
+creates a <filename>.directory</filename> file in that folder to hold the
+folder <guimenu>View</guimenu> settings. Use the <menuchoice><guimenu>
+Settings</guimenu><guimenuitem>Remove Folder Properties</guimenuitem>
+</menuchoice> option to remove the folder specific
+settings (or just delete the <filename>.directory</filename> file).</para>
+<note><para>One nice use of this feature is if you have a folder full of
+pictures. You can set that particular folder to display thumbnails of the
+pictures (by choosing <guimenuitem>Icon View</guimenuitem> and <menuchoice>
+<guisubmenu>Preview</guisubmenu><guimenuitem>Show Previews</guimenuitem>
+</menuchoice> from the <guimenu>View</guimenu> menu) when you open it, while
+not displaying images as thumbnails in other folders.</para></note>
+</sect1>
+
+<sect1 id="save-settings-view-profiles">
+<title>View Profiles</title>
+<para>&konqueror; can save a whole set of options as a <quote>View
+Profile</quote>. Some view profiles are part of the standard &konqueror;
+installation, such as <property>Web Browsing</property> and <property>File
+Management</property>, but you can add your own, too.</para>
+
+<para>To modify a view profile (say, the <property>Web Browsing</property>
+profile), load the profile with
+<menuchoice><guimenu>Settings</guimenu><guisubmenu>Load View
+Profile</guisubmenu><guimenuitem>Web Browsing</guimenuitem> </menuchoice>, and
+change the &konqueror; settings to whatever you want. Now select
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Save View Profile "Web
+Browsing"...</guimenuitem></menuchoice>. In the dialog which appears, you can
+change the name of the profile, which will create a new profile with that name,
+or you can leave the name as it is to modify the current profile. If you select
+<guilabel>Save URLs in profile</guilabel>, the current &URL; will be loaded
+when you load that view profile. This functions in a similar way to the
+<quote>Home Page</quote> in many web browsers. 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>
+
+<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 <mousebutton>right</mousebutton> 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</filename> and pick a more
+suitable icon.</para></note>
+
+</sect1>
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->
diff --git a/doc/konqueror/shortcut1.png b/doc/konqueror/shortcut1.png
new file mode 100644
index 000000000..4d7a77c30
--- /dev/null
+++ b/doc/konqueror/shortcut1.png
Binary files differ
diff --git a/doc/konqueror/shortcut2.png b/doc/konqueror/shortcut2.png
new file mode 100644
index 000000000..7c461b417
--- /dev/null
+++ b/doc/konqueror/shortcut2.png
Binary files differ
diff --git a/doc/konqueror/sidebar.docbook b/doc/konqueror/sidebar.docbook
new file mode 100644
index 000000000..9ba4cb923
--- /dev/null
+++ b/doc/konqueror/sidebar.docbook
@@ -0,0 +1,201 @@
+<chapter id="sidebar">
+
+<chapterinfo>
+<authorgroup>
+<author>&Pamela.Roberts;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2002-09-22</date>
+<releaseinfo>3.1</releaseinfo>
+</chapterinfo>
+
+<title>The Navigation Panel</title>
+
+<para>The Navigation Panel appears as a separate view at the left of
+&konqueror;'s window. It can be invoked with <menuchoice><guimenu>Window
+</guimenu><guimenuitem>Show Navigation Panel</guimenuitem></menuchoice> or
+toggled on and off with the <keycap>F9</keycap> key.</para>
+
+<mediaobject>
+<imageobject><imagedata format="PNG" fileref="dirtree.png"/></imageobject>
+<textobject>
+<phrase>With the Navigation Panel</phrase>
+</textobject>
+</mediaobject>
+
+<para>It contains a number of tabbed pages; <mousebutton>left</mousebutton>
+click on a tab's icon to view that page. <mousebutton>Left</mousebutton>
+clicking on the icon for the visible page will collapse the Navigation Panel
+so that only the tab icons are visible.</para>
+<variablelist>
+
+<varlistentry>
+<term><guilabel>Bookmarks</guilabel></term>
+<listitem><para>This page shows a tree view of your Bookmarks. <mousebutton>
+Left</mousebutton> click on an item to open it in the main view.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>History</guilabel></term>
+<listitem><para>This page shows a tree view of your browsing History.
+<mousebutton>Left</mousebutton> clicking on an item will open it in the main
+view, or you can open it in a new &konqueror; window by <mousebutton>right
+</mousebutton> clicking and selecting <guimenuitem>New Window</guimenuitem>
+from the pop up menu.</para>
+<para>You can remove an item from the history by <mousebutton>right
+</mousebutton> clicking on it and selecting <guimenuitem>Remove Entry
+</guimenuitem>. Selecting <guimenuitem>Clear History...</guimenuitem> will
+clear out the entire history.</para>
+<para>The pop up menu you get when you <mousebutton>right</mousebutton> click
+on any entry in the History page also gives you the option of choosing
+whether the entire history is sorted by name or by date.</para>
+<para>Selecting <guimenuitem>Preferences...</guimenuitem> from this pop up
+menu brings up the <guilabel>History Sidebar</guilabel> control module. This
+can be used to set the maximum size of your history and set a time after which
+items are automatically removed. You can also set different fonts for new and
+old &URL;s.
+The <guilabel>Detailed tooltips</guilabel> checkbox controls how much
+information is displayed when you hover the mouse pointer over an item in the
+history page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Home Folder</guilabel></term>
+<listitem><para>This page shows a tree view of the subfolders your home
+folder. Note that <quote>hidden</quote> folders (those with names
+beginning with a dot) are not shown.
+<mousebutton>Left</mousebutton> click on an item to open it in the
+main view, or <mousebutton>right</mousebutton> click to display a pop up
+menu allowing you to open the subfolder in a new window or as a new tab
+page of the main view.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Network</guilabel></term>
+<listitem><para>This page is intended to show a tree view of your important
+network connections, although local folders can also be included. Again,
+you can <mousebutton>left</mousebutton> click on an item to open it in the
+main view or <mousebutton>right</mousebutton> click to bring up a menu with
+a wider range of possibilities.</para>
+<para>The folders shown in the <guilabel>Network</guilabel> page are held in
+the folder <filename class="directory">
+~/.kde/share/apps/konqsidebartng/virtual_folders/remote/</filename>, and you can make
+new ones just as you would make any other subfolder. The items within
+these folders are held as <literal role="extension">.desktop</literal> files
+and can be created with &konqueror;'s <menuchoice><guisubmenu>Create New</guisubmenu>
+<guimenuitem>Link to Location (URL)...</guimenuitem></menuchoice> option.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Root Folder</guilabel></term>
+<listitem><para>The Root Folder tree has the path <filename
+class="directory">/</filename>, and is the base folder of your system's
+local files. If you expand the <quote>Root</quote> folder you will find
+another folder called <filename class="directory">root</filename>. This
+belongs to the system administrator or Super User and is her home folder.
+You will also find a folder called
+<filename class="directory">home</filename>, in which you should be able to
+find your own <quote>Home</quote> folder again.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Services</guilabel></term>
+<listitem><para>This page provides quick access to the following services:
+</para>
+<para>The <guilabel>Audio CD Browser</guilabel>.</para>
+<para><guilabel>Devices</guilabel>. This shows your hard disc
+partitions, floppy and &CD-ROM;. <mousebutton>Left</mousebutton> click on
+a device or partition name to mount it and display its contents in the main
+view. A mounted device or partition can be unmounted by <mousebutton>right
+</mousebutton> clicking on the device name and selecting <guimenuitem>Unmount
+</guimenuitem> from the pop up menu.
+</para>
+<para>The <guilabel>LAN Browser</guilabel> allows you to browse other
+machines connected to your Local Area Network.</para>
+<para>The <guilabel>Print System Browser</guilabel> tree gives you quick
+access to &kde;'s print manager <application>Kprinter</application>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>The Navigation Panel configuration can be changed by <mousebutton>right
+</mousebutton> clicking on the empty area below the bottom tab icon or by
+<mousebutton>left</mousebutton> clicking on the <guilabel>Configuration
+Button</guilabel> icon (the top icon in the previous screenshot, it may not
+be present in your setup). Doing this brings up a menu with the following
+options:</para>
+<variablelist>
+
+<varlistentry>
+<term><guisubmenu>Add New</guisubmenu></term>
+<listitem><para>This option lets you add a new tab page to the Navigation
+Panel. The new page can contain the <guimenuitem>Sidebar Media Player
+</guimenuitem> (a <link linkend="konq-plugin">&konqueror; Plugin</link>
+feature) or a new
+<guimenuitem>Folder</guimenuitem> tree view.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Multiple Views</guimenuitem></term>
+<listitem><para>Selecting this option splits the Navigation Panel so that
+two tab pages can be seen at once.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Show Tabs Left</guimenuitem></term>
+<listitem><para>This option lets you choose whether the tab icons are shown at
+the left or right of the Navigation Panel.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Show Configuration Button</guimenuitem></term>
+<listitem><para>Use this option to show or hide the <guilabel>Configuration
+Button</guilabel> icon.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<para><mousebutton>Right</mousebutton> clicking on a tab icon brings up a
+menu with the following options:</para>
+
+<variablelist>
+<varlistentry>
+<term><guimenuitem>Set URL</guimenuitem></term>
+<listitem><para>Only available for folder pages, this option lets you
+change the &URL; (path) of the folder viewed in that page.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Set Icon</guimenuitem></term>
+<listitem><para>To change the tab icon.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Remove</guimenuitem></term>
+<listitem><para>To remove the tab page from the Navigation Panel.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+
+</chapter>
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+sgml-parent-document:("index.docbook" "book" "chapter")
+End:
+-->