[gnome-terminal/wip/mallard-merge: 163/242] help: review pref-custom-shells.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 98726345dfbcb330ab0704eb0cf2a2fac6ed08f0
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Sun Feb 24 10:20:04 2013 +0100

    help: review pref-custom-shells.page

 help/C/pref-custom-shells.page |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)
---
diff --git a/help/C/pref-custom-shells.page b/help/C/pref-custom-shells.page
index 501a67e..54faff8 100644
--- a/help/C/pref-custom-shells.page
+++ b/help/C/pref-custom-shells.page
@@ -9,6 +9,11 @@
       <email>sindhus live in</email>
       <years>2013</years>
     </credit>
+    <credit type="copyright editor">
+      <name>Ekaterina Gerasimova</name>
+      <email>kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
 
     <link type="guide" xref="index#preferences"/>
 
@@ -18,10 +23,18 @@
 
   <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>
@@ -36,5 +49,8 @@
 
   <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. -->
   </note>
+
 </page>