[gnome-user-docs] g-h/files-select: Topic for wildcard selections

[Shaun McCance <shaunm src gnome org>]

commit c1f676d81d71e267d6f0e59038e0ac97e3940424
Author: Shaun McCance <shaunm gnome org>
Date:   Sun Mar 27 17:08:12 2011 -0400

    g-h/files-select: Topic for wildcard selections

 gnome-help/C/files-select.page |   46 ++++++++++++++++++++++++++++++++++++++++
 gnome-help/Makefile.am         |    1 +
 2 files changed, 47 insertions(+), 0 deletions(-)
---
diff --git a/gnome-help/C/files-select.page b/gnome-help/C/files-select.page
new file mode 100644
index 0000000..a57d060
--- /dev/null
+++ b/gnome-help/C/files-select.page
@@ -0,0 +1,46 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="files-select">
+  <info>
+    <link type="guide" xref="files#faq"/>
+    <revision pkgversion="3.0" date="2011-03-27" status="review"/>
+
+    <credit type="author">
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
+    </credit>
+
+    <desc>Select files in a folder matching a shell glob pattern.</desc>
+  </info>
+
+  <title>Select files by pattern</title>
+
+  <p>You can select files in a folder using a pattern on the filename.
+  Press <keyseq><key>Ctrl</key><key>S</key></keyseq> to bring up the
+  <gui>Select Items Matching</gui> window. Type in a pattern using
+  common parts of the filenames plus wild card characters. There are
+  two wildcard characters available:</p>
+
+  <list style="compact">
+    <item><p><file>*</file> matches any number of any characters, even
+    no characters at all.</p></item>
+    <item><p><file>?</file> matches exactly one of any character.</p></item>
+  </list>
+
+  <p>For example:</p>
+
+  <list>
+    <item><p>If you have an OpenDocument Text file, a PDF file, and an
+    image that all have the same base name <file>Invoice</file>, select
+    all three with the pattern</p>
+    <example><p><file>Invoice.*</file></p></example></item>
+    <item><p>If you have some photos that are named like <file>Vacation-001.jpg</file>,
+    <file>Vacation-002.jpg</file>, <file>Vacation-003.jpg</file>; select them all
+    with the pattern</p>
+    <example><p><file>Vacation-???.jpg</file></p></example></item>
+    <item><p>If you have photos as before, but you've edited some of them and
+    added <file>-edited</file> to the end of the filename of the photos you've
+    edited, select the edited photos with</p>
+    <example><p><file>Vacation-???-edited.jpg</file></p></example></item>
+  </list>
+</page>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 5fecc80..c580ea2 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -73,6 +73,7 @@ DOC_PAGES = \
 	files-removedrive.page \
 	files-renaming.page \
 	files-search.page \
+	files-select.page \
 	files-sharing.page \
 	files-sort.page \
 	files-special.page \