[gnome-help] searching files and folders: content and pages added.

13 files changed, 370 insertions, 24 deletions

diff --git a/gnome-help/C/Screenshot-Search for Files-options.png b/gnome-help/C/Screenshot-Search for Files-options.png
new file mode 100644
index 0000000..d84151b
--- /dev/null
+++ b/gnome-help/C/Screenshot-Search for Files-options.png
diff --git a/gnome-help/C/Screenshot-Search for Files.png b/gnome-help/C/Screenshot-Search for Files.png
new file mode 100644
index 0000000..eed8be2
--- /dev/null
+++ b/gnome-help/C/Screenshot-Search for Files.png
diff --git a/gnome-help/C/files-lost.page b/gnome-help/C/files-lost.page
deleted file mode 100644
index 45c4cee..0000000
--- a/gnome-help/C/files-lost.page
+++ /dev/null
@@ -1,24 +0,0 @@
-<page xmlns="http://projectmallard.org/1.0/"
-      type="topic" id="files-lost">
-
-  <info>
-    <link type="guide" xref="files#others"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-06-29" status="stub"/>
-    <credit type="author">
-      <name>GNOME Documentation Project</name>
-      <email>gnome-doc-list@gnome.org</email>
-    </credit>
-    
-  </info>
-
-  <title>Finding a lost file</title>
-  
-  <comment>
-   <cite date="2010-06-29" href="mailto:gnome-doc-list@gnome.org">GNOME Documentation Project</cite>
-   <p>Tracker, zeitgeist, recent files, search.</p>
-   <p>Check trash?</p>
-   <p>Might need to be a guide, needs thought.</p>
-  </comment>
-	
-</page>
diff --git a/gnome-help/C/files-search.page b/gnome-help/C/files-search.page
new file mode 100644
index 0000000..53a096a
--- /dev/null
+++ b/gnome-help/C/files-search.page
@@ -0,0 +1,41 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide" id="files-search">
+
+  <info>
+    <link type="guide" xref="index#files-folders"/>
+    <title type='link'>Search for Files</title>
+    <title type='text'>Search for Files</title>
+    <desc>How to find a file.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-09" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+
+  <title><media type="image" src="gnome-searchtool.png">Search for Files logo</media>Search For Files</title>
+  
+  <section id="search" style="2column">
+    <title>Perform a Search</title>
+
+  </section>
+  
+  
+    <section id="advanced" style="2column">
+    <title>Advanced</title>
+
+  </section>
+  
+  <section id="other" style="2column">
+    <title>Other Applications</title>
+
+  </section>
+  <comment>
+   <cite date="2010-06-29" href="mailto:gnome-doc-list@gnome.org">GNOME Documentation Project</cite>
+   <p>Tracker, zeitgeist, recent files, search.</p>
+   <p>Check trash?</p>
+   <p>Might need to be a guide, needs thought.</p>
+  </comment>
+
+</page>
diff --git a/gnome-help/C/gnome-searchtool.png b/gnome-help/C/gnome-searchtool.png
new file mode 100644
index 0000000..bbb6931
--- /dev/null
+++ b/gnome-help/C/gnome-searchtool.png
diff --git a/gnome-help/C/search-commandline.page b/gnome-help/C/search-commandline.page
new file mode 100644
index 0000000..1b07b9b
--- /dev/null
+++ b/gnome-help/C/search-commandline.page
@@ -0,0 +1,31 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" id="search-commandline">
+
+  <info>
+    <link type="guide" xref="files-search#advanced"/>
+    <desc>Use the command line to run <app>Search for Files</app>.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-9" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+
+  <title>Command Line</title>
+  
+  <list>
+    <item><p>
+      Type <cmd>gnome-search-tool</cmd> at the prompt to start the graphical application.
+    </p></item>
+    <item><p>
+      Type <cmd>man gnome-search-tool</cmd> to view the manual pages.
+    </p></item>
+    <item><p>
+      Type <cmd>gnome-search-tool --help</cmd> for command line application options.
+    </p></item>
+    
+  </list>
+  
+  
+</page>
diff --git a/gnome-help/C/search-delete.page b/gnome-help/C/search-delete.page
new file mode 100644
index 0000000..75fb6c7
--- /dev/null
+++ b/gnome-help/C/search-delete.page
@@ -0,0 +1,30 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" id="search-delete">
+
+  <info>
+    <link type="guide" xref="files-search#search"/>
+    <title type="sort">c</title>
+    <desc>Delete file from <gui>Search results</gui> box.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-9" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+
+  <title>Delete a Found File</title>
+    <p>
+      To delete a file in the <gui>Search results</gui> box:
+    </p>
+      <list>
+        <item><p>
+          Click on the file name and press the <key>delete</key>, or
+        </p></item>
+        <item><p>
+          Right click on the file name and select <gui>Move to Trash</gui>.
+        </p></item>
+      </list>
+  
+  
+</page>
diff --git a/gnome-help/C/search-intro.page b/gnome-help/C/search-intro.page
new file mode 100644
index 0000000..74587fc
--- /dev/null
+++ b/gnome-help/C/search-intro.page
@@ -0,0 +1,26 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" id="search-intro">
+
+  <info>
+    <link type="guide" xref="files-search"/>
+    <desc>Introduction to <app>Search for Files</app>.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-9" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+
+  <title>Introduction</title>
+     <p>
+       The <app>Search for Files</app> application lets you find files and folders on your computer. All searches are case-insensitive.
+    </p>
+    
+    <note style="advanced">
+     <p>
+      <app>Search for Files</app> uses the <cmd>locate</cmd>, <cmd>find</cmd>, and <cmd>grep</cmd> commands. It first performs a quick search using the <cmd>locate</cmd>.  Then it performs a second search using <cmd>find</cmd>. The <cmd>locate</cmd> command uses a database to locate files. If the database hasn't been updated in over a week, <app>Search for Files</app> may warn you that the search results may be out of date and give you the option of disabling the quick search. To update the database, run the command <cmd>updatedb</cmd> as root.
+      </p>
+    </note>
+  
+</page>
diff --git a/gnome-help/C/search-open.page b/gnome-help/C/search-open.page
new file mode 100644
index 0000000..6581ffa
--- /dev/null
+++ b/gnome-help/C/search-open.page
@@ -0,0 +1,33 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" id="search-open">
+
+  <info>
+    <link type="guide" xref="files-search#search"/>
+    <title type="sort">b</title>
+    <desc>Open file from <gui>Search results</gui> box.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-9" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+
+  <title>Open a Found File</title>
+    <p>
+     To open a file from the <gui>Search results</gui> box, double-click on the file name.
+    </p>
+    <p>
+     To open the folder containing a found file:
+     </p>
+     <steps>
+       <item><p>
+         Right-click on the file name.
+       </p></item>
+       <item><p>
+         Select <gui>Open Folder</gui>.
+       </p></item>
+     </steps>
+
+
+</page>
diff --git a/gnome-help/C/search-otherapps.page b/gnome-help/C/search-otherapps.page
new file mode 100644
index 0000000..0dcfd17
--- /dev/null
+++ b/gnome-help/C/search-otherapps.page
@@ -0,0 +1,37 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" id="search-otherapps">
+
+  <info>
+    <link type="guide" xref="files-search#other"/>
+    <desc>Other useful applications.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-9" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+
+  <title>Search Applications</title>
+  
+  <p>
+    The following search applications can be installed using your distributions package manager:
+  </p>
+  <terms>
+   <item>
+    <title><link href="http://projects.gnome.org/tracker/">Tracker</link></title>
+    <p>
+    Allows you to search your documents, photos, music, and other files.  Results are returned quickly along with all of the file's metadata, such as title, artist, track, album, composer, date, etc.
+    </p>
+   </item>
+   
+   <item>
+    <title><link href="http://zeitgeist-project.com/">Zeitgeist</link></title>
+    <p>
+    A tool for easily browsing and finding files on your computer. It keeps a chronological journal of all file activity and supports tagging and establishing relationships between groups of files.
+    </p>
+   </item>
+ </terms>
+  
+  
+</page>
diff --git a/gnome-help/C/search-save.page b/gnome-help/C/search-save.page
new file mode 100644
index 0000000..22a820e
--- /dev/null
+++ b/gnome-help/C/search-save.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" id="search-save">
+
+  <info>
+    <link type="guide" xref="files-search#search"/>
+    <title type="sort">d</title>
+    <desc>Save your search to a file.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-9" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+
+  <title>Save Your Search</title>
+  
+  <steps>
+    <item><p>
+      Right-click in the <gui>Search results</gui> list.
+    </p></item>
+    <item><p>
+      Select <gui>Save Results As</gui>. 
+    </p></item>
+    <item><p>
+      Enter the name of the file to which you want to save the results (e.g. 'search_results.txt')
+    </p></item>
+    <item><p>
+      Choose the location to save the file to.
+    </p></item>
+    <item><p>
+      Click <gui>Save</gui>.
+    </p></item>
+  </steps>
+</page>
diff --git a/gnome-help/C/search-settings.page b/gnome-help/C/search-settings.page
new file mode 100644
index 0000000..e009053
--- /dev/null
+++ b/gnome-help/C/search-settings.page
@@ -0,0 +1,18 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" id="search-settings">
+
+  <info>
+    <link type="guide" xref="files-search#advanced"/>
+    <desc>Change the settings using the <app>Configuration Editor</app>.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-9" status="stub"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+
+  <title>Settings</title>
+
+  
+</page>
diff --git a/gnome-help/C/search.page b/gnome-help/C/search.page
new file mode 100644
index 0000000..c5806b7
--- /dev/null
+++ b/gnome-help/C/search.page
@@ -0,0 +1,119 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="topic" id="search">
+
+  <info>
+    <link type="guide" xref="files-search#search"/>
+    <title type="sort">a</title>
+    <desc>How to find a file.</desc>
+    <revision pkgversion="0.1" version="0.1" date="2011-01-9" status="review"/>
+    <credit type="author">
+      <name>GNOME Documentation Project</name>
+      <email>gnome-doc-list@gnome.org</email>
+    </credit>
+
+  </info>
+    <title>Search For a File</title>
+      <steps>
+      <item>
+        <p>
+         In the <link xref="shell-apps">applications overview</link> click on the <app>Search for Files</app> application icon.  If you don't see it, you can type "search for files" in the search textbox.
+         </p>
+                  <p>
+         Alternatively, you can use the command-line.  Type <code> gnome-search-tool </code> at the prompt.
+         </p>
+         <p>
+         <media type="image" src="Screenshot-Search for Files.png"/>
+         </p>
+      </item>
+
+      <item>
+        <p>
+          In the <gui>Name contains</gui> textbox, type the full or partial file name.  The search is case insensitive, and the ? and * wildcards can be used.  The ? stands in for any one letter, and the * stands in for any sequence of one or more letters.  For example:
+        </p>
+        <terms>
+        <item>
+          <title>
+            If you type "file.txt", the following files will be found:
+          </title>
+          <p>
+            file.txt, File.txt, myfile.txt, MyFile.txtxyz, etc.
+          </p>
+          </item>
+        <item>
+         <title>
+            If you type "fi?e.txt", the following files will be found:
+          </title>
+                <p>
+                  Five.txt, file.txt, File.txt, myfile.txt, MyFile.txtxyz, etc.
+                </p>
+              </item>
+          <item>
+           <title>
+            If you type "fi*e.*txt", the following files will be found:
+           </title>
+                <p>
+                  File.txt, fillie.odt, fibonacci_example.txt, FindMachineEpsilon.exe.manifest, etc.
+                </p>
+              </item>
+         </terms>
+      </item>
+      <item>
+        <p>
+        In the <gui>Look in folder</gui> menu, select the folder you wish to search.  <app>Search for Files</app> will search the folder you choose, including the subfolders.
+        </p>
+      </item>
+      
+      <item>
+        <p>
+         Click <gui>Find</gui>.  Your results will be displayed in the <gui>Search results</gui> box.  If the search found no matches, <gui>No files found</gui> will be displayed.  You can stop a search in progress by clicking <gui>Stop</gui>.   
+        </p>
+        <p>
+         Alternatively, you can go to step 5 to add more search options.
+        </p>
+      </item>
+      
+      <item>
+        <p>
+          To add more search options:
+        </p>
+        <steps>
+          <item>
+            <p>
+              Click on <gui>Select more options</gui>.  This will reveal the <gui>Available options</gui> menu.
+            </p>
+          </item>
+         <item>
+            <p>
+              Click on the <gui>Available options</gui> menu.  Select a search option.
+            </p>
+            <p>
+              <media type="image" src="Screenshot-Search for Files-options.png"/>
+           </p>
+          </item>
+          <item>
+            <p>
+              Click <gui>Add</gui>.
+            </p>
+          </item>
+          <item>
+            <p>
+               If the search option requires additional information, type it in the textbox.
+            </p>
+          </item>
+          <item>
+            <p>
+             You can specify as many additional search options as needed.
+            </p>
+          </item>
+          <item>
+            <p>
+              When you are finished adding search options, click <gui>Find</gui>.
+            </p>
+
+          </item>
+        </steps>
+      </item>
+    </steps>
+  
+  
+</page>