Fix #624: Filter files by shell or regular expression pattern
[geeqie.git] / doc / docbook / GuideMainWindowFilePane.xml
index fc86303..98b2493 100644 (file)
     </para>\r
     <para />\r
   </section>\r
+  <section id="Filefilter">\r
+    <title id="titleFilefilter">File Filter</title>\r
+    <para>\r
+      A filter box can be opened by selecting\r
+      <emphasis role="bold">Show File Filter</emphasis>\r
+      from the View menu.\r
+    </para>\r
+    <para>\r
+      Characters you type into this box will be used for pattern matching to select the files displayed.\r
+      <link linkend="GuideReferencePCRE">Regular expressions</link>\r
+      are used in this field.\r
+      <para />\r
+      For basic pattern matching "JPG" will match any filename containing those characters.\r
+      <para />\r
+      To make a case-insensitive search, use "(?i)JPG"\r
+      <para />\r
+      If you type a newline, the text will be saved in the dropdown box list. The last 10 items are saved.\r
+    </para>\r
+    <para />\r
+  </section>\r
   <section id="Multipleselection">\r
     <title>Multiple selection</title>\r
     <para>It is possible to select more than one image from the file pane. Multiple files can be selected with several methods:</para>\r