39ae96c9804fcd127625f5b526e07331e6a2be53
[debian/jabref.git] / src / help / SearchHelp.html
1 <HTML>
2
3 <BODY text="#275856">
4 <basefont size="4" color="#2F4958" face="arial">
5
6 <H1>Searching</H1>
7
8
9 There are three different search modes in JabRef.
10
11 <p>
12 <em>CTRL-F</em> opens or focuses the search interface. Pressing
13 <em>CTRL-F</em> several times toggles search mode. When searching
14 incrementally, pressing <em>CTRL-F</em> makes the program search for
15 the next occurence of the search string.
16 <p>
17 <em>CTRL-SHIFT-F</em> opens or focuses the search interface, and
18 selects incremental search. When searching incrementally,
19 <em>CTRL-SHIFT-F</em> also finds the next occurence of the search
20 string.
21
22 <H2>Incremental search</H2>
23
24 When searching incrementally, the program searches immediately each
25 time you press a letter. The status line informs you about the success
26 of the search. Pressing the search shortcut keys causes the program to
27 find the next occurence of the current search string. If no further
28 occurences can be found, the status line will notify you about
29 this. Repeating the search again causes the search to restart at the
30 top. The search order always follows the current sorting of your
31 database. To escape an incremental search, press ESC or click "Clear
32 search".
33
34 <H2>Normal</H2>
35
36 In a normal search, the program searches your database for all occurences of your
37 search string, once you press ENTER. All entries that don't match are hidden, leaving for display the matching entries only.
38 To stop displaying the search results, press ESC or click "Clear search".
39
40 <a name="advanced"><H2>Field specification, logical operators</H2>
41
42 In order to search specific fields only and/or include logical operators in the search expression, a special syntax is available in which these can be specified. E.g. to search for entries whose author is "Miller", enter (in any but incremental search mode):
43 <p>
44 author = miller
45 <p>
46 Both the field specification and the search term support regular expressions. If the search term contains spaces, enclose it in quotes. Do <i>not</i> use spaces in the field specification! E.g. to search for entries about image processing, type:
47 <p>
48 title|keywords = "image processing"
49 <p>
50 You can use "and", "or", "not", and braces as intuitively expected:
51 <p>
52 (author = miller or title|keywords = "image processing") and not author = brown
53 <p>
54 The "=" sign is actually a shorthand for "contains". Searching for an exact match is possible using "matches" or "==". Using "!=" tests if the search term is <i>not</i> contained in the field (equivalent to "not ... contains ..."). The selection of field types to search (required, optional, all) is always overruled by the field specification in the search expression. To search for entries of a certain type, a pseudo field called "entrytype" is available:
55 <p>
56 entrytype = thesis
57 <p>
58 This finds entries whose type (as displayed in the "Entrytype" column) contains the word "thesis" (which would be "phdthesis" and "mastersthesis"). Another pseudo field "bibtexkey" allows to search for citation keys, e.g.
59 <p>
60 bibtexkey = miller2005
61
62 <H2>Search settings</H2>
63
64  The <em>Settings</em> button opens a menu that allows to toggle case sensitivity and use of regular expressions in the search, and whether search results should be selected in the table. 
65
66 </BODY>
67 </HTML>