[gnome-terminal/mallard-help] Help: Modified pref-login-shell.page

[Sindhu S <sindhus src gnome org>]

commit 482e0bcfc7ac920d97fbf2ce6fda3e0f99297a24
Author: Sindhu S <sindhus live in>
Date:   Fri Feb 15 16:54:24 2013 +0530

    Help: Modified pref-login-shell.page
    
    Deleted pref-login-shell.page.stub
    Added explanation about types of shell: login and sub-shell
    Added explanation about modes of shell: interactive and non-i
    Added a table to difference between all of these.

 help/C/pref-login-shell.page      |   76 +++++++++++++++++++++++++++++++++++++
 help/C/pref-login-shell.page.stub |   23 -----------
 2 files changed, 76 insertions(+), 23 deletions(-)
---
diff --git a/help/C/pref-login-shell.page b/help/C/pref-login-shell.page
new file mode 100644
index 0000000..3c83896
--- /dev/null
+++ b/help/C/pref-login-shell.page
@@ -0,0 +1,76 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="pref-login-shell">
+
+  <info>
+    <revision version="0.1" date="2013-01-09" status="draft"/>
+    <link type="guide" xref="index#advanced"/>
+
+    <credit type="author copyright">
+      <name>Sindhu S</name>
+      <email>sindhus live in</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>Start a login shell in <app>Terminal</app>.</desc>
+  </info>
+
+  <title>Login Shells</title>
+
+  <p>Shells in UNIX based systems are classified into two types:</p>
+
+    <terms>
+      <item>
+        <title>Login shell</title>
+        <p>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>
+
+        <p>The other general cases for having a login shell include:</p>
+            <list>
+              <item>
+                 <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>
+
+  <p>These shells can be run in two modes:</p>
+
+  <terms>
+    <item>
+      <title>Interactive</title>
+      <p>Interactive mode refers to shell mode where one can issue comamnds to the shell and it will execute 
the same. An interactive shell is one started with the -i option.</p>
+    </item>
+    <item>
+      <title>Non-interactive</title>
+      <p>A non-interactive shell is usually present when a shell script is running. It is non-interactive 
because it is processing a script and not waiting for user input between commands. For these shell 
invocations, only the environment inherited from the parent shell is used.</p>
+    </item>
+  </terms>
+
+  <table frame="all" rules="rows cols">
+  <tr>
+    <td><p>Types of shell</p></td>  <td><p>Login</p></td>  <td><p>Non-Login</p></td>
+  </tr>
+  <tr>
+    <td><p>Interactive</p></td> <td><p></p></td>
+    <td><p></p></td>
+  </tr>
+  <tr>
+    <td><p>Non-interacative</p></td>
+    <td><p>Not possible</p></td>  <td><p></p></td>
+  </tr>
+</table>
+
+</page>