src/help/SearchHelp.html

   1 <html xmlns="http://www.w3.org/1999/xhtml">
   2
   3 <body text="#275856">
   4     <basefont size="4"
   5           color="#2F4958"
   6           face="arial" />
   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>