added section on the fileselector

2 files changed, 76 insertions, 0 deletions

diff --git a/gnome2-user-guide/C/ChangeLog b/gnome2-user-guide/C/ChangeLog
index 6502ddc..e8c9ffd 100644
--- a/gnome2-user-guide/C/ChangeLog
+++ b/gnome2-user-guide/C/ChangeLog
@@ -1,5 +1,10 @@
 2006-02-28 Joachim Noreiko <jnoreiko@yahoo.com>
 
+	* gosoverview.xml:
+	added section on the fileselector
+
+2006-02-28 Joachim Noreiko <jnoreiko@yahoo.com>
+
 	* goscustdesk.xml:
 	added link to GStreamer, prefs tool with docs outside the UG
 	added a note to the CD database prefs tool saying *diplomatically* that no apps except CD player use it
diff --git a/gnome2-user-guide/C/gosoverview.xml b/gnome2-user-guide/C/gosoverview.xml
index e3a2ab1..22936ff 100644
--- a/gnome2-user-guide/C/gosoverview.xml
+++ b/gnome2-user-guide/C/gosoverview.xml
@@ -492,5 +492,76 @@ specify the number of workspaces that you require.</para>
         </listitem>
       </itemizedlist>
     </section>
+    <section id="overview-files">
+      <title>Working With Files</title>
+      <para>The work you do with an application is stored in <firstterm>files</firstterm>. These may be on your computer's hard drive, or on a removable device such as a USB flashdrive. You <firstterm>open</firstterm>  a file to examine it or work on it, and you <firstterm>save</firstterm> a file to store your work. When you are done working with a file, you <firstterm>close</firstterm> it.</para>
+      <para>All GNOME applications use the same dialogs for opening and saving files, presenting you with a consistent interface. The following sections cover the open and the save dialog in detail.</para>
+    </section>
+    <section id="filechooser-open">
+      <title>Choosing a File to Open</title>
+      <para>The <guilabel>Open File</guilabel> dialog allows you to choose a file to open in an application.</para>
+      <para>The right-hand pane of the dialog lists files and folders in the current location. You can use the mouse or the arrow keys on your keyboard to select a file.</para>
+      <para>Once a file is selected in the list, perform one of the following actions to open it:</para>
+      <itemizedlist>
+        <listitem><para>Click <guibutton>Open</guibutton>.</para></listitem>
+        <listitem><para>Press <keycap>Return</keycap>.</para></listitem>
+        <listitem><para>Press <keycap>Spacebar</keycap>.</para></listitem>        
+        <listitem><para>Double-click the file.</para></listitem>
+      </itemizedlist>      
+      <para>If you open a folder or a location instead of a file, the <guilabel>Open File</guilabel> dialog updates to show the contents of that folder or location.</para>
+      
+      <para>To change the location shown in the right-hand pane, do one of the following:</para>
+      <itemizedlist>
+	      <listitem><para>Open a folder that is listed in the current location.</para></listitem>
+	      <listitem><para>Open an item in the left-hand pane. This pane lists places such as your Documents folder, your Home Folder, media such as CDs and flashdrives, places on your network, and your <link linkend="nautilus-bookmarks">bookmarks</link>.</para></listitem>
+	      <listitem><para>Click one of the buttons in the path bar above the file listing pane. This shows the hierarchy of folders that contain your current location. Use the arrow buttons to either side of the button bar if the list of folders is too long to fit.</para></listitem>
+      </itemizedlist>
+      
+      <para>The lower part of the <guilabel>Open File</guilabel> dialog may contain further options specific to the current application.</para>
+      
+      <section id="filechooser-open-filter">
+        <title>Filtering the File List</title>
+        <para>You can restrict the file list to show only files on certain types. To do this, choose a file type from the drop-down list beneath the file list pane. The list of file types depends on the application you are currently using. For example, a graphics application will list different image file formats, and a text editor will list different types of text file.</para>
+      </section>
+      
+      <section id="filechooser-open-find">
+        <title>Find-as-you-type</title>
+          <para>If you know the name of the file you want to open, begin typing it: the file list will jump to show you files whose names begin with the characters you type. Arrow keys will now select from only these files. The characters you have typed appear in a pop-up window at the base of the file list.</para>
+          <para>To cancel find-as-you-type, press <keycap>Esc</keycap>.</para>    
+      </section>
+      <section id="filechooser-open-location">
+        <title>Open Location</title>
+        <para>To enter the full path to a file you want to open, press <keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo> or right-click in the right-hand pane and choose <guimenuitem>Open Location</guimenuitem>. This opens the <guilabel>Open Location</guilabel> dialog.</para>
+        <para>Type a path from the current location, or an absolute path beginning with <filename>/</filename> or <filename>~/</filename>. The <guilabel>Location</guilabel> field has the following features to simplify the typing of a full filename:</para>
+        <itemizedlist>
+	        <listitem><para>A drop-down of possible file and folder names is displayed once you begin typing. Use <keycap>down arrow</keycap> and <keycap>up arrow</keycap> and <keycap>Return</keycap> to choose from the list.</para></listitem>
+	        <listitem><para>If the part of the name typed uniquely identifies a file or folder, the name is auto-completed. Press <keycap>Tab</keycap> to accept the suggested text. For example, if you type "Do", and the only object in the folder beginning with "Do" is <filename>Documents</filename>, then the entire name appears in the field.</para></listitem>
+        </itemizedlist>
+      </section>
+      <section id="filechooser-open-bookmarks">
+        <title>Adding and Removing Bookmarks</title>
+        <para>To add the current location to the bookmarks list, press <guibutton>Add</guibutton>, or right-click a folder in the file list and choose <guimenuitem>Add to Bookmarks</guimenuitem>.</para>
+        <para>To remove a bookmark from the list, select it and press <guibutton>Remove</guibutton>.</para>
+        <note><para>Changes you make to the bookmarks list also affect the <guimenu>Places</guimenu> menu. For more on bookmarks, see <xref linkend="nautilus-bookmarks"/>.</para></note>
+      </section>      
+      <section id="filechooser-open-hidden">
+        <title>Showing hidden files</title>
+          <para>To show hidden files in the file list, right-click in the file list and choose <guimenuitem>Show Hidden Files</guimenuitem>. For more on hidden files, see <xref linkend="nautilus-managing-hidden-files"/>.</para>
+      </section>
+    </section>
+    <section id="filechooser-save">
+      <title>Saving a File</title>
+        <para>The first time you save your work in an application, the <guilabel>Save File</guilabel> dialog will ask you for a location and name for the new file. Subsequent saving updates this file. To save to a new file, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Save As</guimenuitem></menuchoice>.</para>
+        <para>You can enter a filename and choose a location to save in from the drop-down list of bookmarks and commonly-used locations.</para>
+        <section id="filechooser-save-expanded">
+          <title>Saving in another location</title>
+          <para>To save the file in a location not listed in the drop-down list, click the <guilabel>Browse for other folders</guilabel> expansion label. This shows a file browser similar to the one in the <guilabel>Open File</guilabel> dialog.</para>
+          <tip><para>The expanded <guilabel>Save File</guilabel> dialog has the same features as the <link linkend="filechooser-open"><guilabel>Open File</guilabel> dialog</link>, such as filtering, find-as-you-type, and adding and removing bookmarks.</para></tip>
+        </section>          
+        <section id="filechooser-save-path">
+          <title>Typing a Path</title>
+          <para>To specify a path to save a file, type it into the <guilabel>Name</guilabel> field. A drop-down of possible file and folder names is displayed once you begin typing. Use <keycap>down arrow</keycap> and <keycap>up arrow</keycap> and <keycap>Return</keycap> to choose from the list. If only one file or folder matches the partial name you have typed, press <keycap>Tab</keycap> to complete the name.</para>       
+        </section>  
+    </section>
   </section>
 </chapter>