[gnome-terminal/wip/mallard-merge: 253/261] Help: Modified help in pref-login-shell.page.

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 1c02d7bd5538cc371ee1e44e23fd78aa5b7e7751
Author: Sindhu S <sindhus live in>
Date:   Wed Feb 27 13:12:28 2013 +0530

    Help: Modified help in pref-login-shell.page.
    
    Added sections and explained about how to start a login shell.
    Added a section that explains about updating login records.
    Added a note on how to check login history using the 'last' command.

 help/C/pref-login-shell.page |  114 +++++++++++++++++++++++++++---------------
 1 files changed, 74 insertions(+), 40 deletions(-)
---
diff --git a/help/C/pref-login-shell.page b/help/C/pref-login-shell.page
index c03d80c..61832ec 100644
--- a/help/C/pref-login-shell.page
+++ b/help/C/pref-login-shell.page
@@ -22,49 +22,83 @@
 
   <title>Login shells</title>
 
-  <p>Shells are UNIX based systems are classified into two types:</p>
+  <p>Shells in UNIX based systems are classified into two types:</p>
 
   <terms>
     <item>
-      <title>Login shell</title>
-      <p>A login shell is a shell given to user upon his login to her user
-      account. This login shell is defined at the time of the user account
-      creation by the root user. It is initiated by using the --login option
-      with bash. It starts after a successful login using /bin/login and by
-      reading the /etc/passwd file.</p>
-      <!-- Use proper markup for "--login" and paths. -->
-
-      <p>The other general cases for having a login shell include:</p>
-      <list>
-        <item>
-         <!-- Use full sentences and no brackets. -->
-          <p>accessing your computer remotely via ssh (or connecting locally
-         with ssh localhost)</p>
-        </item>
-        <item>
-          <p>simulating an initial login shell with bash -l (or sh -l)</p>
-        </item>
-        <item>
-          <p>simulating an initial root login shell with sudo -i or sudo -u
-         username -i for another non-root user.</p>
-        </item>
-        <item>
-          <p>authenticating as another non-root user with su - username (and
-         their password) using the sudo login command to switch user</p>
-        </item>
-      </list>
-    </item>
-    <item>
-      <title>Sub shell</title>
-      <p>Sub shell also called a non-login shell is a shell started after the
-      login process without the --login option. Configuring gnome-terminal to
-      start bash as a login shell means it will start bash using the --login
-      option.</p>
-    </item>
-  </terms>
+        <title>Login shell</title>
+        <p>A login shell is a shell given to user upon his login to her user
+        account. This login shell is defined at the time of creation of the user
+        account by the super user. It is initiated by using the
+        <code>--login</code> option with bash. It starts after a successful
+        login using <code>/bin/login</code> and by reading the
+        <code>/etc/passwd</code> file.</p>
+      </item>
+      <item>
+        <title>Sub shell</title>
+        <p>Sub shell also called a non-login shell is a shell started after the
+      login process without the --login option.</p>
+      </item>
+    </terms>
+
+    <p>The general cases for having a login shell include:</p>
+        <list>
+          <item>
+            <p>Accessing your computer remotely using <app>ssh</app>.</p>
+          </item>
+          <item>
+            <p>Simulating an initial login shell with <code>bash -l</code> or <code>sh -l</code>.</p>
+          </item>
+          <item>
+            <p>Simulating an initial root login shell with <code>sudo -i</code>.</p>
+          </item>
+        </list>
+
+  <section id="login-shell-howto">
+    <title>Start a login shell</title>
+
+    <p>You can allow <app>Terminal</app> to start a login shell. The <code>--login</code> will be passed to 
<app>Bash</app> or your <link xref="pref-custom-shells">custom shell</link>.</p>.
+
+    <steps>
+      <item>
+        <p>Select <guiseq><gui style="menu">Edit</gui><gui stye="menuitem">Profile Preferences</gui><gui 
style="tab">General</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>Under <gui>Command</gui> label, select <gui style="checkbox">Run command as a login 
shell</gui>.</p>
+      </item>
+      <item>
+        <p>Click <gui style="button">Close</gui> to quit the dialog and return to <app>Terminal</app>.</p>
+      </item>
+    </steps>
+
+  </section>
+
+  <section id="login-shell-update-records">
+    <title>Update login records</title>
+
+    <p>UNIX based systems maintain files to keep information about user logins and sessions. They are called 
login records. To write an entry of your login in these records:</p>
+
+    <!-- Should I include these?
+      /var/run/utmp : List of current login sessions.
+      /var/log/wtmp : Database of past user logins / previous login sessions.
+      /var/log/lastlog : Last logins information about users -->
+
+    <steps>
+      <item>
+        <p>Select <guiseq><gui style="menu">Edit</gui><gui style="menuitem">Profile Preferences</gui><gui 
style="tab">General</gui></guiseq>.</p>
+      </item>
+      <item>
+        <p>Under the <gui>Command</gui> label, select <gui style="checkbox">Update login records when 
command is launched</gui>.</p>
+      </item>
+      <item>
+        <p>Click <gui style="button">Close</gui> to quit the dialog and return to <app>Terminal</app>.</p>
+      </item>
+    </steps>
 
-  <p>To start a login shell:</p>
+    <note style="tip">
+      <p>The command <app>last</app> followed by a username in your computer shows the login records for a 
particular user.</p>
+    </note>
 
-  <!--TODO: write how to start a login shell -->
+  </section>
 
-</page>
+</page>
\ No newline at end of file