type="guide"

      id="pref-login-shell">

  <info>

    <revision pkgversion="3.8" date="2013-03-03" status="review"/>

    <revision pkgversion="3.14" date="2014-09-08" status="review"/>

    <link type="guide" xref="index#preferences"/>

    <link type="guide" xref="pref#profile"/>

    <credit type="author copyright">

      <name>Sindhu S</name>

      <email>sindhus@live.in</email>

      <years>2013</years>

    </credit>

    <credit type="copyright editor">

      <name>Ekaterina Gerasimova</name>

      <email>kittykat3756@gmail.com</email>

      <years>2013-2014</years>

    </credit>

    <credit type="copyright editor">

      <name>Michael Hill</name>

      <email>mdhillca@gmail.com</email>

      <years>2013</years>

    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

    <desc>Start a login shell in <app>Terminal</app>.</desc>

  </info>

  <title>Login shells</title>

  
Shells in UNIX based systems can be started up in login and non-login

  modes:

  <terms>

    <item>

      <title>Login shell</title>

      
A login shell is a shell given to a user upon login into their user

      account. This is initiated by using the <cmd>-l</cmd> or

      <cmd>--login</cmd> option, or placing a dash as the initial character

      of the command name, for example invoking <cmd>bash</cmd> as

      <cmd>-bash</cmd>.

    </item>

    <item>

      <title>Sub shell</title>

      
Sub shell, also called a non-login shell is a shell started after

      the login process without the <cmd>-l</cmd> or <cmd>--login</cmd>

      option and without an extra dash before the command name.

    </item>

  </terms>

  
The general cases for having a login shell include:

  <list>

    <item>

      
Accessing your computer remotely using <app>ssh</app>.

    </item>

    <item>

      
Simulating an initial login shell with <cmd>bash -l</cmd> or

      <cmd>sh -l</cmd>.

    </item>

    <item>

      
Simulating an initial root login shell with <cmd>sudo -i</cmd>.

    </item>

  </list>

  <section id="login-shell-howto">

    <title>Start a login shell</title>

    
You can allow <app>Terminal</app> to start a login shell. Your default

    shell will be started with a dash character prepended to its name.

    <steps>

      <item>

        
Open <guiseq><gui style="menu">Edit</gui>

        <gui style="menuitem">Preferences</gui></guiseq>.

      </item>

      <item>

        
Your current profile is selected in the sidebar. If you wish to edit

        a different profile, click on its name.

      </item>

      <item>

        
Select <gui style="tab">Command</gui>.

      </item>

      <item>

        <comment>

          Kat

          
TODO: test when this takes effect.

        </comment>

        
Under the <gui>Command</gui> label, select

        <gui style="checkbox">Run command as a login shell</gui>.

      </item>

    </steps>

  </section>

</page>