<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY app "GNOME Terminal">  
  <!ENTITY appversion "2.4.1">
  <!ENTITY manrevision "2.7">
  <!ENTITY date "November 2003">
]>
<!-- (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  Template version: 2.0 beta
  Template last modified Jan 2, 2002 
    
  -->
<article id="index" lang="en"> 
  <articleinfo> 
     <title>&app; Manual V&manrevision;</title> 
     <copyright> 
        <year>2002</year> 
        <year>2003</year> 
        <holder>Sun Microsystems</holder> 
     </copyright> 
     <copyright> 
        <year>2000</year> 
        <holder>Miguel de Icaza</holder> 
     </copyright> 
     <copyright> 
        <year>2000</year> 
        <holder>Michael Zucchi</holder> 
     </copyright>
     <copyright> 
        <year>2000</year> 
        <holder>Alexander Kirillov</holder> 
     </copyright>
     <publisher> 
        <publishername>GNOME Documentation Project</publishername> 
     </publisher> &legal; 
     <authorgroup> 
        <author> 
          <firstname>Sun</firstname> 
          <surname>GNOME Documentation Team</surname> 
          <affiliation> 
             <orgname>Sun Microsystems</orgname> 
          </affiliation> 
        </author> 
        <author> 
          <firstname>Miguel</firstname> 
          <surname>de Icaza</surname> 
          <affiliation> 
             <orgname>GNOME Documentation Project</orgname> 
          </affiliation> 
        </author> 
        <author> 
          <firstname>Michael</firstname> 
          <surname>Zucchi</surname> 
          <affiliation> 
             <orgname>GNOME Documentation Project</orgname> 
          </affiliation> 
        </author> 
        <author> 
          <firstname>Alexander</firstname> 
          <surname>Kirillov</surname> 
          <affiliation> 
             <orgname>GNOME Documentation Project</orgname> 
          </affiliation> 
        </author> 
     </authorgroup> 
     <revhistory> 
        <revision> 
          <revnumber>&app; Manual V&manrevision;</revnumber> 
          <date>&date;</date> 
          <revdescription> 
             <para role="author">
                Sun GNOME Documentation Team
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision> 
			<revision> 
          <revnumber>GNOME Terminal Manual V2.6</revnumber> 
          <date>September 2003</date> 
          <revdescription> 
             <para role="author">
                Sun GNOME Documentation Team
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision>
			<revision> 
          <revnumber>GNOME Terminal Manual V2.5</revnumber> 
          <date>May 2003</date> 
          <revdescription> 
             <para role="author">
                Sun GNOME Documentation Team
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision>
			<revision> 
          <revnumber>GNOME Terminal Manual V2.4</revnumber> 
          <date>January 2003</date> 
          <revdescription> 
             <para role="author">
                Sun GNOME Documentation Team
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision>
        <revision> 
          <revnumber>GNOME Terminal Manual V2.3</revnumber> 
          <date>August 2002</date> 
          <revdescription> 
             <para role="author">
                Sun GNOME Documentation Team
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision>
        <revision> 
          <revnumber>GNOME Terminal Manual V2.2</revnumber> 
          <date>August 2002</date> 
          <revdescription> 
             <para role="author">
                Sun GNOME Documentation Team
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision>
        <revision> 
          <revnumber>GNOME Terminal Manual V2.1</revnumber> 
          <date>August 2002</date> 
          <revdescription> 
             <para role="author">
                Sun GNOME Documentation Team
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision>
        <revision> 
          <revnumber>GNOME Terminal Manual V2.0</revnumber> 
          <date>April 2002</date> 
          <revdescription> 
             <para role="author">
                Sun GNOME Documentation Team
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision> 
        <revision> 
          <revnumber>GNOME Terminal User's Guide</revnumber> 
          <date>May 2000</date> 
          <revdescription> 
             <para role="author">
                Miguel de Icaza, Michael Zucchi, Alexander Kirollov
                <email>docs@gnome.org</email> 
             </para>
             <para role="publisher">
                GNOME Documentation Project 
             </para>
          </revdescription> 
        </revision> 
     </revhistory> 
     <releaseinfo> This manual describes version &appversion; of &app;.
        </releaseinfo> 
     <legalnotice> 
        <title>Feedback</title> 
        <para> To report a bug or make a suggestion regarding the &app; application or this
	       manual, follow the directions in the 
	       <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. </para>
     </legalnotice> 
  </articleinfo> 
  <indexterm> 
     <primary>&app;</primary> 
  </indexterm> 
  <indexterm> 
     <primary>terminal application</primary> 
  </indexterm> 
  <sect1 id="gnome-terminal-introduction"> 
     <title>Introduction</title> 
     <para>
        <application>&app;</application> is a terminal emulation application that
        you can use to perform the following actions: 
     </para>
     <variablelist> 
        <varlistentry> 
          <term>To access a UNIX shell in the GNOME environment</term> 
          <listitem> 
             <para>
                A shell is a program that interprets and executes the commands that
                you type at a command line prompt. When you start <application>GNOME
                Terminal</application>, the application starts the default shell that is
                specified in your system account. You can switch to a different shell at any
                time. 
             </para>
          </listitem> 
        </varlistentry> 
        <varlistentry> 
          <term>To run any application that is designed to run on VT102, VT220,
             and xterm terminals</term> 
          <listitem> 
             <para>
                <application>&app;</application> emulates the xterm program
                developed by the X Consortium. In turn, the xterm program emulates the DEC
                VT102 terminal and also supports the DEC VT220 escape sequences. An escape
                sequence is a series of characters that starts with the Esc character.
                <application>&app;</application> accepts all of the escape sequences that the
                VT102 and VT220 terminals use for functions such as to position the cursor and
                to clear the screen. 
             </para>
          </listitem> 
        </varlistentry> 
     </variablelist> 
  </sect1> 
  <sect1 id="gnome-terminal-get-started"> 
     <title>Getting Started</title> 
     <para>
        The following sections describe how to start 
        <application>&app;</application>. 
     </para>
     <sect2 id="gnome-terminal-to-start"> 
        <title>To Start &app;</title> 
        <para>
          You can start <application>&app;</application> in the following ways: 
        </para>
        <variablelist> 
          <varlistentry> 
             <term>Applications menu</term> 
             <listitem>
                <para>
                  Choose
                  <menuchoice>
                     <guimenu>System Tools</guimenu>
                     <guimenuitem>Terminal</guimenuitem>
                  </menuchoice>.</para>
             </listitem>
          </varlistentry> 
          <varlistentry> 
             <term>Command line</term> 
             <listitem> 
                <para>
                  Execute the following command: <command>gnome-terminal</command>
                </para>
                <para>
                  You can use command line options to modify the way in which you
                  run <application>&app;</application>. To view the command line options, 
						  execute the following command: <command>gnome-terminal --help</command>
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
     <sect2 id="gnome-terminal-first-start"> 
        <title>When You First Start &app;</title> 
        <para>
          When you start <application>&app;</application> for the first time, the
          application opens a terminal window with a group of default settings. The group
          of default settings is called the Default profile. The profile name appears in
          the titlebar of the <application>&app;</application> window. 
        </para>
        <figure id="gnome-terminal_default"> 
          <title>Example of a Default &app; Window</title> 
          <screenshot> 
             <screeninfo>&app; default window</screeninfo> 
             <mediaobject> 
                <imageobject>
                  <imagedata fileref="figures/gnome-terminal-default.png" format="PNG"/> 
                </imageobject> 
                <textobject> 
                  <phrase>&app; default window</phrase> 
                </textobject> 
             </mediaobject> 
          </screenshot> 
        </figure> 
        <para>
          The terminal window displays a command prompt where you can type UNIX
          commands. The command prompt can be a %, #, >, $, or any other special
          character. The cursor is positioned at the command prompt. When you type a UNIX
          command and press 
          <keycap>Return</keycap>, the computer executes the command. By default,
          <application>&app;</application> uses the default shell specified for the user
          who starts the application. 
        </para>
        <para>
          <application>&app;</application> also sets the following environment
          variables: 
        </para>
        <variablelist> 
          <varlistentry> 
             <term> 
                <varname>TERM</varname></term> 
             <listitem> 
                <para>
                  Set to xterm by default. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <varname>COLORTERM</varname></term> 
             <listitem> 
                <para>
                  Set to gnome-terminal by default. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <varname>WINDOWID</varname></term> 
             <listitem> 
                <para>
                  Set to the X11 window identifier by default. 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 

     <sect2 id="gnome-terminal-profiles"> 
        <title>Terminal Profiles</title> 
        <para>
          You can create a new profile, and apply the new profile to the terminal
          to modify characteristics such as font, color and effects, scrolling behavior,
          window title, and compatibility. You can also specify a command that runs automatically
          when you start <application>&app;</application> in the profile. </para>
          <para>You define each terminal profile in the 
          <guilabel>Edit Profiles</guilabel> dialog, which you access from the 
          <guimenu>Edit</guimenu> menu. You can define as many different
          profiles as you require. When you start a terminal, you can choose the profile
          that you want to use for the terminal or you can change the terminal profile
          while you are using the terminal. To specify an initial profile for a
          terminal when you start the application from a command line, use the following
          command: 
        </para>
        <para>
          <command>gnome-terminal --window-with-profile=<replaceable>profilename</replaceable></command> 
        </para>
        <para>
          The name of the current profile appears in the titlebar of the
          <application>&app;</application>, unless you specify a different titlebar name
          in the 
          <guilabel>Editing profile</guilabel> dialog. 
        </para>
        <para>
          See <xref linkend="gnome-terminal-manage-profiles"/> for information
          about how to define and use a new terminal profile. 
        </para>
     </sect2> 
     <sect2 id="gnome-terminal-more-windows"> 
        <title>Working With Multiple Terminals</title> 
        <para>
          <application>&app;</application> provides a tab feature that enables
          you to open several terminals in a single window.
          Each terminal opens in a separate tab.
          Click on the appropriate tab to display the terminal in the window. 
          Each tabbed terminal in a window is a separate subprocess, 
          so you can use each terminal for different tasks. You can
          apply a different profile to each tabbed terminal in the window.
       </para>
       <para>
          The titlebar
          of the terminal window shows either the name of the current profile, or the
          name specified by the current profile. <xref linkend="gnome-terminal-tabbed"/>
          shows a <application>&app;</application> window with four tabs. In this case,
          each of the four tabs has a different profile. The name of the profile in
		     the active tab, Profile 1, appears in the titlebar. 
        </para>
        <figure id="gnome-terminal-tabbed"> 
          <title>Example of a Terminal Window With Tabs</title> 
          <screenshot> 
             <screeninfo>&app; default window</screeninfo> 
             <mediaobject> 
                <imageobject>
                  <imagedata fileref="figures/gnome-terminal-tabbed.png" format="PNG"/> 
                </imageobject> 
                <textobject> 
                  <phrase>&app; default window</phrase> 
                </textobject> 
             </mediaobject> 
          </screenshot> 
        </figure> 
        <para>
          See <xref linkend="gnome-terminal-windows"/> for information about how to
          open a new tabbed terminal. 
        </para>
     </sect2> 

  </sect1> 

  <sect1 id="gnome-terminal-usage"> 
     <title>Usage</title> 

     <sect2 id="gnome-terminal-windows"> 
        <title>To Open and Close Terminals</title> 
        <variablelist> 
          <varlistentry> 
             <term>To open a new terminal window:</term> 
             <listitem> 
                <para>
                  Choose 
                  <menuchoice> 
                     <guimenu>File</guimenu> 
                     <guisubmenu>New Window</guisubmenu>
                     <guimenuitem>Default</guimenuitem> 
                  </menuchoice>. 
                </para>
                <para>
                  The new terminal inherits the application settings and default 
						  shell from the parent terminal. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To close a terminal window:</term> 
             <listitem> 
                <para>
                  Choose 
                  <menuchoice> 
                     <guimenu>File</guimenu> 
                     <guimenuitem>Close Window</guimenuitem> 
                  </menuchoice>. 
                </para>
                <para>
                  This action closes the terminal and any subprocesses that you
                  opened from the terminal. If you close the last terminal window, the
                  <application>&app;</application> program exits. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To add a new tabbed terminal to a window:</term> 
             <listitem> 
                <para>
                  Choose 
                  <menuchoice> 
                     <guimenu>File</guimenu> 
                     <guisubmenu>New Tab</guisubmenu>
                     <guimenuitem>Default</guimenuitem> 
                  </menuchoice>. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To display a tabbed terminal:</term> 
             <listitem> 
                <para>
                  Click on the tab of the tabbed terminal that you want to
                  display. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To close a tabbed terminal:</term> 
             <listitem> 
                <para>
                  <orderedlist> 
                     <listitem> 
                        <para>
                          Display the tabbed terminal that you want
                          to close. 
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Choose 
                          <menuchoice> 
                             <guimenu>File</guimenu> 
                             <guimenuitem>Close Tab</guimenuitem> 
                          </menuchoice>. 
                        </para>
                     </listitem> 
                  </orderedlist> 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
     <sect2 id="gnome-terminal-manage-profiles"> 
        <title>To Manage Profiles</title> 
        <variablelist> 
          <varlistentry> 
             <term>To add a new profile:</term> 
             <listitem> 
                <para>
                  <orderedlist> 
                     <listitem> 
                        <para>
                          Choose 
                          <menuchoice> 
                             <guimenu>File</guimenu> 
                             <guimenuitem>New Profile</guimenuitem> 
                          </menuchoice> to display the 
                          <guilabel>New Profile</guilabel> dialog. 
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Type the new profile name in the 
                          <guilabel>Profile name</guilabel> text box.
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Use the <guilabel>Base on</guilabel> drop-down list to select 
                          the profile on which you want to base the new profile.
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Click <guibutton>Create</guibutton> to display the 
                          <guilabel>Editing profile</guilabel> dialog. 
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Click <guibutton>Close</guibutton>.
                          <application>&app;</application> adds the profile to the 
                          <menuchoice> 
                             <guimenu>Terminal</guimenu> 
                             <guisubmenu>Profile</guisubmenu> 
                          </menuchoice>
                          submenu.
                        </para>
                     </listitem> 
                  </orderedlist> 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To change the profile of a tabbed terminal:</term> 
             <listitem> 
                <para>
                  <orderedlist> 
                     <listitem> 
                        <para>
                          Click on the tab of the tabbed terminal for which you
                          want to change the profile. 
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Choose 
                          <menuchoice> 
                             <guimenu>Terminal</guimenu> 
                             <guisubmenu>Profile</guisubmenu> 
                             <guimenuitem> 
                                <replaceable>profilename</replaceable></guimenuitem> 
                          </menuchoice>. 
                        </para>
                     </listitem> 
                  </orderedlist> 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To edit a profile:</term> 
             <listitem> 
                <para>
                  You edit profiles in the 
                  <guilabel>Editing profile</guilabel> dialog. You can access the 
                  <guilabel>Editing profile</guilabel> dialog in the following
                  ways: 
                </para>
                <itemizedlist> 
                  <listitem> 
                     <para>
                        Choose 
                        <menuchoice> 
                          <guimenu>Edit</guimenu> 
                          <guisubmenu>Current Profile</guisubmenu> 
                        </menuchoice>. 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        Right-click in the terminal window, then choose 
                        <guimenuitem>Edit Current Profile</guimenuitem> from the
                        popup menu. 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        Choose 
                        <menuchoice> 
                          <guimenu>Edit</guimenu> 
                          <guisubmenu>Profiles</guisubmenu> 
                        </menuchoice>, select the profile you want to edit,
                        then click 
                        <guibutton>Edit</guibutton>. 
                     </para>
                  </listitem> 
                </itemizedlist> 
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To delete a profile:</term> 
             <listitem> 
                <para>
                  <orderedlist> 
                     <listitem> 
                        <para>
                          Choose 
                          <menuchoice> 
                             <guimenu>Edit</guimenu> 
                             <guimenuitem>Profiles</guimenuitem> 
                          </menuchoice>. 
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Select the name of the profile that you want to delete in
                          the 
                          <guilabel>Profiles</guilabel> list, then click 
                          <guibutton>Delete</guibutton>. The 
                          <guilabel>Delete Profile</guilabel> dialog is displayed. 
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Click <guibutton>Delete</guibutton> to confirm the deletion.
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Click <guibutton>Close</guibutton> to close the 
                          <guilabel>Edit Profiles</guilabel> dialog. 
                        </para>
                     </listitem> 
                  </orderedlist> 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
     <sect2 id="gnome-terminal-tabs"> 
        <title>To Modify a Terminal Window</title> 
        <variablelist> 
          <varlistentry> 
             <term>To hide the menubar:</term> 
             <listitem> 
                <para>
                  Right-click on the terminal window, then choose 
                  <guimenuitem>Hide Menubar</guimenuitem> from the popup menu. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To show a hidden menubar:</term> 
             <listitem> 
                <para>
                  Right-click on the terminal window, then choose 
                  <guimenuitem>Show Menubar</guimenuitem> from the popup menu. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To change the appearance of the terminal window:</term> 
             <listitem> 
                <para>
                  See 
                  <xref linkend="gnome-terminal-prefs"/> for 
                  information about the options that you can choose in the 
                  <guilabel>Editing profile</guilabel> dialog to change the
                  appearance of the terminal window. For example, you can
                  change the background color, or the location of the scrollbar. 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
     <sect2 id="gnome-terminal-contents"> 
        <title>To Work With the Contents of Terminal Windows</title> 
        <variablelist> 
          <varlistentry> 
             <term>To scroll through previous commands and output:</term> 
             <listitem> 
                <para>
                  Perform one of the following actions: 
                </para>
                <itemizedlist> 
                  <listitem> 
                     <para>
                        Use the scrollbar, which is usually displayed on the right of
                        the terminal window. 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        Press the 
                        <keycombo><keycap>Shift</keycap><keycap>Page Up</keycap></keycombo>, 
                        <keycombo><keycap>Shift</keycap><keycap>Page Down</keycap></keycombo>, 
                        <keycombo><keycap>Shift</keycap><keycap>Home</keycap></keycombo>, or 
                        <keycombo><keycap>Shift</keycap><keycap>End</keycap></keycombo> keys. 
                     </para>
                  </listitem> 
                </itemizedlist> 
                <para>
                  The number of lines that you can scroll back to in the terminal
                  window is determined by the 
                  <guilabel>Scrollback</guilabel> setting in the 
                  <guilabel>Scrolling</guilabel> tabbed section of the 
                  <guilabel>Editing profiles</guilabel> dialog. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To select and copy text:</term> 
             <listitem> 
                <para>
                  You can select text in any of the following ways: 
                </para>
                <itemizedlist> 
                  <listitem> 
                     <para>
                        To select a character at a time, click on the first character
                        that you want to select and drag the mouse to the last character that you want
                        to select. 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        To select a word at a time, double-click on the first word
                        that you want to select and drag the mouse to the last word that you want to
                        select. 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        To select a line at a time, triple-click on the first line
                        that you want to select and drag the mouse to the last line that you want to
                        select. 
                     </para>
                  </listitem> 
                </itemizedlist> 
                <para>
                  These actions select all text between the first and last
                  items. For all text selections, <application>&app;</application> copies
                  the selected text into the clipboard when you release the mouse button. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To paste text into a terminal:</term> 
             <listitem> 
                <para>
                  If you previously copied text to the clipboard, you can paste the text 
                  into a terminal by performing one of the following actions: 
                </para>
                <itemizedlist> 
                  <listitem> 
                     <para>
                        Middle-click at the command prompt. If you do not have a
                        middle mouse button, refer to the X Server documentation for information about
                        how to emulate the middle mouse button. 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        Choose 
                        <menuchoice> 
                          <guimenu>Edit</guimenu> 
                          <guimenuitem>Paste</guimenuitem> 
                        </menuchoice>.
                     </para>
                  </listitem> 
                </itemizedlist> 
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To drag a file name into a terminal window:</term> 
             <listitem> 
                <para>
                  You can drag a file name to a terminal from another application such as a file
                  manager. The terminal displays the path and the full name of the
                  file. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term>To access a link:</term> 
             <listitem> 
                <para>
                  To access a Uniform Resource Locator (URL) that is displayed in a
                  terminal, perform the following steps: </para>
                  <orderedlist> 
                     <listitem> 
                        <para>
                          Move the mouse over the URL until the URL is underlined.
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Right-click on the URL to open a popup menu. 
                        </para>
                     </listitem> 
                     <listitem> 
                        <para>
                          Choose 
                          <guimenuitem>Open Link</guimenuitem> to start a link
                          application and display the file located at the URL. 
                        </para>
                     </listitem> 
                  </orderedlist>                
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
     
     <sect2 id="gnome-terminal-shortcuts"> 
        <title>To View the Keyboard Shortcut Settings</title> 
        <para>
          To view the keyboard shortcut settings that are defined for <application>&app;</application>,
          choose 
          <menuchoice> 
               <guimenu>Edit</guimenu> 
               <guimenuitem>Keyboard Shortcuts</guimenuitem> 
          </menuchoice>. The <guilabel>Keyboard Shortcuts Editor</guilabel> dialog contains
          the following items:
        </para>
        <variablelist> 
          <varlistentry> 
             <term><guilabel>Disable all menu access keys</guilabel></term> 
             <listitem> 
                <para>
                  Select this check box to disable the access keys that are defined to
                  enable you to use the keyboard instead of the mouse to select a menu item. 
                  Each access key is identified by an underlined letter on 
                  a menu or dialog option. In some cases, you must press the 
                  <keycap>Alt</keycap> key in combination with the access key to 
                  perform the action. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term><guilabel>Disable menu shortcut key</guilabel></term> 
             <listitem> 
                <para>
                  Select this check box to disable the shortcut key that is defined to
                  enable you to access the <application>&app;</application> menus.
                  The default shortcut key for accessing the menus is <keycap>F10</keycap>.
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term><guilabel>Shortcut Keys</guilabel></term> 
             <listitem> 
                <para>
                  The <guilabel>Shortcut Keys</guilabel> section of the dialog
                  lists the shortcut keys that are defined for each menu item.
                  The shortcut keys enable you to use the keyboard to choose
                  a menu item rather than using the mouse. The shortcut key is
                  usually a combination of keys that you press simultaneously.
                </para>
             </listitem> 
          </varlistentry>
        </variablelist> 
     </sect2>
     
     <sect2 id="gnome-terminal-reset"> 
        <title>To Recover Your Terminal</title> 
        <para>
          This section provides some advice if you have problems with
          terminals. 
        </para>
        <variablelist> 
          <varlistentry> 
             <term>To reset the state of the terminal:</term> 
             <listitem> 
                <para>
                  Choose 
                  <menuchoice> 
                     <guimenu>Terminal</guimenu> 
                     <guimenuitem>Reset</guimenuitem> 
                  </menuchoice>. 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
        <variablelist> 
          <varlistentry> 
             <term>To reset the terminal and clear the screen:</term> 
             <listitem> 
                <para>
                  Choose 
                  <menuchoice> 
                     <guimenu>Terminal</guimenu> 
                     <guimenuitem>Reset and Clear</guimenuitem> 
                  </menuchoice>. 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2>   

<!-- 
<sect2 id="gnome-terminal-direct-input">
<title>To Direct All Keyboard Input to a Terminal</title>
<para>
   To direct all keyboard input to the terminal, even when the terminal window is
   not in focus, right-click in the terminal window to display a popup menu, then
   choose <guimenuitem>Secure keyboard</guimenuitem>. This option is useful when
   several users use the same X server and the X server does not use secure authentication
   methods.
</para>
</sect2>
-->

  </sect1> 

  <sect1 id="gnome-terminal-prefs"> 
     <title>Preferences</title> 
     <para>
        To configure <application>&app;</application>, choose 
        <menuchoice> 
          <guimenu>Edit</guimenu> 
          <guimenuitem>Current Profile</guimenuitem> 
        </menuchoice>. To configure another profile that you set up choose
         <menuchoice> 
          <guimenu>Edit</guimenu> 
          <guimenuitem>Profiles</guimenuitem> 
        </menuchoice>, select the profile you want to edit, then click <guibutton>Edit</guibutton>.
     </para>
     <para>  
        The <guilabel>Editing profile "<replaceable>profile name</replaceable>"</guilabel> dialog
        contains the following tabbed sections that you can use to configure <application>&app;</application>:
     </para>
     <itemizedlist> 
		<listitem><para><xref linkend="gnome-terminal-prefs-general"/></para>
		</listitem>
		<listitem><para><xref linkend="gnome-terminal-prefs-title"/></para>
		</listitem>
		<listitem><para><xref linkend="gnome-terminal-prefs-colors"/></para>
		</listitem>
		<listitem><para><xref linkend="gnome-terminal-prefs-effects"/></para>
		</listitem>
		<listitem><para><xref linkend="gnome-terminal-prefs-scrolling"/></para>
		</listitem>
		<listitem><para><xref linkend="gnome-terminal-prefs-compatibility"/></para>
		</listitem>
	 </itemizedlist>

     
     <sect2 id="gnome-terminal-prefs-general"> 
        <title>General</title> 
        <variablelist> 
          <varlistentry> 
             <term> 
                <guilabel>Profile name</guilabel> </term> 
             <listitem> 
                <para>
                  Use this text box to specify the name of the current profile. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Use the system terminal font</guilabel> </term> 
             <listitem> 
                <para>
                  Select this option to use the standard application font that is specified in the 
                  <application>Font</application> preference tool. 
                </para>
             </listitem> 
          </varlistentry>
          <varlistentry> 
             <term> 
                <guilabel>Font</guilabel> </term> 
             <listitem> 
                <para>
                  Click on this button to select a font type and font size for the terminal. This button is
                  only available if the <guilabel>Use the system terminal font</guilabel> option
                  is unselected.
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Profile icon</guilabel> </term> 
             <listitem> 
                <para>
                  Click on this button to select an icon to represent terminal windows that use the current profile. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Allow bold text</guilabel> </term> 
             <listitem> 
                <para>
                  Select this option to enable the terminal to display bold text. 
                </para>
             </listitem> 
          </varlistentry>
          <varlistentry> 
             <term> 
                <guilabel>Cursor blinks</guilabel> </term> 
             <listitem> 
                <para>
                  Select this option to display a blinking cursor. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Show menubar by default in new terminals</guilabel>
                </term> 
             <listitem> 
                <para>
                  Select this option to show the menubar on new terminal windows. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Terminal bell</guilabel> </term> 
             <listitem> 
                <para>
                  Select this option to disable the terminal bell. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Select-by-word characters</guilabel> </term> 
             <listitem> 
                <para>
                  Use this text box to specify characters or groups of characters
                  that <application>&app;</application> considers to be words when you select
                  text by word. See <xref linkend="gnome-terminal-contents"/> for more
                  information about how to select text by word. 
                </para>
             </listitem> 
          </varlistentry> 
          
        </variablelist> 
     </sect2> 
     <sect2 id="gnome-terminal-prefs-title"> 
        <title>Title and Command</title> 
        <variablelist> 
          <varlistentry> 
             <term> 
                <guilabel>Initial title</guilabel> </term> 
             <listitem> 
                <para>
                  Use this text box to specify the initial title of terminals that use the profile.
                  New terminals that are started from the current terminal have the new initial
                  title. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Dynamically-set title</guilabel> </term> 
             <listitem> 
                <para>
                  Use this drop-down list to specify how to handle dynamically-set titles, that is, terminal titles set by commands that run in the terminal.
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Run command as a login shell</guilabel> </term> 
             <listitem> 
                <para>
                  Select this option to make the command running inside the
                  terminal to be run as a login shell. If the command is not a shell, then the
                  setting has no effect. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Update utmp/wtmp records when command is
                  launched</guilabel> </term> 
             <listitem> 
                <para>
                  Select this option to insert a new entry in the utmp and wtmp
                  records when a new shell is opened. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Run a custom command instead of my shell</guilabel>
                </term> 
             <listitem> 
                <para>
                  Select this option to run a command in the terminal other than
                  the normal shell. Specify the custom command in the 
                  <guilabel>Custom command</guilabel> text box. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>When command exits</guilabel> </term> 
             <listitem> 
                <para>
                  Use this drop-down list to specify what action to perform 
                  when the terminal exits. 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
     <sect2 id="gnome-terminal-prefs-colors"> 
        <title>Colors</title> 
        <variablelist> 
        <varlistentry> 
             <term> 
                <guilabel>Use colors from system theme</guilabel>
                </term> 
             <listitem> 
                <para>
                  Select this option to use the colors that are specified in the GNOME Desktop theme that is selected 
                  in the <application>Theme</application> preference tool. 
                </para>
             </listitem> 
          </varlistentry>
          <varlistentry> 
             <term> 
                <guilabel>Built-in schemes - Foreground and Background</guilabel> </term> 
             <listitem> 
                <para>
                  Use the drop-down list to specify the foreground and
                  background colors for the terminal. <application>&app;</application> supports
                  the following foreground and background color combinations: 
                </para>
                <itemizedlist> 
                  <listitem> 
                     <para>
                        <guilabel>Black on light yellow</guilabel> 
                     </para>
                  </listitem>
                  <listitem> 
                     <para>
                        <guilabel>Black on white</guilabel> 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        <guilabel>Gray on black</guilabel> 
                     </para>
                  </listitem>             
                  <listitem> 
                     <para>
                        <guilabel>Green on black</guilabel> 
                     </para>
                  </listitem>             
                  <listitem> 
                     <para>
                        <guilabel>White on black</guilabel> 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        <guilabel>Custom</guilabel> 
                     </para>
                     <para>
                        This option enables you to select colors that are not in the
                        selected color scheme. 
                     </para>
                  </listitem> 
                </itemizedlist> 
                <para>
                  The actual display of the foreground and background colors can
                  vary depending on the color scheme that you choose. For example, if you choose 
                  <guilabel>White on black</guilabel> and the 
                  <guilabel>Linux console</guilabel> color scheme, the application
                  displays the foreground and background colors as light gray on black. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Text color</guilabel> </term> 
             <listitem> 
                <para>
                  Click on the 
                  <guibutton>Text color</guibutton> button to display the 
                  <guilabel>Choose terminal text color</guilabel> dialog. Choose
                  the color that you want to use as the foreground color from the color palette.
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Background color</guilabel> </term> 
             <listitem> 
                <para>
                  Click on the 
                  <guibutton>Background color</guibutton> button to display the 
                  <guilabel>Choose terminal background color</guilabel> dialog.
                  Choose the color that you want to use as the background color from the color
                  palette. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Built-in schemes - Palette</guilabel></term> 
             <listitem> 
                <para>
                  A color scheme is a palette of 16 colors. Use the drop-down list
                  box to choose the color scheme that you want to use.
                  <application>&app;</application> supports the following color schemes: 
                </para>
                <itemizedlist> 
                  <listitem> 
                     <para>
                        <guilabel>Linux console</guilabel> 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        <guilabel>Xterm</guilabel> 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        <guilabel>Rxvt</guilabel> 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        <guilabel>Custom</guilabel> 
                     </para>
                  </listitem> 
                </itemizedlist> 
                <para>
                  Each color scheme is slightly different. For example, 
                  <guilabel>Linux console</guilabel> uses light gray instead of
                  white. The 
                  <guilabel>Custom </guilabel>color scheme enables you to create a
                  customized color palette. 
                </para>
             </listitem> 
          </varlistentry>
 
          <varlistentry> 
             <term> 
                <guilabel>Color palette</guilabel> </term> 
             <listitem> 
                <para>
                  Use the 
                  <guilabel>Color palette</guilabel> to customize the 16 default
                  colors in the custom color palette. To customize a color, click on the color to
                  display the 
                  <guilabel>Palette entry</guilabel> dialog. Use the color wheel or
                  the spin boxes to customize the color, then click 
                  <guibutton>OK</guibutton>. 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
     <sect2 id="gnome-terminal-prefs-effects"> 
        <title>Effects</title> 
        <variablelist> 
          <varlistentry> 
             <term> 
                <guilabel>Background</guilabel> </term> 
             <listitem> 
                <para>
                  Select a background for the terminal window. The
                  options are as follows: 
                </para>
                <itemizedlist> 
                  <listitem> 
                     <para>
                        <guilabel>None (use solid color)</guilabel> 
                     </para>
                     <para>
                        Select this option to use the background color that is
                        specified in the 
                        <guilabel>Colors</guilabel> tabbed section as the background
                        color for the terminal. 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        <guilabel>Background image</guilabel> 
                     </para>
                     <para>
                        Select this option to use an image file as the background for
                        the terminal. Use the 
                        <guilabel>Image file</guilabel> drop-down combination box to
                        specify the location and name of the image file. Alternatively, click 
                        <guibutton>Browse</guibutton> to search for and select the
                        image file. 
                     </para>
                  </listitem> 
                  <listitem> 
                     <para>
                        <guilabel>Transparent background</guilabel> 
                     </para>
                     <para>
                        Select this option to use a transparent background for the
                        terminal. 
                     </para>
                  </listitem> 
                </itemizedlist> 
             </listitem> 
          </varlistentry>
          <varlistentry> 
             <term> 
                <guilabel>Background image scrolls</guilabel>
                </term> 
             <listitem> 
                <para>Select this option to 
                     enable the background image to scroll with the text when you scroll through 
                     the terminal. If you do not select this option, the background image remains 
                     fixed on the terminal background and only the text scrolls. This option is only
                     available if you select the <guilabel>Background image</guilabel> option.
                </para>
             </listitem>
          </varlistentry>        
          <varlistentry> 
             <term> 
                <guilabel>Shade transparent or image background</guilabel>
                </term> 
             <listitem> 
                <para>
                  Use this slider to shade or dim the background of the
                  terminal. This option is only available if you select the 
                  <guilabel>Background image</guilabel> or 
                  <guilabel>Transparent background</guilabel> options. 
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
     
     <sect2 id="gnome-terminal-prefs-scrolling">
    <title>Scrolling</title>
     <variablelist>
     <varlistentry> 
             <term> 
                <guilabel>Scrollbar is</guilabel> </term> 
             <listitem> 
                <para>
                  Use this drop-down list to specify the position of the
                  scrollbar on the terminal window. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Scrollback ... lines</guilabel> </term> 
             <listitem> 
                <para>
                  Use this spin box to specify the number of lines that you can
                  scroll back using the scrollbar. For example, if you specify 100 you
                  can scroll back the last 100 lines displayed in the terminal. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Scrollback ... kilobytes</guilabel> </term> 
             <listitem> 
                <para>
                  Use this spin box to specify the number of kilobytes that you can
                  scroll back using the scrollbar. For example, if you specify 94 you can
                  scroll back the last 94 kilobytes displayed in the terminal. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Scroll on output</guilabel> </term> 
             <listitem> 
                <para>
                  Select this option to enable you to scroll the output on
                  the terminal while the terminal continues to display more output from a
                  command. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Scroll on keystroke</guilabel> </term> 
             <listitem> 
                <para>
                  Select this option to enable you to press any key on the keyboard
						  to scroll down the terminal window to the command prompt. This 
						  action only applies if you scrolled up the terminal window and
                  you want to return to the command prompt. 	 
                </para>
             </listitem> 
          </varlistentry> 
          </variablelist>
     </sect2>
     
     <sect2 id="gnome-terminal-prefs-compatibility"> 
        <title>Compatibility</title> 
        <variablelist> 
          <varlistentry> 
             <term> 
                <guilabel>Backspace key generates</guilabel> </term> 
             <listitem> 
                <para>
                  Use the drop-down list to select the function that you want the 
                  <keycap>Backspace</keycap> key to perform. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guilabel>Delete key generates</guilabel> </term> 
             <listitem> 
                <para>
                  Use the drop-down list to select the function that you want the 
                  <keycap>Delete</keycap> key to perform. 
                </para>
             </listitem> 
          </varlistentry> 
          <varlistentry> 
             <term> 
                <guibutton>Reset compatibility options to defaults</guibutton> </term> 
             <listitem> 
                <para>
                  Click on this button to reset the options on the <guilabel>Compatibility</guilabel>
                  tabbed section to the default settings.
                </para>
             </listitem> 
          </varlistentry> 
        </variablelist> 
     </sect2> 
  </sect1> 
</article> 
