type="guide"

      id="pref-profiles">

  <info>

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

    <revision pkgversion="3.12" date="2014-09-08" status="candidate"/>

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

    <link type="guide" xref="pref#manage-profiles"/>

    <credit type="author copyright">

      <name>Sindhu S</name>

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

      <years>2013</years>

    </credit>

    <credit type="author 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>Create, rename and delete profiles.</desc>

  </info>

  <title>Manage profiles</title>

  <comment>

    Kat

    
Repeating that the user can edit the settings in each section is not

    very nice, we need to find a way around this.

  </comment>

  
A profile is a collection of <app>Terminal</app> settings.

  <app>Terminal</app> supports multiple profiles. You can configure

  <app>Terminal</app> profiles to <link xref="pref-custom-command">run a custom

  command or shell</link>, set a profile exclusively to connect to remote

  computers using SSH or set a profile that launches a <app>GNU Screen</app>

  session.

  
The available <app>Terminal</app> settings include:

  <list>

    <item>

      
Profile name.

    </item>

    <item>

      
Font and background colors.

    </item>

    <item>

      
<gui style="tab">Compatibility</gui> with <key>Backspace</key> and

      <key>Delete</key> keys.

    </item>

    <item>

      
<gui style="tab">Scrolling</gui>.

    </item>

  </list>

  <section id="select-profile" style="task">

    <title>Select a profile</title>

    
If you have two or more profiles defined, you can change the profile in

    your current <app>Terminal</app> tab or

    window by selecting a profile from <guiseq><gui style="menu">Terminal</gui>

    <gui style="menuitem">Change Profile</gui></guiseq>.

  </section>

  <section id="new-profile" style="task">

    <title>Create a new profile</title>

    
To create a new profile with the default settings of

    <app>Terminal</app>:

    <steps>

      <item>

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

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

      </item>

      <item>

        
In the sidebar, click on the <gui style="button">+</gui> button

        next to the <gui>Profiles</gui> label.

      </item>

      <item>

        
Enter a name for the new profile. You can change this name later.

      </item>

      <item>

        
Click <gui style="button">Create</gui> to create the new profile.

      </item>

      <item>

        
Set your desired <link xref="#edit-profile">profile

        preferences</link>. These will be saved automatically.

      </item>

    </steps>

  </section>

  <section id="create-profile-from-existing" style="task">

    <title>Create a new profile based on an existing profile</title>

    
You can create a new profile based on settings from an existing

    profile:

    <steps>

      <item>

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

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

      </item>

      <item>

        
In the sidebar select the profile on which your new profile should

        be based.

      </item>

      <item>

        
Click on the arrow next to the profile name.

      </item>

      <item>

        
Select <gui style="menuitem">Clone…</gui>.

      </item>

      <item>

        
Enter a name for the new profile. You can change this name later.

      </item>

      <item>

        
Click <gui style="button">Clone</gui> to create the new profile.

      </item>

      <item>

        
Set your desired <link xref="#edit-profile">profile

        preferences</link>. These will be saved automatically.

      </item>

    </steps>

    <note>

      
Creating a new profile from an existing profile will not affect

      settings in an existing profile. Any changes to settings will be stored

      in the new profile.

    </note>

  </section>

  <section id="edit-profile" style="task">

    <title>Edit a profile</title>

    <note style="warning">

      
If the default profile is edited, it cannot be restored to its

      original settings! If you have not already created any other

      <app>Terminal</app> profiles and have customized the default profile,

      <app>Terminal</app> may become unusable should any settings

      cause problems. It is recommended that you

      <link xref="#create-profile-from-existing">create a copy of the

      default profile</link> then edit the copy to create a custom profile.

    </note>

    
You can make changes to existing profiles. To edit a profile:

    <steps>

      <item>

        
Select <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>

    </steps>

    
Once the desired profile is selected, you can:

    <steps>

      <item>

        
Select <link xref="app-fonts">font</link>,

        <link xref="app-cursor">cursor shapes</link> and

        <link xref="app-terminal-sizes"><app>Terminal</app> size</link>.

      </item>

      <item>

        
You may also change behavior of <app>Terminal</app> on

        <link xref="pref-custom-exit">command exit</link>, set a

        <link xref="pref-login-shell">custom login shell</link> or change

        <link xref="pref-scrolling">scrollbar preferences</link>.

      </item>

      <item>

        
To change the <app>Terminal</app> background and text colors, see

        <link xref="app-colors"><app>Terminal</app> color schemes</link>.

      </item>

      <item>

        
Changes to profile are saved immediately. To return to

        <app>Terminal</app>, click <gui style="button">Close</gui>.

      </item>

    </steps>

  </section>

  <section id="rename-profile" style="task">

    <title>Rename an existing profile</title>

    
You can rename existing profiles, including the default profile:

    <steps>

      <item>

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

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

      </item>

      <item>

        
Select the profile you wish to rename.

      </item>

      <item>

        
Click on the arrow next to the profile name.

      </item>

      <item>

        
Select <gui style="menuitem">Rename…</gui>.

      </item>

      <item>

        
Enter the new profile name.

      </item>

      <item>

        
Click <gui style="button">Rename</gui> to rename.

      </item>

    </steps>

  </section>

  <section id="delete-profile" style="task">

    <title>Delete a profile</title>

    
To delete a profile:

    <steps>

      <item>

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

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

      </item>

      <item>

        
Select the profile you wish to delete.

      </item>

      <item>

        
Click on the arrow next to the profile name.

      </item>

      <item>

        
Select <gui style="menuitem">Delete…</gui>.

      </item>

      <item>

        
Click <gui style="button">Delete</gui> to confirm.

      </item>

    </steps>

    <note style="tip">

      
The default profile cannot be deleted. If you wish to delete

      that profile, first set another profile as 

      xref="#set-default">default</link>.

    </note>

  </section>

  
The default profile is loaded when a new terminal is opened unless you

  have selected another profile. Any changes that you make to the settings will

  be stored in the currently selected profile.

  <section id="set-default" style="task">

    <title>Set a default profile</title>

    
The default profile is used when <app>Terminal</app> could not

    otherwise decide which profile to use. For example, <app>Terminal</app> is

    started up freshly and opens its first terminal window. In contrast, when

    you use a menu entry or keyboard shortcut of <app>Terminal</app> to open a

    new terminal, the profile of the existing terminal is used.

    <steps>

      <item>

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

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

      </item>

      <item>

        
Select the profile you wish to set as the default.

      </item>

      <item>

        
Click on the arrow next to the profile name.

      </item>

      <item>

        
Select <gui style="menuitem">Set as default</gui>.

      </item>

    </steps>

    <note>

      
The default profile is marked with a check mark symbol.

    </note>

  </section>

</page>