[gnome-terminal/wip/mallard-merge: 218/222] help: update login-shell and keyboard-shortcuts

[Ekaterina Gerasimova <egerasimov src gnome org>]

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

    help: update login-shell and keyboard-shortcuts
    
    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.
    
    Fixed location in index sections.

 help/C/adv-keyboard-shortcuts.page |    2 +-
 help/C/pref-login-shell.page       |  132 +++++++++++++++++++++++++-----------
 2 files changed, 92 insertions(+), 42 deletions(-)
---
diff --git a/help/C/adv-keyboard-shortcuts.page b/help/C/adv-keyboard-shortcuts.page
index 694e8fa..e883aa8 100644
--- a/help/C/adv-keyboard-shortcuts.page
+++ b/help/C/adv-keyboard-shortcuts.page
@@ -5,7 +5,7 @@
 
   <info>
     <revision version="0.1" date="2013-02-17" status="candidate"/>
-    <link type="guide" xref="index#preferences"/>
+    <link type="guide" xref="index#advanced"/>
     <link type="seealso" xref="pref-keyboard-access" />
 
     <credit type="author copyright">
diff --git a/help/C/pref-login-shell.page b/help/C/pref-login-shell.page
index c03d80c..8b7b116 100644
--- a/help/C/pref-login-shell.page
+++ b/help/C/pref-login-shell.page
@@ -4,7 +4,7 @@
 
   <info>
     <revision version="0.1" date="2013-02-25" status="draft"/>
-    <link type="guide" xref="index#advanced"/>
+    <link type="guide" xref="index#preferences"/>
 
     <credit type="author copyright">
       <name>Sindhu S</name>
@@ -22,49 +22,99 @@
 
   <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 style="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 allow <app>Terminal</app> 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