[gnome-terminal/wip/mallard-merge: 186/276] Help: Modified two help files.

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit aa00b806b4c2ce2510a9e771e80d9e426d2f0226
Author: Sindhu S <sindhus live in>
Date:   Sun Feb 24 16:11:09 2013 +0530

    Help: Modified two help files.
    
    gs-execute-commands.page:
    Changed incorrect page ID.
    
    pref-custom-shells.page:
    Reworded help to explain relationship between shells, programs
    and commands.
    Added one more step for user to verify whether the custom shell
    or command set if working OK.

 help/C/gs-execute-commands.page |    3 +-
 help/C/pref-custom-shells.page  |   51 +++++++++++++++++++--------------------
 2 files changed, 27 insertions(+), 27 deletions(-)
---
diff --git a/help/C/gs-execute-commands.page b/help/C/gs-execute-commands.page
index 08f3f5f..5e68dee 100644
--- a/help/C/gs-execute-commands.page
+++ b/help/C/gs-execute-commands.page
@@ -1,10 +1,11 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="guide"
-      id="execute-commands">
+      id="gs-execute-commands">
 
   <info>
     <revision version="0.1" date="2013-01-10" status="draft"/>
     <link type="guide" xref="index#getting-started"/>
+    <link type="seealso" xref="pref-custom-shells"/>
 
     <credit type="author copyright">
       <name>Sindhu S</name>
diff --git a/help/C/pref-custom-shells.page b/help/C/pref-custom-shells.page
index 54faff8..8bf704b 100644
--- a/help/C/pref-custom-shells.page
+++ b/help/C/pref-custom-shells.page
@@ -16,6 +16,7 @@
     </credit>
 
     <link type="guide" xref="index#preferences"/>
+    <link type="seealso" xref="gs-execute-commands"/>
 
     <desc>Start your <app>Terminal</app> with a command or a different shell</desc>
 
@@ -23,34 +24,32 @@
 
   <title>Custom shells</title>
 
-  <!-- Reflow. Launch does not need to be in quotes, run is more apropriate
-  than either term. Check with Christian if one can actually run a "custom
-  command" or whether the UI means just run another shell and is referring only
-  to commands that run a shell. -->
-  <p>A shell is software that provides an interface for users of an operating system to invoke or "launch" 
another program; however, shells frequently have additional capabilities such as viewing the contents of 
directories.</p>
-
-  <p>To start <app>Terminal</app> to run a command or a shell other than <gui>Bash</gui>:</p>
-  <!-- Bash is an app more than a GUI. Check if gnome-user-help mentions it and
-  if yes, how it is marked up. -->
-
-  <!-- Indent steps only by two spaces as they are on the same "level" as
-  paragraphs. -->
-    <steps>
-      <item>
-        <p>Select <guiseq><gui style="menu">Edit</gui><gui style="menuitem">Profile Preferences…</gui><gui 
style="tab">Title and Command</gui></guiseq></p>
-      </item>
-      <item>
-        <p>Select <gui>Run a command instead of my shell</gui>.</p>
-      </item>
-      <item>
-        <p>In the input box, type the name of the command or the desired shell.</p>
-      </item>
-    </steps>
+  <p>A shell is software that provides an interface for users of an operating
+  system to run programs and view the contents of directories.
+  The default shell is <app>Bash</app>.</p>
+
+  <p><app>Terminal</app> can be set to run a custom shell or the default shell with additional parameters 
such a configuration file other than the default. A shell is a type of program and hence <app>Terminal</app> 
can also be exclusively set to run standalone programs such as <code>ls</code>, <code>top</code>, 
<code>iwconfig</code> etc.</p>
+
+  <p>Programs that are executed in the command line environment are also referred to as commands.</p>
+
+  <p>To start <app>Terminal</app> to run a command or a shell:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui style="menu">Edit</gui><gui style="menuitem">Profile Preferences…</gui><gui 
style="tab">Title and Command</gui></guiseq></p>
+    </item>
+    <item>
+      <p>Select <gui>Run a command instead of my shell</gui>.</p>
+    </item>
+    <item>
+      <p>In the input box, type the name of the command or the desired shell.</p>
+    </item>
+    <item>
+      <p>Open a new <app>Terminal</app> tab or window to view the execution of your custom shell or 
command.</p>
+    </item>
+  </steps>
 
   <note style="important">
-    <p>You may have to enter full path to the command or shell in case you have not added the directory 
where the command or shell resides to the system's PATH variable.</p>
-  <!-- Do not use possessive for inanimate objects. the PATH should be marked
-  up. -->
+    <p>You may have to enter full path to the command or the shell in case you have not added the directory 
where the command or shell resides in the <code>PATH</code> variable of your your system.</p>
   </note>
 
 </page>