[svn-upgrade] Integrating new upstream version, jabref (2.5~beta1)
[debian/jabref.git] / src / help / SearchHelp.html
1 <html xmlns="http://www.w3.org/1999/xhtml">
2
3 <body text="#275856">
4     <basefont size="4" color="#2F4958" face="arial" />
5
6     <h1>Searching</h1>
7
8     <p>There are three different search modes in JabRef.</p>
9
10     <p><em>CTRL-F</em> opens or focuses the search interface.
11     Pressing <em>CTRL-F</em> several times toggles search mode.
12     When searching incrementally, pressing <em>CTRL-F</em> makes
13     the program search for the next occurence of the search
14     string.</p>
15
16     <p><em>CTRL-SHIFT-F</em> opens or focuses the search interface,
17     and selects incremental search. When searching incrementally,
18     <em>CTRL-SHIFT-F</em> also finds the next occurence of the
19     search string.</p>
20
21     <h2>Incremental search</h2>
22
23     <p>When searching incrementally, the
24     program searches immediately each time you press a letter. The
25     status line informs you about the success of the search.
26     Pressing the search shortcut keys causes the program to find
27     the next occurrence of the current search string. If no further
28     occurrences can be found, the status line will notify you about
29     this. Repeating the search again causes the search to restart
30     at the top. The search order always follows the current sorting
31     of your database. To escape an incremental search, press ESC or
32     click "Clear search".</p>
33
34     <h2>Normal</h2>
35
36     <p>In a normal search, the program searches your
37     database for all occurences of the words in your search string,
38     once you press ENTER. Only entries containing all words will be
39     considered matches. To search for sequences of words, enclose
40     the sequences in double quotes. For instance, the query
41     <b>progress "marine aquaculture"</b> will match entries
42     containing both the word "progress" and the phrase "marine
43     aquaculture". All entries that don't match are hidden, leaving
44     for display the matching entries only (filter mode), or are
45     grayed-out (float mode). To stop displaying the search results,
46     press ESC or click "Clear search".</p>
47
48     <h2><a name="advanced"
49        id="advanced">Field specification, logical
50        operators</a></h2>
51
52        <p>In order to search specific fields only
53        and/or include logical operators in the search expression, a
54        special syntax is available in which these can be specified.
55        E.g. to search for entries whose author is "Miller", enter
56        (in any but incremental search mode):</p>
57
58     <p>author = miller</p>
59
60     <p>Both the field specification and the search term support
61     regular expressions. If the search term contains spaces,
62     enclose it in quotes. Do <i>not</i> use spaces in the field
63     specification! E.g. to search for entries about image
64     processing, type:</p>
65
66     <p>title|keywords = "image processing"</p>
67
68     <p>You can use "and", "or", "not", and braces as intuitively
69     expected:</p>
70
71     <p>(author = miller or title|keywords = "image processing") and
72     not author = brown</p>
73
74     <p>The "=" sign is actually a shorthand for "contains".
75     Searching for an exact match is possible using "matches" or
76     "==". Using "!=" tests if the search term is <i>not</i>
77     contained in the field (equivalent to "not ... contains ...").
78     The selection of field types to search (required, optional,
79     all) is always overruled by the field specification in the
80     search expression. To search for entries of a certain type, a
81     pseudo field called "entrytype" is available:</p>
82
83     <p>entrytype = thesis</p>
84
85     <p>This finds entries whose type (as displayed in the
86     "Entrytype" column) contains the word "thesis" (which would be
87     "phdthesis" and "mastersthesis"). Another pseudo field
88     "bibtexkey" allows to search for citation keys, e.g.</p>
89
90     <p>bibtexkey = miller2005</p>
91
92     <h2>Search settings</h2>
93
94     <p>The <em>Settings</em> button opens a
95     menu that allows to toggle case sensitivity and use of regular
96     expressions in the search, and whether search results should be
97     selected in the table.</p>
98 </body>
99 </html>