[gthumb] added filtering documentation

[Michael J. Chudobiak <mjc src gnome org>]

commit 8407f14cfc9b1053763c1988e881267288f7e955
Author: Michael J. Chudobiak <mjc avtechpulse com>
Date:   Fri Jun 25 13:19:50 2010 -0400

    added filtering documentation

 help/C/figures/general-filter.png  |  Bin 0 -> 31813 bytes
 help/C/figures/specific-filter.png |  Bin 0 -> 4963 bytes
 help/C/filtering.page              |   37 ++++++++++++++++++++++++++++++++++++
 help/Makefile.am                   |    7 ++++-
 4 files changed, 42 insertions(+), 2 deletions(-)
---
diff --git a/help/C/figures/general-filter.png b/help/C/figures/general-filter.png
new file mode 100644
index 0000000..10f92b8
Binary files /dev/null and b/help/C/figures/general-filter.png differ
diff --git a/help/C/figures/specific-filter.png b/help/C/figures/specific-filter.png
new file mode 100644
index 0000000..9fc076a
Binary files /dev/null and b/help/C/figures/specific-filter.png differ
diff --git a/help/C/filtering.page b/help/C/filtering.page
new file mode 100644
index 0000000..c3590bc
--- /dev/null
+++ b/help/C/filtering.page
@@ -0,0 +1,37 @@
+<page xmlns="http://projectmallard.org/1.0/"; type="topic"
+id="gthumb-filtering">
+  <info>
+    <link type="guide" xref="index#files" />
+  </info>
+
+  <title>Filtering Files</title>
+
+  <p>You can select what types of files to show in the browser view
+  using the <guiseq><gui>View</gui><gui>Filter</gui></guiseq> dialog.
+  The default is to show all media files (images, movies, audio), but
+  this can be made more or less restrictive.</p>
+
+  <figure>
+    <title>Enabling Filters</title>
+    <media type="image" mime="image/png"
+    src="figures/general-filter.png" />
+  </figure>
+
+  <p>The figure above shows how to configure <app>gThumb</app> to display
+  media files only, by setting the <gui>General Filter</gui>.</p>
+
+  <p>Also, by enabling <gui>Filename</gui> in <gui>Other Filters</gui>,
+  a filter-by-filename ability is added to the filter bar at the bottom of
+  the browser view:</p>
+
+  <figure>
+    <title>Browser Filter Bar</title>
+    <media type="image" mime="image/png"
+    src="figures/specific-filter.png" />
+  </figure>
+
+  <p>In the above figure, the filename filter has been configured to 
+  show only files with "gen" in the filename. The matching is
+  case-insensitive.</p>
+  
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index 09f447c..3c437bd 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -10,7 +10,9 @@ DOC_FIGURES = \
 	figures/nav-button.png \
 	figures/preferences.png \
 	figures/palette.png \
-	figures/thumbnail-pane.png
+	figures/thumbnail-pane.png \
+	figures/general-filter.png \
+	figures/specific-filter.png
 
 DOC_PAGES = \
 	index.page \
@@ -35,7 +37,8 @@ DOC_PAGES = \
 	gimp.page \
 	viewer.page \
 	fullscreen.page \
-	sorting.page
+	sorting.page \
+	filtering.page
 	
 DOC_LINGUAS = de el es fr oc sl sv zh_CN