<page xmlns="http://projectmallard.org/1.0/"
      type="guide"
      id="gs-tabs">

  <info>
    <revision version="0.1" date="2013-02-17" status="candidate"/>
    <link type="guide" xref="index#getting-started"/>
    <link type="seealso" xref="pref-title"/>

    <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</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>Add, remove and reorder <app>Terminal</app> tabs.</desc>
  </info>

  <title>Manage tabs</title>

  <p>The tab bar appears at the top a <app>Terminal</app> window that has
  multiple tabs open in what looks like a row of buttons, which you can click
  to change between tabs. You can open multiple tabs to manage your work in
  <app>Terminal</app>. This will allow you to multi-task with activities such
  as running programs, browsing directories and editing text files in a single
  <app>Terminal</app> window.</p>

  <section id="add-tab">
    <title>Open a new tab</title>

    <p>To open a new tab inside your current <app>Terminal</app> window:</p>
    <steps>
      <item>
        <p>Select <guiseq><gui style="menu">File</gui> <gui
        style="menuitem">Open tab</gui></guiseq>.</p>
      </item>
    </steps>

    <p>Alternatively, to open a new tab you can press
    <keyseq><key>Shift</key><key>Ctrl</key><key>T</key></keyseq>.</p>

  </section>

  <section id="rename-tab">
    <title>Rename a tab</title>

    <p>Each tab has an automatically assigned title. You can rename the tabs
    individually:</p>

    <steps>
      <item>
        <p>Select <guiseq><gui style="menu">Terminal</gui>
        <gui style="menuitem">Set Title…</gui></guiseq>.</p>
      </item>
      <item>
        <p>Enter the <gui>Title</gui> that you wish to use, enter the
        desired name for the tab. This will overwrite any titles that would be
        set by terminal commands.</p>
        <note>
          <p>It is not possible to unset a title once it has been set for a
          tab. To see the title, you need to allow terminal command titles to
          be shown in the <gui style="menuitem">Profile Preferences</gui>.</p>
        </note>
      </item>
      <item>
        <p>Click <gui style="button">OK</gui>.</p>
      </item>
    </steps>
  </section>

  <section id="close-tab">
    <title>Remove a tab</title>

    <p>To close an existing tab inside your current <app>Terminal</app>
    window:</p>
    <steps>
      <item>
        <p>Select <guiseq><gui style="menu">File</gui>
	<gui style="menuitem">Close Tab</gui></guiseq>.</p>
      </item>
    </steps>

    <p>Alternatively, you can click on the <gui style="button">×</gui> in the
    top right corner of the tab or right click on the tab and select
    <gui style="menuitem">Close Tab</gui>.</p>

  </section>

  <section id="reorder-tab">
    <title>Reorder tabs</title>

    <p>To change the ordering of tabs in a window:</p>
    <steps>
      <item>
        <p>Click and hold the left mouse button on the tab.</p>
      </item>
      <item>
        <p>Drag the tab to the desired position amongst the other tabs.</p>
      </item>
      <item>
        <p>Release the mouse button.</p>
      </item>
    </steps>

    <p>The tab will be placed in the position closest to where you released the
    tab, immediately beside other open tabs.</p>

    <p>Alternatively, you can reorder a tab by right clicking on a tab and
    selecting <gui style="menuitem">Move Tab Left</gui> to move the tab to the
    left or <gui style="menuitem">Move Tab Right</gui> to move the tab to the
    right. This will reorder the tab position by moving it one place at a
    time.</p>

  </section>

  <section id="move-tab-another-window">
    <title>Move a tab to another <app>Terminal</app> window</title>

    <p>If you want to move a tab from one window to another:</p>
    <steps>
      <item>
        <p>Click and hold the left mouse button on the tab.</p>
      </item>
      <item>
        <p>Drag the tab to the new window.</p>
      </item>
      <item>
        <p>Place it beside other tabs in the new window.</p>
      </item>
      <item>
        <p>Release the mouse button.</p>
      </item>
    </steps>

    <note style="tip">
      <p>You can move a tab from one window to another by dragging the tab to
      the <gui>Activities</gui> hot-corner of the <gui>GNOME Shell</gui>. This
      will reveal each of the open <app>Terminal</app> windows. You can release
      the tab that you are holding over the desired <app>Terminal</app>
      window.</p>
    </note>
  </section>

  <section id="move-tab-create-window">
    <title>Move a tab to create a new <app>Terminal</app> window</title>

    <p>To create a new window from an existing tab:</p>
    <steps>
      <item>
        <p>Click and hold the left mouse button on the tab.</p>
      </item>
      <item>
        <p>Drag the tab out of the current <app>Terminal</app> window.</p>
      </item>
      <item>
        <p>Release the mouse button.</p>
      </item>
    </steps>
  </section>

</page>
