GNOME.org
 

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

commit bc7f4ba9e8162d9134cb25ec1a0a02eac5125864
Author: Tiffany Antopolski <antopolski src gnome org>
Date:   Sun Jan 9 04:10:52 2011 -0500

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

 .../C/Screenshot-Search for Files-options.png      |  Bin 0 -> 70619 bytes
 gnome-help/C/Screenshot-Search for Files.png       |  Bin 0 -> 18588 bytes
 gnome-help/C/files-lost.page                       |   24 ----
 gnome-help/C/files-search.page                     |   41 +++++++
 gnome-help/C/gnome-searchtool.png                  |  Bin 0 -> 2343 bytes
 gnome-help/C/search-commandline.page               |   31 +++++
 gnome-help/C/search-delete.page                    |   30 +++++
 gnome-help/C/search-intro.page                     |   26 +++++
 gnome-help/C/search-open.page                      |   33 ++++++
 gnome-help/C/search-otherapps.page                 |   37 ++++++
 gnome-help/C/search-save.page                      |   35 ++++++
 gnome-help/C/search-settings.page                  |   18 +++
 gnome-help/C/search.page                           |  119 ++++++++++++++++++++
 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
Binary files /dev/null and b/gnome-help/C/Screenshot-Search for Files-options.png differ
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
Binary files /dev/null and b/gnome-help/C/Screenshot-Search for Files.png differ
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
Binary files /dev/null and b/gnome-help/C/gnome-searchtool.png differ
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>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]