~ubuntu-branches/ubuntu/oneiric/xfce4-terminal/oneiric

« back to all changes in this revision

Viewing changes to doc/html/hr/advanced.html

  • Committer: Bazaar Package Importer
  • Author(s): Lionel Le Folgoc
  • Date: 2011-01-30 18:02:08 UTC
  • mfrom: (1.3.7 upstream)
  • Revision ID: james.westby@ubuntu.com-20110130180208-ivounjufdj1gjmog
Tags: 0.4.6-0ubuntu1
* New upstream release.
* Switch to 3.0 (quilt) source format.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Advanced topics</title><link rel="stylesheet" href="../terminal.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Terminal Emulator"><link rel="up" href="index.html" title="Terminal Emulator"><link rel="prev" href="command-line.html" title="Command line options"><link rel="next" href="faq.html" title="Frequently asked questions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Advanced topics</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="command-line.html">Natrag</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="faq.html">Naprijed</a></td></tr></table><hr></div><div class="sect1" title="Advanced topics"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="advanced"></a>Advanced topics</h2></div></div></div><div class="sect2" title="Files and Environment Variables"><div class="titlepage"><div><div><h3 class="title"><a name="files-and-env-vars"></a>Files and Environment Variables</h3></div></div></div><p>
2
 
      Terminal uses the Basedir Specification as defined on
3
 
      <a class="ulink" href="http://freedesktop.org/" target="_top">Freedesktop.org</a> to locate its
4
 
      data and configuration files. This means that file locations will be specified as
5
 
      a path relative to the directories described in the specification.
6
 
    </p><div class="variablelist"><dl><dt><span class="term"><code class="varname">${XDG_CONFIG_HOME}</code></span></dt><dd><p>
7
 
            The first base directory to look for configuration
8
 
            files. By default this is set to <code class="filename">~/.config/</code>.
9
 
          </p></dd><dt><span class="term"><code class="varname">${XDG_CONFIG_DIRS}</code></span></dt><dd><p>
10
 
            A colon separated list of base directories that contain configuration
11
 
            data. By default the application will look in <code class="filename">${sysconfdir}/xdg/</code>.
12
 
            The value of <code class="varname">${sysconfdir}</code> depends on how the program was
13
 
            build and will often be <code class="filename">/etc/</code>
14
 
            for binary packages.
15
 
          </p></dd><dt><span class="term"><code class="varname">${XDG_DATA_HOME}</code></span></dt><dd><p>
16
 
            The root for all user-specific data files. By default this
17
 
            is set to <code class="filename">~/.local/share/</code>.
18
 
          </p></dd><dt><span class="term"><code class="varname">${XDG_DATA_DIRS}</code></span></dt><dd><p>
19
 
            A set of preference ordered base directories relative to which
20
 
            data files should be searched in addition to the
21
 
            <code class="varname">${XDG_DATA_HOME}</code> base directory. The directories
22
 
            should be separated with a colon.
23
 
          </p></dd></dl></div><div class="variablelist"><dl><dt><span class="term"><code class="filename">${XDG_CONFIG_DIRS}/Terminal/terminalrc</code></span></dt><dd><p>
24
 
            This is the location of the configuration file that includes the
25
 
            preferences which control the look and feel of Terminal.
26
 
          </p></dd><dt><span class="term"><code class="filename">${XDG_DATA_DIRS}/Terminal/Terminal-toolbars.ui</code></span></dt><dd><p>
27
 
            This file includes the user interface definition for the toolbars. If
28
 
            you customize the toolbars using the graphical toolbars editor, Terminal
29
 
            will store the new toolbars layout in the file
30
 
            <code class="filename">${XDG_DATA_HOME}/Terminal/Terminal-toolbars.ui</code>.
31
 
          </p></dd></dl></div></div><div class="sect2" title="Hidden options"><div class="titlepage"><div><div><h3 class="title"><a name="hidden-options"></a>Hidden options</h3></div></div></div><p>
32
 
        Terminal offers a few hidden options to allow powerusers to control various advanced settings and
33
 
        to reduce the number of options in the user interface. To set any of these options, you will have
34
 
        to open the file <code class="filename">${XDG_CONFIG_HOME}/Terminal/terminalrc</code> in your favorite
35
 
        text editor and edit the section <code class="varname">[Configuration]</code>; simply create the file if
36
 
        it does not already exist. For example, your <code class="filename">terminalrc</code> could look like
37
 
      </p><pre class="programlisting">
38
 
[Configuration]
39
 
MiscAlwaysShowTabs=TRUE
40
 
MiscBell=TRUE
41
 
MiscConfirmClose=FALSE
42
 
MiscCursorBlinks=TRUE
43
 
MiscCursorShape=TERMINAL_CURSOR_SHAPE_BLOCK
44
 
MiscCycleTabs=FALSE
45
 
MiscInheritGeometry=TRUE
46
 
MiscMouseAutohide=FALSE
47
 
MiscTabCloseButtons=TRUE
48
 
MiscTabCloseMiddleClick=TRUE
49
 
MiscTabPosition=GTK_POS_TOP
50
 
MiscHighlightUrls=TRUE</pre><p>
51
 
        plus all the options that are controlled through the preferences dialog.
52
 
      </p><div class="variablelist"><dl><dt><span class="term"><code class="varname">MiscAlwaysShowTabs</code></span></dt><dd><p>
53
 
              If <code class="literal">TRUE</code> the tab headers will always be displayed even if only a single
54
 
              terminal tab is open. This option is useful if you do not want the terminal window to
55
 
              resize when you open a second tab. It is disabled by default.
56
 
            </p></dd><dt><span class="term"><code class="varname">MiscBell</code></span></dt><dd><p>
57
 
              Enables (<code class="varname">MiscBell=TRUE</code>) or disables (<code class="varname">MiscBell=FALSE</code>)
58
 
              the audible terminal bell. It is disabled by default.
59
 
            </p></dd><dt><span class="term"><code class="varname">MiscConfirmClose</code></span></dt><dd><p>
60
 
              Controls whether Terminal popups a confirmation dialog when the user tries to close
61
 
              a terminal window with multiple tabs in it. Can be either <code class="literal">TRUE</code>
62
 
              (the default) or <code class="literal">FALSE</code>.
63
 
            </p></dd><dt><span class="term"><code class="varname">MiscCursorBlinks</code></span></dt><dd><p>
64
 
              Enable this option to display a cursor that blinks. Can be either <code class="literal">TRUE</code>
65
 
              or <code class="literal">FALSE</code> (the default).
66
 
            </p></dd><dt><span class="term"><code class="varname">MiscCursorShape</code></span></dt><dd><p>
67
 
              Specifies the shape of the cursor in the terminal. This can be either
68
 
              <code class="literal">TERMINAL_CURSOR_SHAPE_BLOCK</code> (the default),
69
 
              <code class="literal">TERMINAL_CURSOR_SHAPE_IBEAM</code> or
70
 
              <code class="literal">TERMINAL_CURSOR_SHAPE_UNDERLINE</code>. This option is
71
 
              only available when you compile against VTE 0.19.1 or newer.
72
 
            </p></dd><dt><span class="term"><code class="varname">MiscCycleTabs</code></span></dt><dd><p>
73
 
              This option controls whether you can circulate through terminal tabs. That is, whether
74
 
              you are able to go from the last tab to the first tab using the <span class="guimenuitem"><strong>Next
75
 
              Tab</strong></span> button from the <span class="guimenu"><strong>Go</strong></span> menu (or the associated keyboard
76
 
              shortcut), and from the first tab to the last tab using the <span class="guimenuitem"><strong>Previous
77
 
              Tab</strong></span> button from the <span class="guimenu"><strong>Go</strong></span> menu. The option can be either
78
 
              <code class="literal">TRUE</code> (the default) or <code class="literal">FALSE</code>.
79
 
            </p></dd><dt><span class="term"><code class="varname">MiscDefaultGeometry</code></span></dt><dd><p>
80
 
              The default geometry for new Terminal windows if no <a class="xref" href="command-line.html#options-window-geometry">
81
 
            <code class="option">--geometry=<em class="replaceable"><code>geometry</code></em></code>
82
 
          </a>
83
 
              option is specified on the command line (defaults to <code class="literal">80x24</code>).
84
 
            </p></dd><dt><span class="term"><code class="varname">MiscInheritGeometry</code></span></dt><dd><p>
85
 
              This setting controls whether new windows will inherit the geometry (width
86
 
              and height of the active tab) from its parent window (the window from which
87
 
              the new window was opened). Can be either <code class="literal">TRUE</code> or
88
 
              <code class="literal">FALSE</code> (the default).
89
 
            </p></dd><dt><span class="term"><code class="varname">MiscMouseAutohide</code></span></dt><dd><p>
90
 
              This setting controls whether Terminal will hide the mouse cursor
91
 
              while you are typing in a terminal window. Can be either
92
 
              <code class="literal">TRUE</code> or <code class="literal">FALSE</code> (the default).
93
 
            </p></dd><dt><span class="term"><code class="varname">MiscTabCloseButtons</code></span></dt><dd><p>
94
 
              This setting controls whether Terminal provides a close button with the
95
 
              terminal tab title. Can be either <code class="literal">TRUE</code> (the default) or
96
 
              <code class="literal">FALSE</code>.
97
 
            </p></dd><dt><span class="term"><code class="varname">MiscTabCloseMiddleClick</code></span></dt><dd><p>
98
 
              This setting controls whether Terminal will close a terminal tab when
99
 
              the user middle-clicks the tab title. Can be either <code class="literal">TRUE</code>
100
 
              (the default) or <code class="literal">FALSE</code>.
101
 
            </p></dd><dt><span class="term"><code class="varname">MiscTabPosition</code></span></dt><dd><p>
102
 
              Specifies the position where the tab headers should be displayed. This can
103
 
              be either <code class="literal">GTK_POS_TOP</code> (the default), <code class="literal">GTK_POS_LEFT</code>,
104
 
              <code class="literal">GTK_POS_BOTTOM</code> or <code class="literal">GTK_POS_RIGHT</code>. If you
105
 
              specify <code class="literal">GTK_POS_LEFT</code> or <code class="literal">GTK_POS_RIGHT</code>
106
 
              here, the tab header texts will be displayed vertically instead of horizontally.
107
 
              It is highly recommended to disable <code class="varname">MiscTabCloseButtons</code> for
108
 
              <code class="literal">GTK_POS_LEFT</code> and <code class="literal">GTK_POS_RIGHT</code>.
109
 
            </p></dd><dt><span class="term"><code class="varname">MiscHighlightUrls</code></span></dt><dd><p>
110
 
              This setting controls whether URLs - both hyperlinks and email addresses - will
111
 
              be highlighted in the text displayed in a terminal window. If you change this
112
 
              option to <code class="literal">FALSE</code>, URLs won't be highlighted anymore and you
113
 
              will no longer be able to middle-click the URL to open it in the preferred
114
 
              application.
115
 
            </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="command-line.html">Natrag</a>�</td><td width="20%" align="center">�</td><td width="40%" align="right">�<a accesskey="n" href="faq.html">Naprijed</a></td></tr><tr><td width="40%" align="left" valign="top">Command line options�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Po&#269;etak</a></td><td width="40%" align="right" valign="top">�Frequently asked questions</td></tr></table></div></body></html>