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