1 files changed, 114 insertions, 0 deletions
diff --git a/doc/en/locate.docbook b/doc/en/locate.docbook
new file mode 100644
index 0000000..f920707
--- /dev/null
+++ b/doc/en/locate.docbook
@@ -0,0 +1,114 @@
+<sect1 id="locate">
+  <title>Locate &GUI; Frontend</title>
+  <indexterm>
+    <primary>Locate</primary>
+  </indexterm>
+  <para>&krusader; has a &GUI; front end for
+  the 
+  <command>locate</command> command (findutils). Locate is used for
+  fast file searching not from a directory but a database. The
+  package contains two files, 
+  <command>locate</command> and 
+  <command>updatedb</command>. Updatedb goes through the local
+  file system and stores the file entries in the database. 
+  <command>cron</command> often calls 
+  <command>updatedb</command> every night (set with Kcron). Choose 
+  <emphasis role="bold">
+    <menuchoice>
+      <guimenu>Commands</guimenu>
+      <guimenuitem>Locate</guimenuitem>
+    </menuchoice>
+  </emphasis>or 
+  <keycombo action="simul">&Ctrl;
+  <keycap>L</keycap></keycombo> to start this feature. 
+  <link linkend="konfig-advanced">Konfigurator</link> can set
+  additional arguments for 
+  <command>updatedb</command>.</para>
+  <para>Checkbox Options 
+  <itemizedlist>
+    <listitem>
+      <para>
+      <guilabel>Show only the existing files</guilabel>: if the
+      database contains entries which no longer exist any more
+      (deleted, moved since the last 
+      <command>updatedb</command>), 
+      <command>locate</command> does not list them. It checks the
+      existence of each file before the listing in the results
+      window (slow).</para>
+    </listitem>
+    <listitem>
+      <para>
+      <guilabel>Case Sensitive</guilabel>: unchecking it allows
+      lower and upper case search.</para>
+    </listitem>
+  </itemizedlist></para>
+  <para>Action buttons 
+  <itemizedlist>
+    <listitem>
+      <para>
+      <guibutton>Locate</guibutton>: executes 
+      <command>locate 
+      <replaceable>foo foo</replaceable></command> and places its
+      output into the results window.</para>
+    </listitem>
+    <listitem>
+      <para>
+      <guibutton>Stop</guibutton>: stops the locating
+      process.</para>
+    </listitem>
+    <listitem>
+      <para>
+      <guibutton>UpdateDB</guibutton>: starts 
+      <command>updatedb</command> for updating the locate database
+      after entering the root password.</para>
+    </listitem>
+    <listitem>
+      <para>
+      <guibutton>Close</guibutton>: closes the locate
+      window.</para>
+    </listitem>
+  </itemizedlist></para>
+  <para>Results window 
+  <itemizedlist>
+    <listitem>
+      <para>Double-click on an item: steps to its directory, makes
+      the item visible and closes the locate dialog.</para>
+    </listitem>
+    <listitem>
+      <para>Right click: edits/views/finds the menu. 
+      <itemizedlist>
+        <listitem>
+          <para>
+          <keycap>F3</keycap>: views the current item.</para>
+        </listitem>
+        <listitem>
+          <para>
+          <keycap>F4</keycap>: edits the current item.</para>
+        </listitem>
+        <listitem>
+          <para>
+          <keycombo action="simul">&Ctrl;
+          <keycap>f</keycap></keycombo>: finds files in the results
+          window.</para>
+        </listitem>
+        <listitem>
+          <para>
+          <keycombo action="simul">&Ctrl;
+          <keycap>n</keycap></keycombo>: shows the next search
+          result.</para>
+        </listitem>
+        <listitem>
+          <para>
+          <keycombo action="simul">&Ctrl;
+          <keycap>p</keycap></keycombo>: shows the previous search
+          result.</para>
+        </listitem>
+      </itemizedlist></para>
+    </listitem>
+        <listitem>
+          <para>
+          The results window supports dragging items to other windows 
+          and copy to clipboard (<keycombo action="simul">&Ctrl;<keycap>c</keycap></keycombo>).</para>
+        </listitem>
+  </itemizedlist></para>
+</sect1>