[gnome-terminal/wip/mallard-merge: 186/271] help: update gs-execute-commands, add prob help

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 17901da2ebaa724037875ccd225a2bdd707e5498
Author: Sindhu S <sindhus live in>
Date:   Mon Feb 25 10:43:12 2013 +0530

    help: update gs-execute-commands, add prob help
    
    Removed review notes after reading them.
    
    Added prob-add-to-path.page that explains how to add a system
    location to the PATH variable in the default Bash shell.
    Modified gs-execute-commands.page note and linked it to
    prob-add-to-path.page.

 help/C/gs-execute-commands.page  |    6 +---
 help/C/prob-add-to-path.page     |   56 ++++++++++++++++++++++++++++++++++++++
 help/C/prob-common-problems.page |   24 ----------------
 3 files changed, 57 insertions(+), 29 deletions(-)
---
diff --git a/help/C/gs-execute-commands.page b/help/C/gs-execute-commands.page
index 9f80d54..16e4461 100644
--- a/help/C/gs-execute-commands.page
+++ b/help/C/gs-execute-commands.page
@@ -46,14 +46,10 @@
   when filing a bug report.</p>
 
   <note style="tip">
-    <!-- This is incorrect because one can run a program by specifying its
-    location. For example, './program' if the user is in the correct
-    directory. -->
     <p>Programs can be installed to different locations on your computer. If
     these locations are not added to the <code>PATH</code> variable of your
     computer, <app>Terminal</app> will not be able to run the desired program.
-    To find out where the program is installed on your computer, type
-    <code>which</code> followed by the program name.</p>
+    See <link xref="prob-add-to-path"/>.</p>
   </note>
   
 </page>
diff --git a/help/C/prob-add-to-path.page b/help/C/prob-add-to-path.page
new file mode 100644
index 0000000..683376f
--- /dev/null
+++ b/help/C/prob-add-to-path.page
@@ -0,0 +1,56 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="prob-add-to-path">
+
+  <info>
+    <revision version="0.1" date="2013-01-10" status="draft"/>
+    <link type="guide" xref="index#troubleshooting"/>
+
+    <credit type="author copyright">
+      <name>Sindhu S</name>
+      <email>sindhus live in</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>Add directories to system <code>PATH</code>.</desc>
+  </info>
+
+  <title><code>PATH</code> variable</title>
+
+  <note style="important">
+    <p>This page assumes you are using the default shell <app>Bash</app>. If you
+    are using any other shell, the name and location of the configuration file
+    may vary.</p>
+  </note>
+
+  <p><code>PATH</code> is a system variable that has address of locations where
+  programs have been installed. Often, <app>Terminal</app> is unable to find
+  programs to run whose locations are not included in the <code>PATH</code>
+  variable.</p>
+
+  <p>To add locations where programs are installed:</p>
+
+  <steps>
+    <item>
+      <p>With your preferred text editor, open the file <input>.bashrc</input>
+      located in your HOME directory.</p>
+    </item>
+    <item>
+      <p>In the <input>PATH</input> variable line, add the desired location
+      prepended by <input>:</input> (colon).</p>
+    </item>
+    <item>
+      <p>Save the file and exit the editor.</p>
+    </item>
+    <item>
+      <p>In a <app>Terminal</app> prompt, type <input>source ~/.bashrc</input>
+      to reload your shell configuration file.</p>
+    </item>
+    <item>
+      <p>You can now check the location of the desired program or command by
+      typing <input>which</input> followed by a space and program or command
+      name.</p>
+    </item>
+  </steps>
+
+</page>