itdominator/terminator
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
527d892ebd
terminator/doc/manual/_build/html/grouping.html
Stephen Boddy 1d977cc6aa A manual has been added to Terminator 
* Added source and generated html of manual, and API doc
* setup.py can install the manual (and by extension do can debuild)
* setup.py has (inactive) code for generating the html from the source
  but this will break if rtd theme is not available
* A few changes to doc strings to make the autodoc prettier
* Added help shortcut, by default F1 to open the local manual
* Added button to About tab to launch manual
* A couple of additional string to translate related to manual/help
2015-08-08 04:11:30 +02:00

583 lines
30 KiB
HTML
Raw Blame History

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>The Grouping Menu &mdash; Terminator 1.0 alpha documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="top" title="Terminator 1.0 alpha documentation" href="index.html"/>
<link rel="next" title="Plugins" href="plugins.html"/>
<link rel="prev" title="Layouts and the Layout Launcher" href="layouts.html"/>
<script src="_static/js/modernizr.min.js"></script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-nav-search">
<a href="index.html" class="icon icon-home"> Terminator
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption"><span class="caption-text">Contents:</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="licensing.html">Licensing</a></li>
<li class="toctree-l1"><a class="reference internal" href="history.html">Document history</a></li>
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Getting Started</a><ul>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#the-context-menu">The Context Menu</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#navigating-around">Navigating around</a><ul>
<li class="toctree-l3"><a class="reference internal" href="gettingstarted.html#click-able-items">Click-able items</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#changing-the-current-layout">Changing the current layout</a><ul>
<li class="toctree-l3"><a class="reference internal" href="gettingstarted.html#using-the-splitters">Using the splitters</a></li>
<li class="toctree-l3"><a class="reference internal" href="gettingstarted.html#dragging-and-dropping-a-terminal">Dragging and dropping a terminal</a></li>
<li class="toctree-l3"><a class="reference internal" href="gettingstarted.html#using-the-keyboard">Using the keyboard</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#resetting-the-terminal">Resetting the terminal</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#the-scrollbar-and-scrollback-buffer">The scrollbar and scrollback buffer</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#search-the-buffer">Search the buffer</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#zooming-the-terminal">Zooming the terminal</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#setting-titles">Setting Titles</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#insert-terminal-number">Insert terminal number</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#next-prev-profile">Next/Prev profile</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="preferences.html">Preferences Window</a><ul>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#global">Global</a><ul>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#behaviour">Behaviour</a></li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#appearance">Appearance</a></li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#terminal-titlebar">Terminal Titlebar</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#profiles">Profiles</a><ul>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#general">General</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#cursor">Cursor</a></li>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#terminal-bell">Terminal bell</a></li>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#not-in-terminator">Not in Terminator</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#command">Command</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#id1">Not in Terminator</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#colours">Colours</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#foreground-and-background">Foreground and Background</a></li>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#palette">Palette</a></li>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#id2">Not in Terminator</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#background">Background</a></li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#scrolling">Scrolling</a></li>
<li class="toctree-l3"><a class="reference internal" href="preferences.html#compatibility">Compatibility</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preferences.html#encoding">Encoding</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#layouts">Layouts</a></li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#keybindings">Keybindings</a></li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#plugins">Plugins</a></li>
<li class="toctree-l2"><a class="reference internal" href="preferences.html#about">About</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="layouts.html">Layouts and the Layout Launcher</a><ul>
<li class="toctree-l2"><a class="reference internal" href="layouts.html#the-layout-launcher">The Layout Launcher</a></li>
</ul>
</li>
<li class="toctree-l1 current"><a class="current reference internal" href="">The Grouping Menu</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#manipulating-terminal-groups">Manipulating terminal groups</a></li>
<li class="toctree-l2"><a class="reference internal" href="#broadcasting-input-to-multiple-terminals">Broadcasting input to multiple terminals</a></li>
<li class="toctree-l2"><a class="reference internal" href="#insert-terminal-number">Insert terminal number</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="plugins.html">Plugins</a><ul>
<li class="toctree-l2"><a class="reference internal" href="plugins.html#included-plugins">Included plugins</a><ul>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#activity-watch">Activity Watch</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#apt-url-handler">APT URL Handler</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#custom-commands-menu">Custom Commands Menu</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#inactivity-watch">Inactivity Watch</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#launchpad-bug-url-handler">Launchpad Bug URL Handler</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#launchpad-code-url-handler">Launchpad Code URL Handler</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#logger">Logger</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#maven-plugin-url-handler">Maven Plugin URL Handler</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#terminal-shot">Terminal Shot</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#test-plugin">Test Plugin</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="plugins.html#third-party-plugins">Third party plugins</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins.html#installing-a-plugin">Installing a plugin</a></li>
<li class="toctree-l2"><a class="reference internal" href="plugins.html#creating-your-own-plugins">Creating your own plugins</a><ul>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#the-basics-of-a-plugin">The basics of a plugin</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#url-handlers">URL Handlers</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#context-menu-items">Context menu items</a></li>
<li class="toctree-l3"><a class="reference internal" href="plugins.html#wrap-up">Wrap up</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="advancedusage.html">Advanced Usage</a><ul>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#command-line-options">Command line options</a><ul>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#general-options">General options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#window-options">Window options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#shell-options">Shell options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#layout-options">Layout options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#custom-window-manager-options">Custom Window Manager options</a></li>
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#debugging-options">Debugging options</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#the-config-file">The Config file</a></li>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#debugging">Debugging</a></li>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#dbus">DBus</a></li>
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#remotinator">Remotinator</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="faq.html">Frequently Asked Questions</a><ul>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why">Why...</a><ul>
<li class="toctree-l3"><a class="reference internal" href="faq.html#write-in-python-it-s-slow-bloated-bad">...write in Python? It&#8217;s slow/bloated/bad?</a><ul>
<li class="toctree-l4"><a class="reference internal" href="faq.html#performance">Performance</a></li>
<li class="toctree-l4"><a class="reference internal" href="faq.html#memory-use-the-dumb-way">Memory use - The dumb way</a></li>
<li class="toctree-l4"><a class="reference internal" href="faq.html#memory-use-the-sensible-way">Memory use - The sensible way</a></li>
<li class="toctree-l4"><a class="reference internal" href="faq.html#python-sucks">&#8220;Python sucks!&#8221;</a></li>
<li class="toctree-l4"><a class="reference internal" href="faq.html#in-summary">In summary</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-do-i">How do I...</a><ul>
<li class="toctree-l3"><a class="reference internal" href="faq.html#make-terminator-work-like-quake-style-terminals">...make Terminator work like Quake style terminals?</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="gettinginvolved.html">Getting involved</a><ul>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#translations">Translations</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#improve-icons-artwork">Improve icons/artwork</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#terminator-action-shots">Terminator action shots</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#manual-updates">Manual updates</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#testing">Testing</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#bugs">Bugs</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#plugins">Plugins</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#main-application-development">Main Application Development</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#gtk3-port">GTK3 Port</a></li>
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#api-docs">API Docs</a></li>
</ul>
</li>
</ul>
</div>
&nbsp;
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">Terminator</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> &raquo;</li>
<li>The Grouping Menu</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/grouping.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document">
<img alt="Because nothing says grouping like three different coloured boxes... /s" class="align-right" src="_images/icon_grouping.png" />
<div class="section" id="the-grouping-menu">
<span id="grouping-menu"></span><h1>The Grouping Menu<a class="headerlink" href="#the-grouping-menu" title="Permalink to this headline"></a></h1>
<div class="section" id="manipulating-terminal-groups">
<h2>Manipulating terminal groups<a class="headerlink" href="#manipulating-terminal-groups" title="Permalink to this headline"></a></h2>
<p>Grouping, as the name suggests, allows grouping of terminals allowing
actions to be taken that affect more than one terminal. As usual,
following along will help understanding, so lets start with a basic
window, then split into a 2x2 grid.</p>
<p>Let&#8217;s have another look at the grouping menu for reference, because
as we proceed, it will change:</p>
<img alt="_images/grouping_01.png" src="_images/grouping_01.png" />
<p>The first item <strong>New group...</strong> allows you to create a named group,
using an editable field that will appear next to the 3-box icon. By
default this will be given a randomly selected name from the names
of the Greek alphabet. Here you can see <strong>Phi</strong> was selected:</p>
<img alt="_images/grouping_02.png" src="_images/grouping_02.png" />
<p>You can either start typing to replace the provided one with something
more descriptive, or you can accept the default with <code class="docutils literal"><span class="pre">Return</span></code>. For
the purpose of this document I will just be using default names.</p>
<p>If you again click the 3-box/group button, you will see that several
new entries have been added to the menu:</p>
<img alt="_images/grouping_03.png" src="_images/grouping_03.png" />
<p>Because the terminal now has a group the first new entry is <strong>None</strong>
which will remove the grouping for this terminal.</p>
<p>Following that is a list of the known groups, in this case only <em>Phi</em>
so far. This list (plus the <em>None</em> entry) can be used to change the
group of this terminal.</p>
<p>Next are two items: <strong>Remove group Phi</strong> and <strong>Remove all groups</strong>.
You will only get the currently assigned group group as an option to
remove, as well as an option to remove all groups. This does not
close the group, but simply removes the group assignments from the
terminals.</p>
<p>The next option is more destructive: <strong>Close group Phi</strong> will exit
the terminals assigned to this group.</p>
<p>Here I&#8217;ve gone ahead and set the upper right terminal to the same
<em>Phi</em> group, and the lower left terminal to a <em>New group...</em> of
<strong>Epsilon</strong>.</p>
<img alt="_images/grouping_04.png" src="_images/grouping_04.png" />
<p>A quick glance at the menu again will show that the only change is
the addition of the <em>Epsilon</em> group to the list.</p>
<p>To change a group name you can either click on <em>New group...</em> again,
or <code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">click</span></code> on the 3-box/group button, and the editable
field will reappear.</p>
<p>The current terminal is the one with focus. By clicking with key
modifiers on other terminals 3-box/group button we can speed up group
organisation. Here&#8217;s a list of mouse actions (including some already
detailed):</p>
<table border="1" class="docutils">
<colgroup>
<col width="46%" />
<col width="37%" />
<col width="17%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Mouse</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Group menu popup</td>
<td><code class="docutils literal"><span class="pre">click</span></code></td>
<td>(TBD)</td>
</tr>
<tr class="row-odd"><td>Edit group for terminal</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">click</span></code></td>
<td>(TBD)</td>
</tr>
<tr class="row-even"><td>Edit group for all terminals in the &#8220;group&#8221;</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">click</span></code></td>
<td>(TBD?)</td>
</tr>
<tr class="row-odd"><td>Toggle to current terminals group <a class="footnote-reference" href="#id3" id="id1">[1]</a></td>
<td><code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">click</span></code></td>
<td>&nbsp;</td>
</tr>
<tr class="row-even"><td>Toggle &#8220;group&#8221; to current terminals group <a class="footnote-reference" href="#id3" id="id2">[1]</a></td>
<td><code class="docutils literal"><span class="pre">Ctrl</span></code>+<code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">click</span></code></td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label">[1]</td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id2">2</a>)</em> These shortcuts will only work if you use them on terminals
that are <em>not</em> the current terminal.</td></tr>
</tbody>
</table>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">The terminals with no named group are also considered a
group. If you use one of the <code class="docutils literal"><span class="pre">Super</span></code> shortcuts on a
terminal with no group, you will also include all the
other terminals with no group.</p>
</div>
<p>Skipping slightly ahead in the menu, there are two options that make
more sense covered here. The <strong>Split to this group</strong> (default: off)
option means that when you split the current terminal, the new one
will inherit the group of the current terminal. It is off by default
in which case new terminals have no group.</p>
<p>The second option <strong>Autoclean groups</strong> (default: on) will remove a
group from the menus group list when the last terminal with that
group is closed. If off groups will remain in the list until the
application exits, or the option is enabled.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Not shown in the above screenshots, there are also menu
items for grouping all terminals in a tab in the menu. They
only appear once a new tab is created - <strong>Group all in tab</strong>
and <strong>Ungroup all in tab</strong>.</p>
</div>
<p>Some final group related shortcuts are for grouping all terminals
at once, or grouping terminals in the same tab.</p>
<table border="1" class="docutils">
<colgroup>
<col width="34%" />
<col width="66%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Group all</td>
<td><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">G</span></code></td>
</tr>
<tr class="row-odd"><td>Ungroup all</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">G</span></code></td>
</tr>
<tr class="row-even"><td>Group tab</td>
<td><code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">T</span></code></td>
</tr>
<tr class="row-odd"><td>Ungroup tab</td>
<td><code class="docutils literal"><span class="pre">Shift</span></code>+<code class="docutils literal"><span class="pre">Super</span></code>+<code class="docutils literal"><span class="pre">T</span></code></td>
</tr>
<tr class="row-even"><td>Group all toggle</td>
<td>&nbsp;</td>
</tr>
<tr class="row-odd"><td>Group tab toggle</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="broadcasting-input-to-multiple-terminals">
<h2>Broadcasting input to multiple terminals<a class="headerlink" href="#broadcasting-input-to-multiple-terminals" title="Permalink to this headline"></a></h2>
<p>So first let me describe some terminology (no pun intended).
<strong>Broadcasting</strong> is the act of sending your input to multiple
terminals. The current terminal (the one with the red titlebar by
default) is always the <strong>broadcaster</strong>. Any terminal that is in
the same group as the current terminal is a potential <strong>receiver</strong>.
I say potential because the act of broadcasting can be turned on
and off independently of the grouping.</p>
<p>This can be an invaluable time-saver when having to do active
investigation across multiple machines where you would be repeating
the same commands on each of them.</p>
<p>Terminator&#8217;s titlebar is colour-coded to help you quickly see which
terminals are potential receivers, and whether they <em>will</em> receive
the broadcast input.</p>
<p>The titlebar is split into two parts. The leftmost part is the
3-box/group button that has one of three background colours as defined
in the <a class="reference internal" href="preferences.html#prefs-global"><span>Global</span></a> tab of <a class="reference internal" href="preferences.html#preferences"><span>Preferences Window</span></a>:</p>
<ul class="simple">
<li><em>Red</em> - The current terminal and broadcaster.</li>
<li><em>Blue</em> - A terminal that is in the same group as the broadcaster.</li>
<li><em>Grey</em> - A terminal in a different group, or no group.</li>
</ul>
<p>The second part consists of the title, and uses the same colouring
to show the following:</p>
<ul class="simple">
<li><em>Red</em> - The current terminal and broadcaster.</li>
<li><em>Blue</em> - A terminal that is acting as a receiver and will duplicate
input from the broadcaster.</li>
<li><em>Grey</em> - A terminal that is not a receiver.</li>
</ul>
<p>There are three settings for broadcasting, selected from the <em>Group
menu</em>. Following are an image of each of these modes, with <code class="docutils literal"><span class="pre">test</span></code>
typed into the current broadcasting terminal:</p>
<ul>
<li><p class="first"><em>Broadcast off</em></p>
<img alt="_images/broadcast_01.png" src="_images/broadcast_01.png" />
<p>Here you can see that only the current terminal receives input, even
though the upper right terminal is also a part of the <em>Phi</em> group.</p>
</li>
<li><p class="first"><em>Broadcast all</em></p>
<img alt="_images/broadcast_02.png" src="_images/broadcast_02.png" />
<p>Here you can see that all terminals, including those in other groups,
or with no group, receive the input.</p>
</li>
<li><p class="first"><em>Broadcast group</em> (default mode; can be changed in the
<a class="reference internal" href="preferences.html#prefs-global"><span>Global</span></a> tab of <a class="reference internal" href="preferences.html#preferences"><span>Preferences Window</span></a>.)</p>
<img alt="_images/broadcast_03.png" src="_images/broadcast_03.png" />
<p>Here you can see that only the terminal(s) in the same group in the
same group as the broadcaster receive input.</p>
</li>
</ul>
<p>Be careful with additional tabs, windows, or when you are zoomed or
maximised on a single terminal. Just because you cannot see a terminal
does not mean the terminal is not receiving. This can cause problems
if you are typing a destructive command without realising that this
command is going to other terminals.</p>
<p>Those with good eyesight may have spotted the other visual indicator
of the colours in the 3-box icon changing for the different status of
the terminals too. When you are zoomed or maximised, the presence of
blue in this icon might be the only visual indicator of receivers.</p>
<p>As with all things in Terminator, we have shortcuts to help you keep
your hands on the keyboard:</p>
<table border="1" class="docutils">
<colgroup>
<col width="47%" />
<col width="53%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Action</th>
<th class="head">Default Shortcut</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>Broadcast off</td>
<td><code class="docutils literal"><span class="pre">Alt</span></code>+<code class="docutils literal"><span class="pre">O</span></code></td>
</tr>
<tr class="row-odd"><td>Broadcast all</td>
<td><code class="docutils literal"><span class="pre">Alt</span></code>+<code class="docutils literal"><span class="pre">A</span></code></td>
</tr>
<tr class="row-even"><td>Broadcast group</td>
<td><code class="docutils literal"><span class="pre">Alt</span></code>+<code class="docutils literal"><span class="pre">G</span></code></td>
</tr>
</tbody>
</table>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p>It has become apparent that IBus causes problems with
broadcast input. When multiple keystrokes are used to
<em>compose</em> a letter, such as the <code class="docutils literal"><span class="pre">AltGr</span></code>+<code class="docutils literal"><span class="pre">[</span></code>
followed by <code class="docutils literal"><span class="pre">a</span></code>, <code class="docutils literal"><span class="pre">o</span></code>, <code class="docutils literal"><span class="pre">u</span></code> keys to get <strong>ä</strong>,
<strong>ö</strong>, <strong>ü</strong> characters for the German language.</p>
<p>Instead of getting your composed letter in all receivers,
you will only get the composed letter in the current
terminal. If you copy and paste the character into the
current terminal then it will be input into the
receivers.</p>
<p class="last">You may not even realise that you are running IBus.
Killing it will temporarily fix the problem. There is
a fix for IBus and VTE, but only in the newer builds of
VTE. For that we would need the experimental GTK3
version of Terminator.</p>
</div>
</div>
<div class="section" id="insert-terminal-number">
<h2>Insert terminal number<a class="headerlink" href="#insert-terminal-number" title="Permalink to this headline"></a></h2>
<p>The last two menu items are slightly out of place here. They are the
same function as the shortcuts mentioned <a class="reference internal" href="gettingstarted.html#insert-termnum-shortcut"><span>here</span></a>.
They were added early on when the broadcast feature was added, and
the argument could be made for removing them. So far no-one has
though, so for now they will stay here.</p>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="plugins.html" class="btn btn-neutral float-right" title="Plugins" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="layouts.html" class="btn btn-neutral" title="Layouts and the Layout Launcher" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright 2015, Stephen Boddy, licensed under the CC-BY-SA..
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'1.0 alpha',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
</script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink