summaryrefslogtreecommitdiffstats
path: root/doc/en/locate.docbook
blob: f92070761714cc044763a1b887711ad65db03d6e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
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>