Merge branch 'develop' into features/JAL-250_hideredundantseqs
[jalview.git] / help / html / features / search.html
index 69f3315..72e5bdf 100755 (executable)
@@ -24,7 +24,7 @@
 <style type="text/css">
 <!--
 td {
-       text-align: center;
+  text-align: center;
 }
 -->
 </style>
@@ -36,8 +36,8 @@ td {
   </p>
   <p>The search box is displayed by pressing Control and F or
     selecting &quot;Find...&quot; from the &quot;Search&quot; menu.</p>
-  <img src="search.gif" width="339" height="110">
-  <p>&quot;Find next&quot; will find the next occurence of the
+  <img src="search.png" width="398" height="124">
+  <p>&quot;Find next&quot; will find the next occurrence of the
     specified and adjust the alignment window view to show it, and
     &quot;Find all&quot; highlights all matches for a pattern. The
     &quot;New Feature&quot; is a quick way to highlight and group
@@ -48,7 +48,10 @@ td {
       of posix and perl style regex - see below for a summary)</li>
     <li>Gaps are ignored when matching the query to the sequences
       in the alignment.</li>
-    <li>The search is applied to both sequences and their IDs.</li>
+    <li>The search is applied to both sequences and their IDs, and
+      optionally also to the description string (<em>since Jalview
+        2.10</em>)
+    </li>
     <li>If a region is selected, then search will <strong>only</strong>
       be performed on that region.
     </li>
@@ -56,6 +59,9 @@ td {
       &quot;Escape&quot; key.</li>
     <li>Tick the &quot;Match Case&quot; box to perform a case
       sensitive search.</li>
+    <li>To access a <a ref="#queryhistory">previously used
+        query</a> press the down arrow or click on the button on the right
+      of the text field.
   </ul>
   <p>
     <strong>Creating Features from Search Results</strong>
@@ -77,7 +83,7 @@ td {
     highlighted region.
   </p>
   <p>
-  
+
     <strong>A quick Regular Expression Guide</strong>
   </p>
   <p>A regular expression is not just a simple text query - although
@@ -142,5 +148,26 @@ td {
         max number of times</td>
     </tr>
   </table>
+  <p>
+    <a name="queryhistory" /><strong>Search History</strong>
+  </p>
+  <p>A record of all the recent queries made via the Find dialog are
+    stored along with your Jalview user preferences. To open the search
+    history, click on the button to the right of the query field, or
+    press the down arrow key.</p>
+  <img src="searchhist.png" width="404" height="185" align="left" />
+  <p>The search history keeps up to 99 queries by default. To clear
+    the history, or modify the size of the history, right-click the text
+    box.</p>
+  <img src="searchclearhist.png" width="402" height="121" align="left" />
+  <p>
+    <strong>Other dialogs that provide a query history</strong>
+  </p>
+  <p>
+    Jalview's <a href="uniprotsequencefetcher.html">Uniprot</a> and <a
+      href="pdbsequencefetcher.html">PDB</a> free text database search
+    dialogs also provide a query history.
+  </p>
+  <em>The query histories were introduced in Jalview 2.10.2</em>
 </body>
 </html>