Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 82 insertions, 0 deletions

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:
+-->