doc/handbook/locate.docbook

0001 <!--
0002     SPDX-FileCopyrightText: 2000-2003 Shie Erlich <erlich@users.sourceforge.net>
0003     SPDX-FileCopyrightText: 2000-2003 Rafi Yanai <yanai@users.sourceforge.net>
0004     SPDX-FileCopyrightText: 2004-2010 Frank Schoolmeesters <codeknight@users.sourceforge.net>
0005     SPDX-FileCopyrightText: 2000-2022 Krusader Krew <https://krusader.org>
0006 -->
0007 <sect1 id="locate">
0008   <title>Locate &GUI; Frontend</title>
0009   <indexterm>
0010     <primary>Locate</primary>
0011   </indexterm>
0012   <para>&krusader; has a &GUI; front end for
0013   the
0014   <command>locate</command> command (findutils). Locate is used for
0015   fast file searching not from a folder but a database. The
0016   package contains among other files,
0017   <command>locate</command> and
0018   <command>updatedb</command>. <command>updatedb</command> goes through the local
0019   file system and stores the file entries in the database.
0020   <command>cron</command> often calls
0021   <command>updatedb</command> every night (set with <application>KCron</application>). Choose
0022     <menuchoice>
0023       <guimenu>Tools</guimenu>
0024       <guimenuitem>Locate...</guimenuitem>
0025     </menuchoice>
0026   or
0027   <keycombo action="simul">&Ctrl;&Shift;
0028   <keycap>L</keycap></keycombo> to start this feature.
0029   <link linkend="konfig-advanced">Konfigurator</link> can set
0030   additional arguments for
0031   <command>updatedb</command>.</para>
0032   <para>Checkbox Options
0033   <itemizedlist>
0034     <listitem>
0035       <para>
0036       <guilabel>Show only the existing files</guilabel>: if the
0037       database contains entries which no longer exist any more
0038       (deleted, moved since the last
0039       <command>updatedb</command>),
0040       <command>locate</command> does not list them. It checks the
0041       existence of each file before the listing in the results
0042       window (slow).</para>
0043     </listitem>
0044     <listitem>
0045       <para>
0046       <guilabel>Case Sensitive</guilabel>: unchecking it allows
0047       lower and upper case search.</para>
0048     </listitem>
0049   </itemizedlist></para>
0050   <para>Action buttons
0051   <itemizedlist>
0052     <listitem>
0053       <para>
0054       <guibutton>Locate</guibutton>: executes
0055       <command>locate
0056       <replaceable>foo foo</replaceable></command> and places its
0057       output into the results window.</para>
0058     </listitem>
0059     <listitem>
0060       <para>
0061       <guibutton>Stop</guibutton>: stops the locating
0062       process.</para>
0063     </listitem>
0064     <listitem>
0065       <para>
0066       <guibutton>UpdateDB</guibutton>: starts
0067       <command>updatedb</command> for updating the locate database
0068       after entering the root password.</para>
0069     </listitem>
0070     <listitem>
0071       <para>
0072       <guibutton>Close</guibutton>: closes the locate
0073       window.</para>
0074     </listitem>
0075   </itemizedlist></para>
0076   <para>Results window
0077   <itemizedlist>
0078     <listitem>
0079       <para>Double-click on an item: steps to its folder, makes
0080       the item visible and closes the locate dialog.</para>
0081     </listitem>
0082     <listitem>
0083       <para>Right click: edits/views/finds the menu.
0084       <itemizedlist>
0085         <listitem>
0086           <para>
0087           <keycap>F3</keycap>: views the current item.</para>
0088         </listitem>
0089         <listitem>
0090           <para>
0091           <keycap>F4</keycap>: edits the current item.</para>
0092         </listitem>
0093         <listitem>
0094           <para>
0095           <keycombo action="simul">&Ctrl;
0096           <keycap>F</keycap></keycombo>: finds files in the results
0097           window.</para>
0098         </listitem>
0099         <listitem>
0100           <para>
0101           <keycombo action="simul">&Ctrl;
0102           <keycap>N</keycap></keycombo>: shows the next search
0103           result.</para>
0104         </listitem>
0105         <listitem>
0106           <para>
0107           <keycombo action="simul">&Ctrl;
0108           <keycap>P</keycap></keycombo>: shows the previous search
0109           result.</para>
0110         </listitem>
0111       </itemizedlist></para>
0112     </listitem>
0113         <listitem>
0114           <para>
0115           The results window supports dragging items to other windows
0116           and copy to clipboard (<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>).</para>
0117         </listitem>
0118   </itemizedlist></para>
0119 </sect1>