[gedit] added two side-pane images and completed an initial draft of the side-pane documentation

[Ignacio Casal Quinteiro <icq src gnome org>]

commit 22cf0e3f98a223d22be9d71278fe97f309aa7d08
Author: Jim Campbell <jwcampbell gmail com>
Date:   Mon Feb 28 12:43:40 2011 +0100

    added two side-pane images and completed an initial draft of the side-pane documentation

 help/C/figures/gedit-side-pane1.png        |  Bin 0 -> 1465 bytes
 help/C/figures/gedit-side-pane2.png        |  Bin 0 -> 1400 bytes
 help/C/gedit-open-files-from-sidepane.page |   67 +++++++++++++++++++++++-----
 help/C/gedit-quickstart.page               |   22 +++++-----
 help/C/gedit-syntax-highlighting.page      |   26 +++++-----
 5 files changed, 79 insertions(+), 36 deletions(-)
---
diff --git a/help/C/figures/gedit-side-pane1.png b/help/C/figures/gedit-side-pane1.png
new file mode 100644
index 0000000..a996832
Binary files /dev/null and b/help/C/figures/gedit-side-pane1.png differ
diff --git a/help/C/figures/gedit-side-pane2.png b/help/C/figures/gedit-side-pane2.png
new file mode 100644
index 0000000..d8241cd
Binary files /dev/null and b/help/C/figures/gedit-side-pane2.png differ
diff --git a/help/C/gedit-open-files-from-sidepane.page b/help/C/gedit-open-files-from-sidepane.page
index c905d84..25ad643 100644
--- a/help/C/gedit-open-files-from-sidepane.page
+++ b/help/C/gedit-open-files-from-sidepane.page
@@ -2,15 +2,58 @@
       type="topic" style="task"
       id="gedit-view-open-files-from-sidepane">
 
-<info>
-  <link type="guide" xref="index#configure-gedit"/>
-  <revision pkgversion="3.0" version="0.1" date="2010-10-10" status="incomplete"/>
-  <credit type="author">
-    <name>Jim Campbell</name>
-    <email>jwcampbell gmail com</email>
-  </credit>
-</info>
-
-<title>*View and open files from the side pane</title>
-
-</page>
+  <info>
+    <link type="guide" xref="index#configure-gedit"/>
+    <revision pkgversion="3.0" version="0.1" date="2010-10-10" status="incomplete"/>
+    <credit type="author">
+      <name>Jim Campbell</name>
+      <email>jwcampbell gmail com</email>
+    </credit>
+  </info>
+
+  <title>View and open files from the side pane</title>
+  <p>
+    The most common way to switch between files in <app>gedit</app> is by using the tabs at the top of the <app>gedit</app> window. In some cases, though, particularly when you are working with a large number of open files, you may find it beneficial to use the <app>side pane</app>. 
+  </p> 
+
+  <p>
+    The <app>side pane</app> can help you to open new files, and easily switch between open files. To activate the <app>side pane</app>, select <guiseq><gui>View</gui><gui>Side Pane</gui></guiseq>, or just press the <key>F9</key> key.
+  </p>
+
+  <note style="note">
+    <p>
+      You can toggle the <gui>side pane</gui> open or closed by pressing <key>F9</key> at any time.
+    </p>
+  </note>
+
+  <section id="sidepane-open">
+    <title>Opening files from the side pane</title>
+    <p>
+      To open files from the <app>side pane</app>, first open the <app>side pane</app> by selecting <guiseq><gui>View</gui><gui>Side Pane</gui></guiseq>, then click on the <gui>file-browser</gui> icon at the bottom of the pane.
+    </p>
+
+    <p>
+      <media type="image" mime="image/png" src="figures/gedit-side-pane1.png"/>
+    </p>
+
+    <p>
+      This will activate the <em>file-browser</em> mode of the <app>side pane</app>. You can then use the navigation buttons at the top of the pane to locate and open your desired files.
+    </p>
+  </section>
+
+  <section id="sidepane-switch">
+    <title>Using the side pane to switch between open files</title>
+    <p>
+      Once you have several files open, you can use the side pane to switch between open files. To activate the file browser portion of the <app>side pane</app>, click on the <gui>file</gui> icon at the bottom of the <gui>side pane</gui>. 
+    </p>
+    
+    <p>
+      <media type="image" mime="image/png" src="figures/gedit-side-pane2.png"/>
+    </p>
+
+    <p>
+      Clicking on any file name in the <gui>side pane</gui> will activate that file for editing.
+    </p>
+  </section>
+ 
+ </page>
diff --git a/help/C/gedit-quickstart.page b/help/C/gedit-quickstart.page
index 408653a..7a7ae6e 100644
--- a/help/C/gedit-quickstart.page
+++ b/help/C/gedit-quickstart.page
@@ -2,22 +2,22 @@
       type="topic" style="task"
       id="gedit-quickstart">
 
-<info>
-  <link type="guide" xref="index"/>
-  <revision pkgversion="3.0" version="0.1" date="2010-10-10" status="incomplete"/>
-  <credit type="author">
-    <name>Jim Campbell</name>
-    <email>jwcampbell gmail com</email>
-  </credit>
-</info>
+  <info>
+    <link type="guide" xref="index"/>
+    <revision pkgversion="3.0" version="0.1" date="2010-10-10" status="incomplete"/>
+    <credit type="author">
+      <name>Jim Campbell</name>
+      <email>jwcampbell gmail com</email>
+    </credit>
+  </info>
 
-<title>Get started with gedit</title>
+  <title>Get started with gedit</title>
   <p><app>gedit</app> is a full-featured text editor for the GNOME desktop environment.  You can use it to prepare simple notes and documents or you can use some of its advanced features, making it your own software development environment.</p>
 
   <media type="image" mime="image/png" src="figures/gedit-screenshot.png"/>
 
-<p>Once <app>gedit</app> launches, you can start writing right away. To save your text, just click <gui>Save</gui>.</p>  
+  <p>Once <app>gedit</app> launches, you can start writing right away. To save your text, just click <gui>Save</gui>.</p>  
 
-<p>To learn about additional <app>gedit</app> features and to get assistance with performing additional tasks, explore <link xref="index">the other portions</link> of the <app>gedit</app> help.</p>
+  <p>To learn about additional <app>gedit</app> features and to get assistance with performing additional tasks, explore <link xref="index">the other portions</link> of the <app>gedit</app> help.</p>
 
 </page>
diff --git a/help/C/gedit-syntax-highlighting.page b/help/C/gedit-syntax-highlighting.page
index ab57c86..77c8d03 100644
--- a/help/C/gedit-syntax-highlighting.page
+++ b/help/C/gedit-syntax-highlighting.page
@@ -2,22 +2,22 @@
       type="topic" style="task"
       id="gedit-syntax-highlighting">
 
-<info>
-  <link type="guide" xref="index#configure-gedit"/>
-  <revision pkgversion="3.0" version="0.1" date="2010-10-10" status="incomplete"/>
-  <credit type="author">
-    <name>Jim Campbell</name>
-    <email>jwcampbell gmail com</email>
-  </credit>
-</info>
+  <info>
+    <link type="guide" xref="index#configure-gedit"/>
+    <revision pkgversion="3.0" version="0.1" date="2010-10-10" status="incomplete"/>
+    <credit type="author">
+      <name>Jim Campbell</name>
+      <email>jwcampbell gmail com</email>
+    </credit>
+  </info>
 
-<title>Turn on syntax highlighting</title>
+  <title>Turn on syntax highlighting</title>
 
-<section id="gedit-syntax-highlighting-section">
+  <section id="gedit-syntax-highlighting-section">
     <title>Syntax Highlighting</title>
-<p>gedit includes syntax highlighting for a wide range of markup, programming, and scientific languages.  If gedit recognizes the syntax being used when you open a file, it will provide appropriate syntax highlighting without requiring any intervention.</p>
+    <p>gedit includes syntax highlighting for a wide range of markup, programming, and scientific languages.  If gedit recognizes the syntax being used when you open a file, it will provide appropriate syntax highlighting without requiring any intervention.</p>
 
-<p>If your syntax is not highlighted upon startup, you can select the appropriate syntax or language by clicking <guiseq><gui>View</gui><gui>Highlight Mode</gui></guiseq>, and then choosing the desired syntax.</p>
-</section>
+    <p>If your syntax is not highlighted upon startup, you can select the appropriate syntax or language by clicking <guiseq><gui>View</gui><gui>Highlight Mode</gui></guiseq>, and then choosing the desired syntax.</p>
+  </section>
 
 </page>