Merge pull request #821 from LeoDog896/patch-1

chore: bump ations/checkout (v2 -> v4)

.github/ISSUE_TEMPLATE/bug_report.md

@@ -8,7 +8,7 @@ assignees: ''
 ---
 
 Before opening an issue, please try starting terminator with an empty config
-file, by issuing `terminator -g /dev/null` and see if it starts normally.
+file, by issuing `terminator -u -g /dev/null` and see if it starts normally.
 
 If it does, and you still want to open the bug, then please attach the
 config file, usually found at `$HOME/.config/terminator/config` to the issue
@@ -30,6 +30,7 @@ If applicable, add screenshots to help explain your problem.
 **Desktop (please complete the following information):**
  - OS or Linux Distribution: [e.g. FreeBSD or Ubuntu]
  - Version [e.g. 20.04]
+ - Display Technology: Wayland or X11
 
 
 **Additional context**

.github/workflows/python.yml

@@ -20,7 +20,7 @@ jobs:
         - '3.9'
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
     - name: Set up Python ${{ matrix.python }}
       uses: actions/setup-python@v1

AUTHORS

@@ -5,8 +5,8 @@ This list is generated from the GIT log.
 * Aaron Faanes <dafrito@gmail.com>
 * Adrian A <a.adrian.tech@googlemail.com>
 * Alexey Sokolov <sokolov@google.com>
-* Andrea Corbellini <corbellini.andrea@gmail.com>
 * Andre Hilsendeger <Andre.Hilsendeger@gmail.com>
+* Andrea Corbellini <corbellini.andrea@gmail.com>
 * Andrew Felske <knopper67@archlinux.us>
 * Antonio Terceiro <asa@terceiro.xyz>
 * Antonio Terceiro <terceiro@debian.org>
@@ -25,7 +25,7 @@ This list is generated from the GIT log.
 * David Caro Estévez <david.caro.estevez@gmail.com>
 * David Levanon <dvdlevanon@gmail.com>
 * David Sowder <github.com@david.sowder.com>
-* dkmvs <67212386+dkmvs@users.noreply.github.com>
+* Dennis Benzinger | SAP Hybris <dennis.benzinger@sap.com>
 * Dmitry Soldatov <grapescan@gmail.com>
 * Douglas Bacon <douglaswbacon@gmail.com>
 * Edoardo Batini <eodbat@gmail.com>
@@ -33,7 +33,6 @@ This list is generated from the GIT log.
 * Emilien Klein <emilien@klein.st>
 * Emilio Pozuelo Monfort <pochu@debian.org>
 * Emmanuel Bretelle <chantra@debuntu.org>
-* evandrocoan <evandrocoan@hotmail.com>
 * Felix Mölder <56774350+Brambleberry4@users.noreply.github.com>
 * Fernando Basso <fernandobasso.br@gmail.com>
 * Filip Kilibarda <filipcsc@gmail.com>
@@ -46,51 +45,82 @@ This list is generated from the GIT log.
 * Ivar Smolin <okul@ivotingcentre.ee>
 * Jakub Vaněk <vanek.jakub4@seznam.cz>
 * Jamu Kakar <jkakar@kakar.ca>
+* Jay W <git.jaydoubleu@gmail.com>
 * Jean-Sebastien Trottier <strottie@cisco.com>
 * Joe Peled <joe.peled@vimeo.com>
 * Jonas L <jooola@users.noreply.github.com>
-* José Augusto <joseaugusto.881@outlook.com>
 * Jose Augusto <jose.augusto@chiligum.com.br>
 * Jose I. Monreal <jmonreal@gmail.com>
-* judgedreads <pearce@millerdedmon.com>
+* José Augusto <joseaugusto.881@outlook.com>
 * Juliano Fischer Naves <julianofischer@gmail.com>
 * Julien Nicoulaud <julien.nicoulaud@gmail.com>
 * Julien Thewys <jth@openerp.com>
+* Kacper Kowalski <kacper.s.kowalski@gmail.com>
 * Kees Cook <kees@outflux.net>
+* Kian-Meng Ang <kianmeng@cpan.org>
 * Leandro Thimóteo <leandro.s.thimoteo@gmail.com>
 * Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
 * Mackenzie Morgan <maco.m@ubuntu.com>
+* Mark Timarev <marktimarev@gmail.com>
 * Markus Frosch <markus@lazyfrosch.de>
 * Markus Korn <thekorn@gmx.de>
 * Matt Rose <mattrose@folkwolf.net>
-* milotype <43657314+milotype@users.noreply.github.com>
+* Matthew Rose <mattrose@folkwolf.net>
+* Mihai Babiac <mihai.babiac@gmail.com>
+* MuhammadJivani <masad@peekaboo.guru>
 * Nathan Handler <nhandler@ubuntu.com>
 * Nathaniel M. Beaver <nathanielmbeaver@gmail.com>
 * Nathaniel Morck Beaver <nathanielmbeaver@gmail.com>
 * Neal Fultz <nfultz@neal-1015pe>
 * Nicolas Valcárcel <nvalcarcel@ubuntu.com>
 * Pavel Khlebovich <pas.anddev@gmail.com>
+* Paweł Kotiuk <45544416+pktiuk@users.noreply.github.com>
+* Paweł Kotiuk <kotiuk@zohomail.eu>
 * Peter B. Jørgensen <peterbjorgensen@gmail.com>
 * Peter Bjørn Jørgensen <peterbjorgensen@gmail.com>
 * Peter Lind <peter.e.lind@gmail.com>
 * Phi <phi@kernel-tools.com>
-* planet36 <planet36@users.noreply.github.com>
 * Przemek Wesolek <jest@luna>
-* Roberto Aguilar <roberto.c.aguilar@gmail.com>
-* robertoetcheverryr <yggdrasil.raiker@gmail.com>
 * R the Troublemaker <5971066+br0kenbuild@users.noreply.github.com>
+* Rafael Kitover <rkitover@gmail.com>
+* Roberto Aguilar <roberto.c.aguilar@gmail.com>
 * Ryan Fonnesbeck <fonz@fonzinc.com>
-* shiraeeshi <shiraeeshi@mail.ru>
 * Siegfried-Angel Gevatter Pujals <rainct@ubuntu.com>
 * Simeon Simeonov <sgs@pichove.org>
 * Stephen Boddy <stephen.j.boddy@gmail.com>
-* thebigs <TheBigS@users.noreply.github.com>
+* StephenPeringer <StephenPeringer@users.noreply.github.com>
 * Thomas Hurst <tom@hur.st>
 * Thomas Meire <blackskad@gmail.com>
+* Tobias Farrenkopf <tf@emptyset.de>
+* Tom Yan <tom.ty89@gmail.com>
 * Tomek Sabała <sabala.tomek@gmail.com>
 * Tony Baker <frd91gt@gmail.com>
-* waldner <waldner@katamail.com>
+* Vishweshwar Saran Singh Deo <vssdeo@gmail.com>
+* Vojtech Duchon (Ext) <vojtech.duchon@gmail.com>
+* Vulcalien <vulcalien+github@gmail.com>
+* Vulcalien <vulcalien@gmail.com>
 * Yousof <yousofebneddin@yahoo.com>
+* Yusuf Güngör <yusuf.gungor@hepsiburada.com>
+* amaan khan <khanamaan827@gmail.com>
+* caprinux <123jinkai@gmail.com>
+* coder <none@non.no>
+* dkmvs <67212386+dkmvs@users.noreply.github.com>
+* evandrocoan <evandrocoan@hotmail.com>
+* flaviosteimacher <39162591+flaviosteimacher@users.noreply.github.com>
+* judgedreads <pearce@millerdedmon.com>
+* kocho1984 <eblebleo2@gmail.com>
+* milotype <43657314+milotype@users.noreply.github.com>
+* nicbn <contact@nicbn.com>
+* nojhan <nojhan@nojhan.net>
+* ozzdemir <oguz.ozdemir@ieee.metu.edu.tr>
+* planet36 <planet36@users.noreply.github.com>
+* robertoetcheverryr <yggdrasil.raiker@gmail.com>
+* sabriunal <libreajans@gmail.com>
+* shiraeeshi <shiraeeshi@mail.ru>
+* thebigs <TheBigS@users.noreply.github.com>
+* transifex-integration[bot] <43880903+transifex-integration[bot]@users.noreply.github.com>
+* waldner <waldner@katamail.com>
+* xuezhixin <xuezhixin@uniontech.com>
 
 ## Other contributors
 
@@ -112,5 +142,7 @@ People that contributed to Terminator in other ways.
 * Maxim Derkach
 * Mats Henrikson
 * Nizar Kerkeni
+* "Data"
 * Cristian Grada
+* "zhuqin"
 * and many others.

CHANGELOG.legacy.txt

@@ -151,14 +151,14 @@ terminator 1.90:
     * Preselect the current layout when opening Prefs window, and also
       save config after using the layout 'Save' button (Steve Boddy)
     * Set some default shortcuts based on my preference (Steve Boddy)
-    * Add high contast icons, make the main window icon loading work
+    * Add high contrast icons, make the main window icon loading work
       better, and respect the theme changes (Steve Boddy, LP#305579)
     * Additional windows icon loading works better, and respect the
       theme changes (LP#305579)
     * Adjust the config section name to InactivityWatch for
       InactivityWatch class
     * Add a new setting for ActivityWatch to set the time between
-      activty notifications
+      activity notifications
     * BIG update to translations, due to additions and changes.
     * Make the random default group names translatable 
     * Add and improve the mnemonics in the group menu
@@ -170,7 +170,7 @@ terminator 1.90:
     * 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 (in Prefs window) to launch manual
-    * Small tweak to setup.py to seperate build and install, and
+    * Small tweak to setup.py to separate build and install, and
       always attempt to install manual by default.
     * Sort entries in config file, so they don't jump around every
       time config is saved for easier troubleshooting
@@ -258,7 +258,7 @@ terminator 1.90:
       terminator class
     * Fix the scroll up/down key bindings to use gtk3 method
     * Fix getting the handle size (gtk2->gtk3 diff)
-    * Fix scrollbar doubleclick rebalancing (LP#1423686)
+    * Fix scrollbar double-click rebalancing (LP#1423686)
     * Fix allocations (no longer an attribute) when balancing
       (gtk2->gtk3 diff)
     * Fix allocations not having the x,y position just w,h (gtk3 bug?
@@ -351,7 +351,7 @@ terminator 1.90:
       (Egmont Koblinger, LP#1518108)
     * Fix copy on selection to work on already open terminals (Egmont
       Koblinger, LP#1518109)
-    * Fix unwanted seperator size change, and increase granularity of
+    * Fix unwanted separator size change, and increase granularity of
       dim/transparent sliders (Egmont Koblinger, LP#1518114)
     * Fix cwd when new term spawned from a symlinked directory (Egmont
       Koblinger, LP#1518554)

CHANGELOG.md

@@ -1,6 +1,236 @@
 # Changelog
 
-## [v2.1.1](https://github.com/gnome-terminator/terminator/tree/v2.1.1) (2021-04-01)
+## [v2.1.3](https://github.com/gnome-terminator/terminator/tree/v2.1.3) (2023-03-01)
+
+[Full Changelog](https://github.com/gnome-terminator/terminator/compare/v2.1.2...v2.1.3)
+
+**Implemented enhancements:**
+
+- Option to set split ratio of terminals [\#708](https://github.com/gnome-terminator/terminator/issues/708)
+- Add option to set given terminal to "read only" [\#649](https://github.com/gnome-terminator/terminator/issues/649)
+- background image - respect ratio [\#644](https://github.com/gnome-terminator/terminator/issues/644)
+- Shortcut for autosplit h/v depending on active terminal size [\#613](https://github.com/gnome-terminator/terminator/issues/613)
+- Feature: Insert terminal name to terminal \(for broadcast\) [\#540](https://github.com/gnome-terminator/terminator/issues/540)
+- Background image drawing modes and alignment [\#713](https://github.com/gnome-terminator/terminator/pull/713) ([Vulcalien](https://github.com/Vulcalien))
+- Zoom on notebook even if there is only one terminal in the tab + keep tab position and label in notebook rotation [\#589](https://github.com/gnome-terminator/terminator/pull/589) ([Vulcalien](https://github.com/Vulcalien))
+
+**Fixed bugs:**
+
+- Resets the tab title on rotation [\#624](https://github.com/gnome-terminator/terminator/issues/624)
+- - bug context menu \(right click\)-\>layouts-\>"Layout Name" always selec… [\#653](https://github.com/gnome-terminator/terminator/pull/653) ([vssdeo](https://github.com/vssdeo))
+- Fix missing icons when started with Ctrl-Alt-T [\#628](https://github.com/gnome-terminator/terminator/pull/628) ([MihaiBabiac](https://github.com/MihaiBabiac))
+
+**Closed issues:**
+
+- Terminator not working with latest version of python-cairo [\#711](https://github.com/gnome-terminator/terminator/issues/711)
+- \[Bug\]\[Fedora 36 KDE\]\[terminator v2.1.1\] "broadcast group" sends each terminal input/keystroke depending on the group's members count to everyone in the group [\#704](https://github.com/gnome-terminator/terminator/issues/704)
+- reset\_clear doesn't show new prompt [\#703](https://github.com/gnome-terminator/terminator/issues/703)
+- `-x`/`--execute` still broken [\#702](https://github.com/gnome-terminator/terminator/issues/702)
+- Make unfocused terminal text transparent instead of blacker [\#694](https://github.com/gnome-terminator/terminator/issues/694)
+- A translucent separation occurs between terminals [\#687](https://github.com/gnome-terminator/terminator/issues/687)
+- \[2.1.2\] Foreground processes started in new window close immediately [\#673](https://github.com/gnome-terminator/terminator/issues/673)
+- Is there a official page to maintain a offical/third-part plugin list? [\#668](https://github.com/gnome-terminator/terminator/issues/668)
+- What happened to the change terminal titlebar under preferences? [\#664](https://github.com/gnome-terminator/terminator/issues/664)
+- \[Feature Request\] - In the Context Menu\(Right-Click\) show keyboard shortcuts / accelarators  [\#662](https://github.com/gnome-terminator/terminator/issues/662)
+- terminator: error: unrecognized arguments [\#660](https://github.com/gnome-terminator/terminator/issues/660)
+- Plugin Submission : SaveLastSessionLayout Uses Layout to Auto-Save Last session and CWD on Terminal Window Close [\#654](https://github.com/gnome-terminator/terminator/issues/654)
+- Loading layout loads only the last added layout from context menu \(right click\) [\#652](https://github.com/gnome-terminator/terminator/issues/652)
+- When can we expect a new release? [\#650](https://github.com/gnome-terminator/terminator/issues/650)
+- Profiles for different Shells - is it possible? how does it work? [\#640](https://github.com/gnome-terminator/terminator/issues/640)
+- Double input to broadcasted group [\#623](https://github.com/gnome-terminator/terminator/issues/623)
+- background images only  displaying on default profile [\#595](https://github.com/gnome-terminator/terminator/issues/595)
+- The repository 'https://ppa.launchpadcontent.net/mattrose/terminator/ubuntu jammy Release' does not have a Release file. [\#594](https://github.com/gnome-terminator/terminator/issues/594)
+- Increase the usage of augmented assignment statements [\#555](https://github.com/gnome-terminator/terminator/issues/555)
+
+**Merged pull requests:**
+
+- Better distinguishing of inactive windows from the active one, by changing the background brightness [\#709](https://github.com/gnome-terminator/terminator/pull/709) ([KKoovalsky](https://github.com/KKoovalsky))
+- Ctrl+Click on group button automatically creates groups whenever needed [\#691](https://github.com/gnome-terminator/terminator/pull/691) ([nicbn](https://github.com/nicbn))
+- \[bug 680\] Open up keybindings page on keypress \#680 [\#686](https://github.com/gnome-terminator/terminator/pull/686) ([vssdeo](https://github.com/vssdeo))
+- Translate '/po/terminator.pot' in 'pt\_BR' [\#684](https://github.com/gnome-terminator/terminator/pull/684) ([transifex-integration[bot]](https://github.com/apps/transifex-integration))
+- Plugin and Group menu item that inserts the name of the terminal. [\#683](https://github.com/gnome-terminator/terminator/pull/683) ([mattrose](https://github.com/mattrose))
+- Add Readonly toggle to popup menu [\#679](https://github.com/gnome-terminator/terminator/pull/679) ([mattrose](https://github.com/mattrose))
+- Fix argument handling of the --execute flag [\#678](https://github.com/gnome-terminator/terminator/pull/678) ([shawn-ogg](https://github.com/shawn-ogg))
+- Remove all ibus workarounds [\#674](https://github.com/gnome-terminator/terminator/pull/674) ([mattrose](https://github.com/mattrose))
+- \[bug 613\] -  Shortcut for autosplit h/v depending on active terminal … [\#671](https://github.com/gnome-terminator/terminator/pull/671) ([vssdeo](https://github.com/vssdeo))
+- \[bug 662\] \[Feature Request\] - In the Context Menu\(Right-Click\) show k… [\#666](https://github.com/gnome-terminator/terminator/pull/666) ([vssdeo](https://github.com/vssdeo))
+- \[bug 559\] Add menu autocomplete \#559 [\#665](https://github.com/gnome-terminator/terminator/pull/665) ([vssdeo](https://github.com/vssdeo))
+- \[bug 662\] \[Feature Request\] - In the Context Menu\(Right-Click\) show k… [\#663](https://github.com/gnome-terminator/terminator/pull/663) ([vssdeo](https://github.com/vssdeo))
+- \[bug 654\] - Plugin Submission : SaveLastSessionLayout Uses Layout to … [\#661](https://github.com/gnome-terminator/terminator/pull/661) ([vssdeo](https://github.com/vssdeo))
+- Update terminal.py [\#659](https://github.com/gnome-terminator/terminator/pull/659) ([flaviosteimacher](https://github.com/flaviosteimacher))
+- docs: Change number of columns in repology badge [\#657](https://github.com/gnome-terminator/terminator/pull/657) ([pktiuk](https://github.com/pktiuk))
+- Plugin Submission : SaveLastSessionLayout Uses Layout to Auto-Save Last session and CWD [\#655](https://github.com/gnome-terminator/terminator/pull/655) ([vssdeo](https://github.com/vssdeo))
+- Fix typos [\#651](https://github.com/gnome-terminator/terminator/pull/651) ([kianmeng](https://github.com/kianmeng))
+- data: Remove GNOME branding [\#647](https://github.com/gnome-terminator/terminator/pull/647) ([sabriunal](https://github.com/sabriunal))
+- this line has an extra ';' symbol [\#632](https://github.com/gnome-terminator/terminator/pull/632) ([xuezhixin](https://github.com/xuezhixin))
+- Use the term 'zero padded' instead of 'padded'. [\#189](https://github.com/gnome-terminator/terminator/pull/189) ([phidebian](https://github.com/phidebian))
+
+## [v2.1.2](https://github.com/gnome-terminator/terminator/tree/v2.1.2) (2022-10-19)
+
+[Full Changelog](https://github.com/gnome-terminator/terminator/compare/v2.1.1...v2.1.2)
+
+**Implemented enhancements:**
+
+- \[Feature request\] move layout/session definitions into separate files with a dedicated extension in a dedicated directory [\#604](https://github.com/gnome-terminator/terminator/issues/604)
+- Bash completion [\#495](https://github.com/gnome-terminator/terminator/issues/495)
+- Changing cursor foreground color [\#467](https://github.com/gnome-terminator/terminator/issues/467)
+- Wallpaper configuration option from terminal [\#466](https://github.com/gnome-terminator/terminator/issues/466)
+- Launch a new command in a vertical or horizontal split. [\#446](https://github.com/gnome-terminator/terminator/issues/446)
+- Separators is wider after upgrading to ubuntu 21.04 [\#445](https://github.com/gnome-terminator/terminator/issues/445)
+- Broadcast profile changes to existing terminals [\#421](https://github.com/gnome-terminator/terminator/issues/421)
+- How to deactivate the middle mouse button paste? [\#415](https://github.com/gnome-terminator/terminator/issues/415)
+- Feature request: expose the window and terminal title setting features in context menu [\#405](https://github.com/gnome-terminator/terminator/issues/405)
+- Integrate --layout-json command line parameter so that it can be passed to dbus [\#401](https://github.com/gnome-terminator/terminator/issues/401)
+- Feature request: move titlebar colors config to profiles, rather than global settings [\#379](https://github.com/gnome-terminator/terminator/issues/379)
+- Visual aids [\#367](https://github.com/gnome-terminator/terminator/issues/367)
+- Feature Request: detach tab [\#302](https://github.com/gnome-terminator/terminator/issues/302)
+- Pls add version on OS X [\#283](https://github.com/gnome-terminator/terminator/issues/283)
+
+**Fixed bugs:**
+
+- Ctrl+Shift+Mouse-Scroll triggers Ctrl+Mouse Scroll [\#606](https://github.com/gnome-terminator/terminator/issues/606)
+- None isn't a valid value of keybindings config anymore [\#548](https://github.com/gnome-terminator/terminator/issues/548)
+- psutil.AccessDenied: psutil.AccessDenied \(pid=1\) [\#539](https://github.com/gnome-terminator/terminator/issues/539)
+- Find functionality does not show matches on same line [\#511](https://github.com/gnome-terminator/terminator/issues/511)
+- Ratio and/or position on a config file's layout ignored [\#433](https://github.com/gnome-terminator/terminator/issues/433)
+- Black background remains after hide\_window [\#425](https://github.com/gnome-terminator/terminator/issues/425)
+- Cannot create working config file with 5 terminals [\#409](https://github.com/gnome-terminator/terminator/issues/409)
+- Terminal loses focus versus tab title [\#400](https://github.com/gnome-terminator/terminator/issues/400)
+- Terminal title-bars are transparent on first start [\#392](https://github.com/gnome-terminator/terminator/issues/392)
+
+**Closed issues:**
+
+- Hide window in waybar [\#633](https://github.com/gnome-terminator/terminator/issues/633)
+- Split window profile incorrect inheritance  [\#631](https://github.com/gnome-terminator/terminator/issues/631)
+- \[Question\] is there a way to prevent Terminator from dereferencing symbolic links? [\#617](https://github.com/gnome-terminator/terminator/issues/617)
+- Terminator not working on RHEL 9  [\#616](https://github.com/gnome-terminator/terminator/issues/616)
+- Is there a right-click menu in sway? [\#614](https://github.com/gnome-terminator/terminator/issues/614)
+- Set Terminator tab title via command line [\#603](https://github.com/gnome-terminator/terminator/issues/603)
+- Unable to launch KeyError: b'Rss:' [\#601](https://github.com/gnome-terminator/terminator/issues/601)
+- Cannot view emoji [\#599](https://github.com/gnome-terminator/terminator/issues/599)
+- Clickable filepath:rownumber [\#598](https://github.com/gnome-terminator/terminator/issues/598)
+- Feature Request: set initial window size in preferences [\#593](https://github.com/gnome-terminator/terminator/issues/593)
+- Update the authorship in README [\#586](https://github.com/gnome-terminator/terminator/issues/586)
+- xbindkeys doesn't work in Terminator, but works in other apps [\#582](https://github.com/gnome-terminator/terminator/issues/582)
+- Unable to load Keybinder module [\#580](https://github.com/gnome-terminator/terminator/issues/580)
+- terminator for MacOS user [\#578](https://github.com/gnome-terminator/terminator/issues/578)
+- UTF-8 character breaks terminator config file [\#577](https://github.com/gnome-terminator/terminator/issues/577)
+- Terminator need to highlight search string [\#575](https://github.com/gnome-terminator/terminator/issues/575)
+- Custom Commands NOT Working in Linux Mint 20.3 [\#573](https://github.com/gnome-terminator/terminator/issues/573)
+- Can't add/remove terminal panes from layout editor [\#572](https://github.com/gnome-terminator/terminator/issues/572)
+- Language not applied after build [\#569](https://github.com/gnome-terminator/terminator/issues/569)
+- Moving Cursor Word By Word using ALT + Arrows [\#566](https://github.com/gnome-terminator/terminator/issues/566)
+- Enabling "putty style paste" causes context menu to be unreachable with 2-button mouse [\#565](https://github.com/gnome-terminator/terminator/issues/565)
+- Setting stty options [\#564](https://github.com/gnome-terminator/terminator/issues/564)
+- Switch focus and splits don't work when terminal is zoomed [\#550](https://github.com/gnome-terminator/terminator/issues/550)
+- Will terminator ever consider picking up ligature support? [\#543](https://github.com/gnome-terminator/terminator/issues/543)
+- feature request: Implement line spacing as a configuration option [\#542](https://github.com/gnome-terminator/terminator/issues/542)
+- Change separator color [\#538](https://github.com/gnome-terminator/terminator/issues/538)
+- remotinator split and execute command — cannot determine uuid [\#537](https://github.com/gnome-terminator/terminator/issues/537)
+- Split vertical keyboard don't work on debian 11 [\#535](https://github.com/gnome-terminator/terminator/issues/535)
+- Vte.Terminal\(\).set\_encoding deprecated [\#534](https://github.com/gnome-terminator/terminator/issues/534)
+- Fix Keyboard Input [\#533](https://github.com/gnome-terminator/terminator/issues/533)
+- group broadcasting switched on/off for all groups [\#532](https://github.com/gnome-terminator/terminator/issues/532)
+- Drop a file from nautilus onto terminator window no longer works \(it used to paste the path a la gnome terminal\) [\#530](https://github.com/gnome-terminator/terminator/issues/530)
+- Crash everytime after encoding is changed to TCVN [\#529](https://github.com/gnome-terminator/terminator/issues/529)
+- Change the color of the current tab to highlight it better [\#522](https://github.com/gnome-terminator/terminator/issues/522)
+- Feature: Configuration to colorize split screens from default grey colour, Issue: Remove ability to select 0 and 1 handle\_size from configuration gui [\#518](https://github.com/gnome-terminator/terminator/issues/518)
+- Error when using "Insert Terminal Number" \(Solved?\) [\#517](https://github.com/gnome-terminator/terminator/issues/517)
+- Auto-scroll to the cursor position when typing [\#513](https://github.com/gnome-terminator/terminator/issues/513)
+- hide\_window mapped with Shift+Control+Alt+$an\_alphabet catches Control+Alt+$an\_alphabet instead [\#509](https://github.com/gnome-terminator/terminator/issues/509)
+- Cursor is blinking on inactive windows [\#508](https://github.com/gnome-terminator/terminator/issues/508)
+- custom commands are not persisted [\#505](https://github.com/gnome-terminator/terminator/issues/505)
+- Terminator slow to close if xclip was invoked [\#503](https://github.com/gnome-terminator/terminator/issues/503)
+- terminator failing to open on ubuntu 21.04 [\#502](https://github.com/gnome-terminator/terminator/issues/502)
+- Monospace Bold isn't working [\#497](https://github.com/gnome-terminator/terminator/issues/497)
+- No prompt when closing terminator now, despite say vim running in terminal [\#496](https://github.com/gnome-terminator/terminator/issues/496)
+- suppor for sixel graphics [\#492](https://github.com/gnome-terminator/terminator/issues/492)
+- which is deprecated and should not be used [\#488](https://github.com/gnome-terminator/terminator/issues/488)
+- could tmux Key bindings using in terminator? [\#474](https://github.com/gnome-terminator/terminator/issues/474)
+- Support OpenType font features [\#473](https://github.com/gnome-terminator/terminator/issues/473)
+- Crash on Terminal resize when using fish [\#458](https://github.com/gnome-terminator/terminator/issues/458)
+- Incorrect layout sorting in notebook [\#453](https://github.com/gnome-terminator/terminator/issues/453)
+- Coloring Tabs / Tabs Appearance [\#449](https://github.com/gnome-terminator/terminator/issues/449)
+- Option to disable system notifications [\#448](https://github.com/gnome-terminator/terminator/issues/448)
+- Window vanishes [\#447](https://github.com/gnome-terminator/terminator/issues/447)
+- Multiple Terminator instances randomly crash on Ubuntu 20.04 [\#444](https://github.com/gnome-terminator/terminator/issues/444)
+- Option to open URLs with just a click [\#434](https://github.com/gnome-terminator/terminator/issues/434)
+- Doubled input from keyboard when broadcasting in tabs [\#432](https://github.com/gnome-terminator/terminator/issues/432)
+- Does this tool support macOS Big Sur? [\#430](https://github.com/gnome-terminator/terminator/issues/430)
+- terminator is slow [\#426](https://github.com/gnome-terminator/terminator/issues/426)
+- Add more fundamental "editor-ish" feature [\#424](https://github.com/gnome-terminator/terminator/issues/424)
+- Allow disabling and resetting keybindings in Preferences [\#423](https://github.com/gnome-terminator/terminator/issues/423)
+- Project based layout [\#418](https://github.com/gnome-terminator/terminator/issues/418)
+- Unable to Install from Source [\#412](https://github.com/gnome-terminator/terminator/issues/412)
+- CTRL+A behaviour abnormal [\#384](https://github.com/gnome-terminator/terminator/issues/384)
+- regexp/command hyperlink handler [\#381](https://github.com/gnome-terminator/terminator/issues/381)
+- Update PPA to 2.1.0 [\#374](https://github.com/gnome-terminator/terminator/issues/374)
+- Create Snap and Flatpak for Terminator [\#206](https://github.com/gnome-terminator/terminator/issues/206)
+- Remove gtk-update-icon-cache handling in setup [\#102](https://github.com/gnome-terminator/terminator/issues/102)
+
+**Merged pull requests:**
+
+- update translations [\#656](https://github.com/gnome-terminator/terminator/pull/656) ([mattrose](https://github.com/mattrose))
+- Terminal ctrl+mousewheel: do not try to zoom if shift is pressed [\#609](https://github.com/gnome-terminator/terminator/pull/609) ([Vulcalien](https://github.com/Vulcalien))
+- More fixes to the Color pickers in the Preferences Editor [\#592](https://github.com/gnome-terminator/terminator/pull/592) ([mattrose](https://github.com/mattrose))
+- Modification in the /terminatorlib/prefseditor.py file [\#590](https://github.com/gnome-terminator/terminator/pull/590) ([amaan211](https://github.com/amaan211))
+- Various README fixes [\#588](https://github.com/gnome-terminator/terminator/pull/588) ([mattrose](https://github.com/mattrose))
+- Remove duplicated info in some debug messages [\#576](https://github.com/gnome-terminator/terminator/pull/576) ([Vulcalien](https://github.com/Vulcalien))
+- Added hotfix for \#78 that deletes GTK\_IM\_MODULE environment variable [\#574](https://github.com/gnome-terminator/terminator/pull/574) ([ozzdemir](https://github.com/ozzdemir))
+- Fix POTFILES.in + update translation files [\#571](https://github.com/gnome-terminator/terminator/pull/571) ([Vulcalien](https://github.com/Vulcalien))
+- Add initial flatpak-spawn support [\#570](https://github.com/gnome-terminator/terminator/pull/570) ([JayDoubleu](https://github.com/JayDoubleu))
+- Fix: handle\_size treated as cell\_width [\#561](https://github.com/gnome-terminator/terminator/pull/561) ([Vulcalien](https://github.com/Vulcalien))
+- Transifex translations from Dec 20 2021 [\#558](https://github.com/gnome-terminator/terminator/pull/558) ([mattrose](https://github.com/mattrose))
+- Unzoom terminal on interaction [\#553](https://github.com/gnome-terminator/terminator/pull/553) ([Vulcalien](https://github.com/Vulcalien))
+- Add ability to configure cell width \(font character spacing\) [\#552](https://github.com/gnome-terminator/terminator/pull/552) ([FernandoBasso](https://github.com/FernandoBasso))
+- Improve and optimize the code for background images [\#551](https://github.com/gnome-terminator/terminator/pull/551) ([Vulcalien](https://github.com/Vulcalien))
+- Fix: 'None' value for keybindings breaks editor [\#549](https://github.com/gnome-terminator/terminator/pull/549) ([Vulcalien](https://github.com/Vulcalien))
+- don't traceback while searching through /proc [\#546](https://github.com/gnome-terminator/terminator/pull/546) ([mattrose](https://github.com/mattrose))
+- os.environ does not have LANGUAGE in Centos8. [\#544](https://github.com/gnome-terminator/terminator/pull/544) ([xuezhixin](https://github.com/xuezhixin))
+- Remove Encoding settings \(deprecated\) [\#536](https://github.com/gnome-terminator/terminator/pull/536) ([Vulcalien](https://github.com/Vulcalien))
+- Allow multiline commands in Custom Commands plugin [\#525](https://github.com/gnome-terminator/terminator/pull/525) ([VDuchon](https://github.com/VDuchon))
+- Add paste\_selection keybinding. [\#520](https://github.com/gnome-terminator/terminator/pull/520) ([rkitover](https://github.com/rkitover))
+- Fix terminal separator size setting [\#519](https://github.com/gnome-terminator/terminator/pull/519) ([caprinux](https://github.com/caprinux))
+- Automatically focus the Keybindings menu [\#516](https://github.com/gnome-terminator/terminator/pull/516) ([Vulcalien](https://github.com/Vulcalien))
+- Fix hide\_window keybinding unset check [\#515](https://github.com/gnome-terminator/terminator/pull/515) ([tomty89](https://github.com/tomty89))
+- Add 'Disable mouse paste' [\#512](https://github.com/gnome-terminator/terminator/pull/512) ([Vulcalien](https://github.com/Vulcalien))
+- Bug Fix: hide\_window keybinding ignores Shift key [\#510](https://github.com/gnome-terminator/terminator/pull/510) ([Vulcalien](https://github.com/Vulcalien))
+- Improve argument parser + implement bash completion [\#506](https://github.com/gnome-terminator/terminator/pull/506) ([Vulcalien](https://github.com/Vulcalien))
+- add Set Window Title item to context menu [\#501](https://github.com/gnome-terminator/terminator/pull/501) ([mattrose](https://github.com/mattrose))
+- BugFix: terminal won't restart if there is no custom command [\#500](https://github.com/gnome-terminator/terminator/pull/500) ([Vulcalien](https://github.com/Vulcalien))
+- Add a "Copy" button to clone profiles [\#499](https://github.com/gnome-terminator/terminator/pull/499) ([Vulcalien](https://github.com/Vulcalien))
+- Make tabs detachable + minor bugfix [\#494](https://github.com/gnome-terminator/terminator/pull/494) ([Vulcalien](https://github.com/Vulcalien))
+- remove gtk-update-icon-cache from setup.py [\#493](https://github.com/gnome-terminator/terminator/pull/493) ([mattrose](https://github.com/mattrose))
+- remove vsplit\_cmd and hsplit\_cmd from ipc.py, superseded by newer hsp… [\#491](https://github.com/gnome-terminator/terminator/pull/491) ([mattrose](https://github.com/mattrose))
+- Update tr.po [\#490](https://github.com/gnome-terminator/terminator/pull/490) ([StephenPeringer](https://github.com/StephenPeringer))
+- add bg\_img and bg\_img\_all commands to remotinator [\#487](https://github.com/gnome-terminator/terminator/pull/487) ([mattrose](https://github.com/mattrose))
+- Cursor: make it possible to change foreground color \(\#467\) [\#486](https://github.com/gnome-terminator/terminator/pull/486) ([Vulcalien](https://github.com/Vulcalien))
+- fixes for --config-json [\#484](https://github.com/gnome-terminator/terminator/pull/484) ([mattrose](https://github.com/mattrose))
+- GUI: set all CheckButtons off to avoid blinking + remove grid empty rows/columns [\#482](https://github.com/gnome-terminator/terminator/pull/482) ([Vulcalien](https://github.com/Vulcalien))
+- Move titlebar settings to profiles \(\#379\) [\#481](https://github.com/gnome-terminator/terminator/pull/481) ([Vulcalien](https://github.com/Vulcalien))
+- Issue 365 [\#480](https://github.com/gnome-terminator/terminator/pull/480) ([mattrose](https://github.com/mattrose))
+- Fix typo in `po/de.po` [\#476](https://github.com/gnome-terminator/terminator/pull/476) ([dennis-benzinger-hybris](https://github.com/dennis-benzinger-hybris))
+- add parameters to remotinator split commands [\#472](https://github.com/gnome-terminator/terminator/pull/472) ([mattrose](https://github.com/mattrose))
+- add switch\_profile\_all command to remotinator [\#471](https://github.com/gnome-terminator/terminator/pull/471) ([mattrose](https://github.com/mattrose))
+- Set CAN\_FOCUS to False for notebook widgets [\#470](https://github.com/gnome-terminator/terminator/pull/470) ([marktimarev](https://github.com/marktimarev))
+- tell titlebar to start focussed out if it does not have focus [\#462](https://github.com/gnome-terminator/terminator/pull/462) ([mattrose](https://github.com/mattrose))
+- Update translation [\#460](https://github.com/gnome-terminator/terminator/pull/460) ([pktiuk](https://github.com/pktiuk))
+- Add new plugin for opening current directory using right mouse button [\#459](https://github.com/gnome-terminator/terminator/pull/459) ([pktiuk](https://github.com/pktiuk))
+- Fixed Issue \#425 \(hide\_window will try to show a destroyed window\) [\#456](https://github.com/gnome-terminator/terminator/pull/456) ([Vulcalien](https://github.com/Vulcalien))
+- Incorrect layout sorting in notebook [\#454](https://github.com/gnome-terminator/terminator/pull/454) ([AsadJivani](https://github.com/AsadJivani))
+- Closing tab on middle mouse button press [\#451](https://github.com/gnome-terminator/terminator/pull/451) ([kocho1984](https://github.com/kocho1984))
+- Bug Fix: 'Clear selection on copy' is always unchecked [\#443](https://github.com/gnome-terminator/terminator/pull/443) ([Vulcalien](https://github.com/Vulcalien))
+- Fixed issue \#433 \(layout sometimes ignores ratio\) [\#442](https://github.com/gnome-terminator/terminator/pull/442) ([Vulcalien](https://github.com/Vulcalien))
+- Fix the background image loading exception handling [\#436](https://github.com/gnome-terminator/terminator/pull/436) ([GerbenWelter](https://github.com/GerbenWelter))
+- Added set\_tab\_title command to remotinator. [\#435](https://github.com/gnome-terminator/terminator/pull/435) ([yusufgungor](https://github.com/yusufgungor))
+- Ukrainianized by 93% [\#428](https://github.com/gnome-terminator/terminator/pull/428) ([balac-ode](https://github.com/balac-ode))
+- Fixed geometry hints [\#416](https://github.com/gnome-terminator/terminator/pull/416) ([Vulcalien](https://github.com/Vulcalien))
+- Feat+run cmd on match [\#399](https://github.com/gnome-terminator/terminator/pull/399) ([nojhan](https://github.com/nojhan))
+- add feat: config to open links with single click [\#398](https://github.com/gnome-terminator/terminator/pull/398) ([nojhan](https://github.com/nojhan))
+- Add new vsplit hsplit cmd dbus [\#390](https://github.com/gnome-terminator/terminator/pull/390) ([TheBigS](https://github.com/TheBigS))
+- Added new get\_focused\_terminal dbus command which returns uuid of current focused terminal [\#389](https://github.com/gnome-terminator/terminator/pull/389) ([TheBigS](https://github.com/TheBigS))
+
+## [v2.1.1](https://github.com/gnome-terminator/terminator/tree/v2.1.1) (2021-04-02)
 
 [Full Changelog](https://github.com/gnome-terminator/terminator/compare/v2.1.0...v2.1.1)
 
@@ -43,6 +273,7 @@
 
 **Merged pull requests:**
 
+- Release version 2.1.1 [\#413](https://github.com/gnome-terminator/terminator/pull/413) ([mattrose](https://github.com/mattrose))
 - i18n: pt\_BR: add missing space in translations with shortcuts [\#406](https://github.com/gnome-terminator/terminator/pull/406) ([terceiro](https://github.com/terceiro))
 - Fixed race condition when calling grab\_focus after underlying vte could be closed [\#388](https://github.com/gnome-terminator/terminator/pull/388) ([TheBigS](https://github.com/TheBigS))
 - disable 2.7 tests until we can figure out how to run them in GH [\#386](https://github.com/gnome-terminator/terminator/pull/386) ([mattrose](https://github.com/mattrose))

INSTALL.md

@@ -117,5 +117,5 @@ Ubuntu       | copied from Debian | [launchpad.net/ubuntu] | | [bugs.launchpad.n
 
 A more extensive list can be found on Repology:
 
-[![Packaging status](https://repology.org/badge/vertical-allrepos/terminator.svg)](https://repology.org/project/terminator/versions)
+[![Packaging status](https://repology.org/badge/vertical-allrepos/terminator.svg?columns=3)](https://repology.org/project/terminator/versions)
 

README.md

@@ -1,7 +1,7 @@
 Terminator
 ==========
 
-by Chris Jones <cmsj@tenshu.net> and others.
+Started by Chris Jones <cmsj@tenshu.net> in 2007, maintained from 2014 to 2020 by Stephen Boddy, currently maintained by Matt Rose. Terminator has had contributions from countless others listed in the [AUTHORS](AUTHORS) file
 
 ## Description
 
@@ -82,6 +82,9 @@ vte-demo.py was not my code and is copyright its original author. While it
 does not contain any specific licensing information in it, the VTE package 
 appears to be licenced under LGPL v2.
 
+The original version 0.1 release of Terminator was on Saturday, 28 July 2007.
+ [Here is the archived Terminator 0.1 release announcement](http://cmsj.net/2007/07/28/terminator-01-released.html)
+
 ## Licensing
 
 The gedit terminal plugin is part of the gedit-plugins package, which is 

completion/bash

@@ -0,0 +1,16 @@
+# bash completion for terminator                           -*- shell-script -*-
+
+_terminator()
+{
+    local cur prev words cword
+    _init_completion || return
+
+    # TODO implement completion for --profile and --layout
+
+    COMPREPLY=($(compgen -W "$($1 --help | tr ',' '\n' |
+        command sed -n -e 's/^ *\(--\?[a-zA-Z\-]\+=\?\).*/\1/p')"\
+    -- "$cur"))
+} &&
+    complete -F _terminator terminator
+
+# ex: filetype=sh

data/layout-files-examples/README.md

@@ -1,6 +1,6 @@
 The JSONs files in this directory are example config files used by `--config-json` option.
 
-Once this feature would be documented officialy this directoy can be removed.
+Once this feature would be documented officially this directory can be removed.
 
 Example:
 ```

data/terminator.appdata.xml.in

@@ -47,4 +47,5 @@
  </screenshots>
  <url type="homepage">https://github.com/gnome-terminator/terminator</url>
  <updatecontact>terminator@lazyfrosch.de</updatecontact>
+ <developer_name>The Terminator Team</developer_name>
 </component>

doc/gen_manpages.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+
+asciidoctor -b manpage terminator.adoc
+asciidoctor -b manpage terminator_config.adoc

doc/terminator.1

@@ -1,286 +1,485 @@
-.TH "TERMINATOR" "1" "Jan 5, 2008" "" ""
+'\" t
+.\"     Title: terminator
+.\"    Author: [see the "AUTHOR(S)" section]
+.\" Generator: Asciidoctor 2.0.18
+.\"      Date: 2023-04-01
+.\"    Manual: Manual for Terminator
+.\"    Source: Terminator
+.\"  Language: English
+.\"
+.TH "TERMINATOR" "1" "2023-04-01" "Terminator" "Manual for Terminator"
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.ss \n[.ss] 0
+.nh
+.ad l
+.de URL
+\fI\\$2\fP <\\$1>\\$3
+..
+.als MTO URL
+.if \n[.g] \{\
+.  mso www.tmac
+.  am URL
+.    ad l
+.  .
+.  am MTO
+.    ad l
+.  .
+.  LINKSTYLE blue R < >
+.\}
 .SH "NAME"
-Terminator \- Multiple GNOME terminals in one window
+terminator \- multiple GNOME terminals in one window
 .SH "SYNOPSIS"
-.B terminator
+.sp
-.RI [ options ]
+\fBterminator\fP [\fIoptions\fP]
-.br
 .SH "DESCRIPTION"
+.sp
 This manual page documents \fBTerminator\fP, a terminal emulator application.
-.PP
+.sp
 \fBTerminator\fP is a program that allows users to set up flexible
 arrangements of GNOME terminals. It is aimed at those who normally
-arrange lots of terminals near each other, but don't want to use a
+arrange lots of terminals near each other, but don\(cqt want to use a
 frame based window manager.
 .SH "OPTIONS"
-This program follow the usual GNU command line syntax, with long
+.sp
-options starting with two dashes (`\-').
+This program follows the usual GNU command line syntax, with long
+options starting with two dashes (`\-\*(Aq).
 A summary of options is included below.
-.TP
+.sp
-.B \-h, \-\-help
+\fB\-h\fP, \fB\-\-help\fP
-Show summary of options
+.RS 4
-.TP
+Show summary of options.
-.B \-v, \-\-version
+.RE
-Show the version of the Terminator installation
+.sp
-.TP
+\fB\-v\fP, \fB\-\-version\fP
-.B \-m, \-\-maximise
+.RS 4
-Start with a maximised window
+Show the version of the Terminator installation.
-.B \-M, \-\-maximize
+.RE
-Start with a maximized window
+.sp
-.TP
+\fB\-m\fP, \fB\-M\fP, \fB\-\-maximise\fP, \fB\-\-maximize\fP
-.B \-f, \-\-fullscreen
+.RS 4
-Start with a fullscreen window
+Start with a maximised window.
-.TP
+.RE
-.B \-b, \-\-borderless
+.sp
-Instruct the window manager not to render borders/decoration on the
+\fB\-f\fP, \fB\-\-fullscreen\fP
-Terminator window (this works well with \-m)
+.RS 4
-.TP
+Start with a fullscreen window.
-.B \-H, \-\-hidden
+.RE
+.sp
+\fB\-b\fP, \fB\-\-borderless\fP
+.RS 4
+Instruct the window manager not to render borders/decorations on the
+Terminator window (this works well with \-\-maximise).
+.RE
+.sp
+\fB\-H\fP, \fB\-\-hidden\fP
+.RS 4
 Hide the Terminator window by default. Its visibility can be toggled
-with the \fBhide_window\fR keyboard shortcut (Ctrl-Shift-Alt-a by default)
+with the \fBhide_window\fP keyboard shortcut (Ctrl+Shift+Alt+A by default).
-.TP
+.RE
-.B \-T, \-\-title
+.sp
-Force the Terminator window to use a specific name rather than updating it dynamically
+\fB\-T\fP \fIFORCEDTITLE\fP, \fB\-\-title\fP=\fIFORCEDTITLE\fP
-based on the wishes of the child shell.
+.RS 4
-.TP
+Force the Terminator window to use a specific name rather than updating
-.B \-\-geometry=GEOMETRY
+it dynamically based on the wishes of the child shell.
-Specifies the preferred size and position of Terminator's window; see X(7).
+.RE
-.TP
+.sp
-.B \-e, \-\-command=COMMAND
+\fB\-\-geometry\fP=\fIGEOMETRY\fP
-Runs the specified command instead of your default shell or profile specified command. Note: if
+.RS 4
-Terminator is launched as x-terminal-emulator \-e behaves like \-x, and the longform becomes
+Specify the preferred size and position of Terminator\(cqs window;
-\-\-execute2=COMMAND
+see \fBX\fP(7).
-.TP
+.RE
-.B \-x, \-\-execute COMMAND [ARGS]
+.sp
-Runs \fBthe rest of the command line\fR instead of your default shell or profile specified command.
+\fB\-e\fP \fICOMMAND\fP, \fB\-\-command\fP=\fICOMMAND\fP
-.TP
+.RS 4
-.B \-\-working\-directory=DIR
+Run the specified command instead of the default shell or profile
-Set the terminal's working directory
+specified command.
-.TP
+.br
-.B \-g, \-\-config FILE
+Note: if Terminator is launched as x\-terminal\-emulator \-e behaves like
-Use the specified FILE for configuration
+\-x, and the longform becomes \-\-execute2=COMMAND.
-.TP
+.RE
-.B \-r, \-\-role=ROLE
+.sp
-Set a custom WM_WINDOW_ROLE property on the window
+\fB\-x\fP \fICOMMAND\fP [\fIARGS\fP], \fB\-\-execute\fP=\fICOMMAND\fP [\fIARGS\fP]
-.TP
+.RS 4
-.B \-l, \-\-layout=LAYOUT
+Run \fBthe rest of the command line\fP instead of the default shell or
+profile specified command.
+.RE
+.sp
+\fB\-\-working\-directory\fP=\fIDIR\fP
+.RS 4
+Set the terminal\(cqs working directory.
+.RE
+.sp
+\fB\-g\fP \fIFILE\fP, \fB\-\-config\fP=\fIFILE\fP
+.RS 4
+Use the specified file for configuration.
+.RE
+.sp
+\fB\-r\fP \fIROLE\fP, \fB\-\-role\fP=\fIROLE\fP
+.RS 4
+Set a custom WM_WINDOW_ROLE property on the window.
+.RE
+.sp
+\fB\-l\fP \fILAYOUT\fP, \fB\-\-layout\fP=\fILAYOUT\fP
+.RS 4
 Start Terminator with a specific layout. The argument here is the name
 of a saved layout.
-.TP
+.RE
-.B \-s, \-\-select-layout=LAYOUT
+.sp
+\fB\-s\fP \fILAYOUT\fP, \fB\-\-select\-layout\fP=\fILAYOUT\fP
+.RS 4
 Open the layout launcher window instead of the normal terminal.
-.TP
+.RE
-.B \-p, \-\-profile=PROFILE
+.sp
-Use a different profile as the default
+\fB\-p\fP, \fB\-\-profile\fP=\fIPROFILE\fP
-.TP
+.RS 4
-.B \-i, \-\-icon=FORCEDICON
+Use a different profile as the default.
+.RE
+.sp
+\fB\-i\fP, \fB\-\-icon\fP=\fIFORCEDICON\fP
+.RS 4
 Set a custom icon for the window (by file or name)
-.TP
+.RE
-.B \-u, \-\-no-dbus
+.sp
-Disable DBus
+\fB\-u\fP, \fB\-\-no\-dbus\fP
-.TP
+.RS 4
-.B \-d, \-\-debug
+Disable DBus.
-Enable debugging output (please use this when reporting bugs). This
+.RE
-can be specified twice to enable a built-in python debugging server.
+.sp
-.TP
+\fB\-d\fP, \fB\-\-debug\fP
-.B \-\-debug\-classes=DEBUG_CLASSES
+.RS 4
+Enable debugging output (please use this when reporting bugs). This can
+be specified twice to enable a built\-in python debugging server.
+.RE
+.sp
+\fB\-\-debug\-classes\fP=\fIDEBUG_CLASSES\fP
+.RS 4
 If this is specified as a comma separated list, debugging output will
 only be printed from the specified classes.
-.TP
+.RE
-.B \-\-debug\-methods=DEBUG_METHODS
+.sp
+\fB\-\-debug\-methods\fP=\fIDEBUG_METHODS\fP
+.RS 4
 If this is specified as a comma separated list, debugging output will
 only be printed from the specified functions. If this is specified in
-addition to \-\-debug-classes, only the intersection of the two lists
+addition to \-\-debug\-classes, only the intersection of the two lists will
-will be displayed
+be displayed.
-.TP
+.RE
-.B \-\-new-tab
+.sp
+\fB\-\-new\-tab\fP
+.RS 4
 If this is specified and Terminator is already running, DBus will be
 used to spawn a new tab in the first Terminator window.
+.RE
+.sp
+\fB\-\-toggle\-visibility\fP
+.RS 4
+If this is specified and Terminator is already running, DBus will be
+used to toggle Terminator window visibility. Usable under Wayland to
+replace hide keyboad shortcut.
+.RE
 .SH "KEYBINDINGS"
-The following default keybindings can be used to control Terminator:
+.sp
-.TP
+The following default keybindings can be used to control Terminator.
-.B F1
+Most of these keybindings can be changed in the Preferences.
+.sp
+\fBF1\fP
+.RS 4
 Launches the full HTML manual.
-.SS Creation & Destruction
+.RE
-.PP
+.SS "Creation & Destruction"
+.sp
 The following items relate to creating and destroying terminals.
-.TP
+.sp
-.B Ctrl+Shift+O
+\fBCtrl+Shift+O\fP
-Split terminals H\fBo\fRrizontally.
+.RS 4
-.TP
+Split terminals H\fIo\fPrizontally.
-.B Ctrl+Shift+E
+.RE
-Split terminals V\fBe\fRrtically.
+.sp
-.TP
+\fBCtrl+Shift+E\fP
-.B Ctrl+Shift+T
+.RS 4
-Open new \fBt\fRab.
+Split terminals V\fIe\fPrtically.
-.TP
+.RE
-.B Ctrl+Shift+I
+.sp
-Open a new window. (Note: Unlike in previous releases, this window is
+\fBCtrl+Shift+T\fP
-part of the same Terminator process.)
+.RS 4
-.TP
+Open new \fIt\fPab.
-.B Super+I
+.RE
+.sp
+\fBCtrl+Shift+I\fP
+.RS 4
+Open a new window.
+.br
+(Note: unlike in previous releases, this window is part of the same
+Terminator process.)
+.RE
+.sp
+\fBSuper+I\fP
+.RS 4
 Spawn a new Terminator process.
-.TP
+.RE
-.B Alt+L
+.sp
-Open \fBl\fRayout launcher.
+\fBAlt+L\fP
-.TP
+.RS 4
-.B Ctrl+Shift+W
+Open \fIl\fPayout launcher.
+.RE
+.sp
+\fBCtrl+Shift+W\fP
+.RS 4
 Close the current terminal.
-.TP
+.RE
-.B Ctrl+Shift+Q
+.sp
+\fBCtrl+Shift+Q\fP
+.RS 4
 Close the current window.
-.SS Navigation
+.RE
-.PP
+.SS "Navigation"
+.sp
 The following items relate to moving between and around terminals.
-.TP
+.sp
-.B Alt+Up
+\fBAlt+Up\fP
-Move to the terminal \fBabove\fR the current one.
+.RS 4
-.TP
+Move to the terminal \fBabove\fP the current one.
-.B Alt+Down
+.RE
-Move to the terminal \fBbelow\fR the current one.
+.sp
-.TP
+\fBAlt+Down\fP
-.B Alt+Left
+.RS 4
-Move to the terminal \fBleft of\fR the current one.
+Move to the terminal \fBbelow\fP the current one.
-.TP
+.RE
-.B Alt+Right
+.sp
-Move to the terminal \fBright of\fR the current one.
+\fBAlt+Left\fP
-.TP
+.RS 4
-.B Ctrl+PageDown
+Move to the terminal \fBleft of\fP the current one.
-Move to next Tab.
+.RE
-.TP
+.sp
-.B Ctrl+PageUp
+\fBAlt+Right\fP
-Move to previous Tab.
+.RS 4
-.TP
+Move to the terminal \fBright of\fP the current one.
-.B Ctrl+Shift+N or Ctrl+Tab
+.RE
-Move to \fBn\fRext terminal within the same tab, use Ctrl+PageDown to move to the next tab.
+.sp
-If \fBcycle_term_tab\fR is \fBFalse\fR, cycle within the same tab will be disabled.
+\fBCtrl+PageDown\fP
-.TP
+.RS 4
-.B Ctrl+Shift+P or Ctrl+Shift+Tab
+Move to next tab.
-Move to \fBp\fRrevious terminal within the same tab, use Ctrl+PageUp to move to the previous tab.
+.RE
-If \fBcycle_term_tab\fR is \fBFalse\fR, cycle within the same tab will be disabled.
+.sp
-.SS Organisation
+\fBCtrl+PageUp\fP
-.PP
+.RS 4
+Move to previous tab.
+.RE
+.sp
+\fBCtrl+Shift+N\fP or \fBCtrl+Tab\fP
+.RS 4
+Move to the \fIn\fPext terminal within the same tab.
+.br
+.RE
+.sp
+\fBCtrl+Shift+P\fP or \fBCtrl+Shift+Tab\fP
+.RS 4
+Move to the \fIp\fPrevious terminal within the same tab.
+.br
+.RE
+.SS "Organisation"
+.sp
 The following items relate to arranging and resizing terminals.
-.TP
+.sp
-.B Ctrl+Shift+Right
+\fBCtrl+Shift+Right\fP
-Move parent dragbar \fBRight\fR.
+.RS 4
-.TP
+Move parent dragbar \fBright\fP.
-.B Ctrl+Shift+Left
+.RE
-Move parent dragbar \fBLeft\fR.
+.sp
-.TP
+\fBCtrl+Shift+Left\fP
-.B Ctrl+Shift+Up
+.RS 4
-Move parent dragbar \fBUp\fR.
+Move parent dragbar \fBleft\fP.
-.TP
+.RE
-.B Ctrl+Shift+Down
+.sp
-Move parent dragbar \fBDown\fR.
+\fBCtrl+Shift+Up\fP
-.TP
+.RS 4
-.B Super+R
+Move parent dragbar \fBup\fP.
-\fBR\fRotate terminals clockwise.
+.RE
-.TP
+.sp
-.B Super+Shift+R
+\fBCtrl+Shift+Down\fP
-\fBR\fRotate terminals counter-clockwise.
+.RS 4
-.TP
+Move parent dragbar \fBdown\fP.
-.SH "Drag and Drop"
+.RE
+.sp
+\fBSuper+R\fP
+.RS 4
+\fIR\fPotate terminals clockwise.
+.RE
+.sp
+\fBSuper+Shift+R\fP
+.RS 4
+\fIR\fPotate terminals counter\-clockwise.
+.RE
+.sp
+\fBCtrl+Shift+PageDown\fP
+.RS 4
+Swap tab position with next tab.
+.RE
+.sp
+\fBCtrl+Shift+PageUp\fP
+.RS 4
+Swap tab position with previous tab.
+.RE
+.sp
+\fBDrag and Drop\fP
+.RS 4
 The layout can be modified by moving terminals with Drag and Drop.
 To start dragging a terminal, click and hold on its titlebar.
 Alternatively, hold down \fBCtrl\fP, click and hold the \fBright\fP mouse button.
-Then, \fB**Release Ctrl**\fP. You can now drag the terminal to the point in the layout you would like it to be.
+Then, \fB**release Ctrl**\fP. You can now drag the terminal to the point
-The zone where the terminal would be inserted will be highlighted.
+in the layout you would like it to be. The zone where the terminal would
-.TP
+be inserted will be highlighted.
-.B Ctrl+Shift+PageDown
+.RE
-Swap tab position with next Tab.
+.SS "Focus"
-.TP
+.sp
-.B Ctrl+Shift+PageUp
-Swap tab position with previous Tab.
-.SS Miscellaneous
-.PP
-The following items relate to miscellaneous terminal related functions.
-.TP
-.B Ctrl+Shift+C
-Copy selected text to clipboard.
-.TP
-.B Ctrl+Shift+V
-Paste clipboard text.
-.TP
-.B Ctrl+Shift+S
-Hide/Show \fBS\fRcrollbar.
-.TP
-.B Ctrl+Shift+F
-Search within terminal scrollback.
-.TP
-.B Ctrl+Shift+R
-Reset terminal state.
-.TP
-.B Ctrl+Shift+G
-Reset terminal state and clear window.
-.TP
-.B Ctrl+Plus (+)
-Increase font size. \fBNote:\fP This may require you to press shift, depending on your keyboard.
-.TP
-.B Ctrl+Minus (-)
-Decrease font size. \fBNote:\fP This may require you to press shift, depending on your keyboard.
-.TP
-.B Ctrl+Zero (0)
-Restore font size to original setting.
-.TP
-.B Ctrl+Alt+W
-Rename window title.
-.TP
-.B Ctrl+Alt+A
-Rename tab title.
-.TP
-.B Ctrl+Alt+X
-Rename terminal title.
-.TP
-.B Super+1
-Insert terminal number, i.e. 1 to 12.
-.TP
-.B Super+0
-Insert padded terminal number, i.e. 01 to 12.
-.SS Grouping & Broadcasting
-.PP
 The following items relate to helping to focus on a specific terminal.
-.TP
+.sp
-.B F11
+\fBF11\fP
+.RS 4
 Toggle window to fullscreen.
-.TP
+.RE
-.B Ctrl+Shift+X
+.sp
-Toggle between showing all terminals and only showing the current one (maximise).
+\fBCtrl+Shift+X\fP
-.TP
+.RS 4
-.B Ctrl+Shift+Z
+Toggle between showing all terminals and only showing the current one
-Toggle between showing all terminals and only showing a scaled version of the current one (zoom).
+(maximise).
-.TP
+.RE
-.B Ctrl+Shift+Alt+A
+.sp
-Hide the initial window. Note that this is a global binding, and can only be bound once.
+\fBCtrl+Shift+Z\fP
-.PP
+.RS 4
+Toggle between showing all terminals and only showing a scaled version
+of the current one (zoom).
+.RE
+.sp
+\fBCtrl+Shift+Alt+A\fP
+.RS 4
+Hide the initial window. Note that this is a X11 global binding, and can
+only be bound once. On Wayland use window manager keyboard shortcuts to
+call \fBterminator \-\-toggle\-visibility\fP.
+.RE
+.SS "Grouping & Broadcasting"
+.sp
 The following items relate to grouping and broadcasting.
-.TP
+.sp
-.B Super+T
+\fBSuper+T\fP
-Group all terminals in the current tab so input sent to one of them, goes to all terminals in the current tab.
+.RS 4
-.TP
+Group all terminals in the current tab so that any input sent to one of
-.B Super+Shift+T
+them goes to all of them.
+.RE
+.sp
+\fBSuper+Shift+T\fP
+.RS 4
 Remove grouping from all terminals in the current tab.
-.TP
+.RE
-.B Super+G
+.sp
-Group all terminals so that any input sent to one of them, goes to all of them.
+\fBSuper+G\fP
-.TP
+.RS 4
-.B Super+Shift+G
+Group all terminals so that any input sent to one of them goes to all of
+them.
+.RE
+.sp
+\fBSuper+Shift+G\fP
+.RS 4
 Remove grouping from all terminals.
-.TP
+.RE
-.B Alt+A
+.sp
-Broadcast to All terminals.
+\fBAlt+A\fP
-.TP
+.RS 4
-.B Alt+G
+Broadcast to \fIa\fPll terminals.
-Broadcast to Grouped terminals.
+.RE
-.TP
+.sp
-.B Alt+O
+\fBAlt+G\fP
-Broadcast Off.
+.RS 4
-.PP
+Broadcast to \fIg\fProuped terminals.
-Most of these keybindings are changeable in the Preferences.
+.RE
-.SH "SEE ALSO"
+.sp
-.BR terminator_config(5)
+\fBAlt+O\fP
-.SH "AUTHOR"
+.RS 4
+Broadcast \fIo\fPff.
+.RE
+.SS "Miscellaneous"
+.sp
+The following items relate to miscellaneous terminal related functions.
+.sp
+\fBCtrl+Shift+C\fP
+.RS 4
+Copy selected text to clipboard.
+.RE
+.sp
+\fBCtrl+Shift+V\fP
+.RS 4
+Paste clipboard text.
+.RE
+.sp
+\fBCtrl+Shift+S\fP
+.RS 4
+Toggle \fIs\fPcrollbar.
+.RE
+.sp
+\fBCtrl+Shift+F\fP
+.RS 4
+Search within terminal scrollback.
+.RE
+.sp
+\fBCtrl+Shift+R\fP
+.RS 4
+Reset terminal state.
+.RE
+.sp
+\fBCtrl+Shift+G\fP
+.RS 4
+Reset terminal state and clear window.
+.RE
+.sp
+\fBCtrl+Plus (+)\fP
+.RS 4
+Increase font size.
+.br
+Note: this may require you to press shift, depending on your keyboard.
+.RE
+.sp
+\fBCtrl+Minus (\-)\fP
+.RS 4
+Decrease font size.
+.br
+Note: this may require you to press shift, depending on your keyboard.
+.RE
+.sp
+\fBCtrl+Zero (0)\fP
+.RS 4
+Restore font size to original setting.
+.RE
+.sp
+\fBCtrl+Alt+W\fP
+.RS 4
+Rename window title.
+.RE
+.sp
+\fBCtrl+Alt+A\fP
+.RS 4
+Rename tab title.
+.RE
+.sp
+\fBCtrl+Alt+X\fP
+.RS 4
+Rename terminal title.
+.RE
+.sp
+\fBSuper+1\fP
+.RS 4
+Insert terminal number, i.e. 1 to 12.
+.RE
+.sp
+\fBSuper+0\fP
+.RS 4
+Insert padded terminal number, i.e. 01 to 12.
+.RE
+.SH "AUTHORS"
+.sp
 Terminator was written by Chris Jones <cmsj@tenshu.net> and others.
-.PP
+.sp
-This manual page was written by Chris Jones <cmsj@tenshu.net>
+This manual page was written by Chris Jones <cmsj@tenshu.net> and others.
-and others.
+.SH "SEE ALSO"
+.sp
+\fBterminator_config\fP(5)

doc/terminator.adoc

@@ -0,0 +1,312 @@
+= Terminator(1)
+:doctype: manpage
+:manmanual: Manual for Terminator
+:mansource: Terminator
+:revdate: 2023-04-01
+:docdate: {revdate}
+
+== NAME
+terminator - multiple GNOME terminals in one window
+
+== SYNOPSIS
+*terminator* [_options_]
+
+== DESCRIPTION
+This manual page documents *Terminator*, a terminal emulator application.
+
+*Terminator* is a program that allows users to set up flexible
+arrangements of GNOME terminals. It is aimed at those who normally
+arrange lots of terminals near each other, but don't want to use a
+frame based window manager.
+
+== OPTIONS
+This program follows the usual GNU command line syntax, with long
+options starting with two dashes (`-').
+A summary of options is included below.
+
+*-h*, *--help*::
+Show summary of options.
+
+*-v*, *--version*::
+Show the version of the Terminator installation.
+
+*-m*, *-M*, *--maximise*, *--maximize*::
+Start with a maximised window.
+
+*-f*, *--fullscreen*::
+Start with a fullscreen window.
+
+*-b*, *--borderless*::
+Instruct the window manager not to render borders/decoration on the
+Terminator window (this works well with --maximise).
+
+*-H*, *--hidden*::
+Hide the Terminator window by default. Its visibility can be toggled
+with the *hide_window* keyboard shortcut (Ctrl+Shift+Alt+A by default).
+
+*-T* _FORCEDTITLE_, **--title**=__FORCEDTITLE__::
+Force the Terminator window to use a specific name rather than updating
+it dynamically based on the wishes of the child shell.
+
+**--geometry**=__GEOMETRY__::
+Specify the preferred size and position of Terminator's window;
+see *X*(7).
+
+*-e* _COMMAND_, **--command**=__COMMAND__::
+Run the specified command instead of the default shell or profile
+specified command. +
+Note: if Terminator is launched as x-terminal-emulator -e behaves like
+-x, and the longform becomes --execute2=COMMAND.
+
+*-x* _COMMAND_ [__ARGS__], **--execute**=__COMMAND__ [__ARGS__]::
+Run *the rest of the command line* instead of the default shell or
+profile specified command.
+
+**--working-directory**=__DIR__::
+Set the terminal's working directory.
+
+*-g* _FILE_, **--config**=__FILE__::
+Use the specified file for configuration.
+
+// TODO --config-json option
+
+*-r* _ROLE_, **--role**=__ROLE__::
+Set a custom WM_WINDOW_ROLE property on the window.
+
+*-l* _LAYOUT_, **--layout**=__LAYOUT__::
+Start Terminator with a specific layout. The argument here is the name
+of a saved layout.
+
+*-s* _LAYOUT_, **--select-layout**=__LAYOUT__::
+Open the layout launcher window instead of the normal terminal.
+
+*-p*, **--profile**=__PROFILE__::
+Use a different profile as the default.
+
+*-i*, **--icon**=__FORCEDICON__::
+Set a custom icon for the window (by file or name)
+
+*-u*, *--no-dbus*::
+Disable DBus.
+// Could 'Start Terminator with DBus disabled.' be better?
+
+*-d*, *--debug*::
+Enable debugging output (please use this when reporting bugs). This can
+be specified twice to enable a built-in python debugging server.
+
+**--debug-classes**=__DEBUG_CLASSES__::
+If this is specified as a comma separated list, debugging output will
+only be printed from the specified classes.
+
+**--debug-methods**=__DEBUG_METHODS__::
+If this is specified as a comma separated list, debugging output will
+only be printed from the specified functions. If this is specified in
+addition to --debug-classes, only the intersection of the two lists will
+be displayed.
+
+*--new-tab*::
+If this is specified and Terminator is already running, DBus will be
+used to spawn a new tab in the first Terminator window.
+
+*--toggle-visibility*::
+If this is specified and Terminator is already running, DBus will be
+used to toggle Terminator window visibility. Usable under Wayland to
+replace hide keyboad shortcut.
+
+== KEYBINDINGS
+The following default keybindings can be used to control Terminator.
+Most of these keybindings can be changed in the Preferences.
+
+*F1*::
+Launches the full HTML manual.
+
+=== Creation & Destruction
+The following items relate to creating and destroying terminals.
+
+*Ctrl+Shift+O*::
+Split terminals H__o__rizontally.
+
+*Ctrl+Shift+E*::
+Split terminals V__e__rtically.
+
+*Ctrl+Shift+T*::
+Open new __t__ab.
+
+*Ctrl+Shift+I*::
+Open a new window. +
+(Note: unlike in previous releases, this window is part of the same
+Terminator process.)
+
+*Super+I*::
+Spawn a new Terminator process.
+
+*Alt+L*::
+Open __l__ayout launcher.
+
+*Ctrl+Shift+W*::
+Close the current terminal.
+
+*Ctrl+Shift+Q*::
+Close the current window.
+
+=== Navigation
+The following items relate to moving between and around terminals.
+
+*Alt+Up*::
+Move to the terminal *above* the current one.
+
+*Alt+Down*::
+Move to the terminal *below* the current one.
+
+*Alt+Left*::
+Move to the terminal *left of* the current one.
+
+*Alt+Right*::
+Move to the terminal *right of* the current one.
+
+*Ctrl+PageDown*::
+Move to next tab.
+
+*Ctrl+PageUp*::
+Move to previous tab.
+
+*Ctrl+Shift+N* or *Ctrl+Tab*::
+Move to the __n__ext terminal within the same tab. +
+
+*Ctrl+Shift+P* or *Ctrl+Shift+Tab*::
+Move to the __p__revious terminal within the same tab. +
+
+=== Organisation
+The following items relate to arranging and resizing terminals.
+
+*Ctrl+Shift+Right*::
+Move parent dragbar *right*.
+
+*Ctrl+Shift+Left*::
+Move parent dragbar *left*.
+
+*Ctrl+Shift+Up*::
+Move parent dragbar *up*.
+
+*Ctrl+Shift+Down*::
+Move parent dragbar *down*.
+
+*Super+R*::
+__R__otate terminals clockwise.
+
+*Super+Shift+R*::
+__R__otate terminals counter-clockwise.
+
+*Ctrl+Shift+PageDown*::
+Swap tab position with next tab.
+
+*Ctrl+Shift+PageUp*::
+Swap tab position with previous tab.
+
+*Drag and Drop*::
+The layout can be modified by moving terminals with Drag and Drop.
+To start dragging a terminal, click and hold on its titlebar.
+Alternatively, hold down *Ctrl*, click and hold the *right* mouse button.
+Then, *+**release Ctrl**+*. You can now drag the terminal to the point
+in the layout you would like it to be. The zone where the terminal would
+be inserted will be highlighted.
+
+=== Focus
+The following items relate to helping to focus on a specific terminal.
+
+*F11*::
+Toggle window to fullscreen.
+
+*Ctrl+Shift+X*::
+Toggle between showing all terminals and only showing the current one
+(maximise).
+
+*Ctrl+Shift+Z*::
+Toggle between showing all terminals and only showing a scaled version
+of the current one (zoom).
+
+*Ctrl+Shift+Alt+A*::
+Hide the initial window. Note that this is a X11 global binding, and can
+only be bound once. On Wayland use window manager keyboard shortcuts to
+call *terminator --toggle-visibility*.
+
+=== Grouping & Broadcasting
+The following items relate to grouping and broadcasting.
+
+*Super+T*::
+Group all terminals in the current tab so that any input sent to one of
+them goes to all of them.
+
+*Super+Shift+T*::
+Remove grouping from all terminals in the current tab.
+
+*Super+G*::
+Group all terminals so that any input sent to one of them goes to all of
+them.
+
+*Super+Shift+G*::
+Remove grouping from all terminals.
+
+*Alt+A*::
+Broadcast to __a__ll terminals.
+
+*Alt+G*::
+Broadcast to __g__rouped terminals.
+
+*Alt+O*::
+Broadcast __o__ff.
+
+=== Miscellaneous
+The following items relate to miscellaneous terminal related functions.
+
+*Ctrl+Shift+C*::
+Copy selected text to clipboard.
+
+*Ctrl+Shift+V*::
+Paste clipboard text.
+
+*Ctrl+Shift+S*::
+Toggle __s__crollbar.
+
+*Ctrl+Shift+F*::
+Search within terminal scrollback.
+
+*Ctrl+Shift+R*::
+Reset terminal state.
+
+*Ctrl+Shift+G*::
+Reset terminal state and clear window.
+
+*Ctrl+Plus (+)*::
+Increase font size. +
+Note: this may require you to press shift, depending on your keyboard.
+
+*Ctrl+Minus (-)*::
+Decrease font size. +
+Note: this may require you to press shift, depending on your keyboard.
+
+*Ctrl+Zero (0)*::
+Restore font size to original setting.
+
+*Ctrl+Alt+W*::
+Rename window title.
+
+*Ctrl+Alt+A*::
+Rename tab title.
+
+*Ctrl+Alt+X*::
+Rename terminal title.
+
+*Super+1*::
+Insert terminal number, i.e. 1 to 12.
+
+*Super+0*::
+Insert padded terminal number, i.e. 01 to 12.
+
+== AUTHORS
+Terminator was written by Chris Jones <\cmsj@tenshu.net> and others.
+
+This manual page was written by Chris Jones <\cmsj@tenshu.net> and others.
+
+== SEE ALSO
+*terminator_config*(5)

doc/terminator_config.adoc

@@ -0,0 +1,927 @@
+= Terminator_config(5)
+:doctype: manpage
+:manmanual: Manual for Terminator
+:mansource: Terminator
+:revdate: 2023-04-22
+:docdate: {revdate}
+
+== NAME
+terminator_config - the config file for Terminator terminal emulator
+
+== DESCRIPTION
+This file contains the configuration for *terminator*(1).
+Terminator manages its configuration file via the ConfigObj library to
+combine flexibility with clear, human editable files. +
+Terminator offers a full GUI preferences editor which automatically
+saves its config file so you don't need to write a config file by hand.
+
+== FILE LOCATION
+Normally the config file will be *~/.config/terminator/config*, but it
+may be overridden with *$XDG_CONFIG_HOME* (in which case it will be
+*$XDG_CONFIG_HOME/terminator/config*).
+
+== FILE FORMAT
+This is what a Terminator config file should look like:
+
+----
+# This is a comment
+[global_config]
+  focus = system
+
+[keybindings]
+  full_screen = <Ctrl><Shift>F11
+
+[profiles]
+  [[default]]
+    font = Fixed 10
+    background_color = "#000000" # A comment
+    foreground_color = "#FFFFFF" # Note that hex colour values must be quoted
+    scrollback_lines = '500' #More comment. Single quotes are valid too
+    cursor_blink = True
+    custom_command = "echo \"foo#bar\"" #Final comment - this will work as expected.
+
+[layouts]
+  [[default]]
+    [[[window0]]]
+      type = Window
+      parent = ""
+    [[[child1]]]
+      type = Terminal
+      parent = window0
+
+[plugins]
+----
+
+// ================================================================== \\
+
+== global_config
+These are the options Terminator currently supports in the
+*global_config* section.
+
+=== Window Behavior & Appearance
+
+// --- Window behavior ---
+
+*window_state* = _string_::
+Control how the Terminator window opens.
+'normal' to open normally.
+'maximise' to open in a maximised state.
+'fullscreen' to open in a fullscreen state.
+'hidden' to stay hidden. +
+Default value: *normal*
+
+*always_on_top* = _boolean_::
+If set to True, the window will always stay on top of other windows. +
+Default value: *False*
+
+*sticky* = _boolean_::
+If set to True, the window will be visible on all workspaces. +
+Default value: *False*
+
+*hide_on_lose_focus* = _boolean_::
+If set to True, the window will be hidden when focus is lost. +
+Default value: *False*
+
+*hide_from_taskbar* = _boolean_::
+If set to True, the window will be hidden from the taskbar. +
+Default value: *False*
+
+*geometry_hinting* = _boolean_::
+If set to True, the window will resize in step with font sizes. +
+Default value: *False*
+
+*suppress_multiple_term_dialog* = _boolean_::
+If set to True, Terminator will ask for confirmation when closing
+multiple terminals. +
+Default value: *False*
+
+// --- Window appearance ---
+
+*borderless* = _boolean_::
+If set to True, the window will be started without window borders. +
+Default value: *False*
+
+=== Tab Behavior & Appearance
+
+*tab_position* = _string_::
+Specify where tabs are placed.
+Can be any of: 'top', 'left', 'right', 'bottom', 'hidden'.
+If set to 'hidden', the tab bar will not be shown. Hiding the tab is not
+recommended, as it can be very confusing. +
+Default value: *top*
+
+*close_button_on_tab* = _boolean_::
+If set to True, tabs will have a close button on them. +
+Default value: *True*
+
+// what is this???
+*scroll_tabbar* = _boolean_::
+If set to True, the tab bar will not fill the width of the window.
+The titlebars of the tabs will only take as much space as is necessary
+for the text they contain. Except, that is, if the tabs no longer fit
+the width of the window - in that case scroll buttons will appear to
+move through the tabs. +
+Default value: *False*
+
+=== Terminal Behavior & Appearance
+
+// --- Terminal behavior ---
+
+*focus* = _string_::
+Specify how focus is given to terminals.
+'click' means the focus only moves to a terminal after you click in it.
+'sloppy' means the focus will follow the mouse pointer.
+'system' means the focus will match that used by a GNOME window manager. +
+Default value: *click*
+
+*always_split_with_profile* = _boolean_::
+Specify whether splits/tabs will continue to use the profile of their
+peer terminal. If set to False, they will always use the default profile. +
+Default value: *False*
+
+*link_single_click* = _boolean_::
+If set to True, clicking a link will open it even if *Ctrl* is not
+pressed. +
+Default value: *False*
+
+// --- Copy & Paste behavior ---
+
+*putty_paste_style* = _boolean_::
+If set to True, right-click will paste text, while middle-click will
+popup the context menu. The source for the pasted text depends on the
+value of *putty_paste_style_source_clipboard*. +
+Default value: *False*
+
+*putty_paste_style_source_clipboard* = _boolean_::
+If set to True, the Clipboard will be used as source for pasting in
+PuTTY style. Otherwise, the Primary Selection will be used. +
+This option is ignored unless *putty_paste_style* is set to True. +
+Default value: *False*
+
+*disable_mouse_paste* = _boolean_::
+If set to True, mouse pasting will be disabled. +
+Default value: *False*
+
+*smart_copy* = _boolean_::
+If set to True, and there is no selection, the shortcut is allowed to
+pass through. This is useful for overloading Ctrl-C to copy a selection,
+or send the SIGINT to the current process if there is no selection.
+If False, the shortcut does not pass through at all, and the SIGINT does
+not get sent. +
+Default value: *True*
+
+*clear_select_on_copy* = _boolean_::
+If set to True, text selection will be cleared after copying using the
+*copy* keybinding. +
+Default value: *False*
+
+// --- Terminal appearance ---
+
+*handle_size* = _integer_::
+Specify the width of the separator between terminals.
+Anything outside the range 0-20 (inclusive) will be ignored and the
+default theme value will be used instead. +
+Default value: *1*
+
+*inactive_color_offset* = _float_::
+Specify how much to reduce the color values of fonts in terminals that
+do not have focus. +
+Default value: *0.8*
+
+*inactive_bg_color_offset* = _float_::
+Specify how much to reduce the color values of the background in
+terminals that do not have focus. +
+Default value: *1.0*
+
+*cell_width* = _float_::
+Specify the horizontal scale of character cells in the terminal. +
+Default value: *1.0*
+
+*cell_height* = _float_::
+Specify the vertical scale of character cells in the terminal. +
+Default value: *1.0*
+
+*title_at_bottom* = _boolean_::
+If set to True, the terminal's titlebar will be drawn at the bottom
+instead of the top. +
+Default value: *False*
+
+=== Miscellaneous
+
+*dbus* = _boolean_::
+Specify whether Terminator will load its DBus server.
+When this server is loaded, running Terminator multiple times will cause
+the first Terminator process to open additional windows.
+If this configuration item is set to False, or the python dbus module is
+unavailable, running Terminator multiple times will run a separate
+Terminator process for each invocation. +
+Default value: *True*
+
+*extra_styling* = _boolean_::
+If set to True, Terminator may load an additional CSS styling file,
+depending on the theme. +
+Default value: *True*
+
+*broadcast_default* = _string_::
+Specify the default broadcast behavior.
+Can be any of: 'all', 'group', 'off'. +
+Default value: *group*
+
+*use_custom_url_handler* = _boolean_::
+If set to True, URL handling will be given over entirely to the program
+specified by 'custom_url_handler'. +
+Default value: *False*
+
+*custom_url_handler* = _string_::
+Specify the path to a program which accepts a URI as an argument and
+does something relevant with it.
+This option is ignored unless *use_custom_url_handler* is set to True.
+
+*case_sensitive* = _boolean_::
+If set to True, uppercase and lowercase characters will be considered
+different when searching text in the terminal. +
+Default value: *True*
+
+*invert_search* = _boolean_::
+If set to True, the search direction will be inverted (bottom to top)
+when searching text in the terminal. +
+Default value: *False*
+
+*enabled_plugins* = _list of strings_::
+Specify which plugins will be loaded by default. All other plugin
+classes will be ignored. +
+Default value: *['LaunchpadBugURLHandler', 'LaunchpadCodeURLHandler', 'APTURLHandler']*
+
+// ================================================================== \\
+
+== keybindings
+These are the options Terminator currently supports in the *keybindings*
+section.
+
+=== Creation & Destruction
+
+*split_horiz*::
+Split the current terminal horizontally. +
+Default value: *<Ctrl><Shift>O*
+
+*split_vert*::
+Split the current terminal vertically. +
+Default value: *<Ctrl><Shift>E*
+
+*split_auto*::
+Split the current terminal automatically, along the longer side. +
+Default value: *<Ctrl><Shift>A*
+
+*new_tab*::
+Open a new tab. +
+Default value: *<Ctrl><Shift>T*
+
+*new_window*::
+Open a new window as part of the existing process. +
+Default value: *<Ctrl><Shift>I*
+
+*new_terminator*::
+Spawn a new Terminator process. +
+Default value: *<Super>I*
+
+*layout_launcher*::
+Open the layout launcher. +
+Default value: *<Alt>L*
+
+*close_term*::
+Close the current terminal. +
+Default value: *<Ctrl><Shift>W*
+
+*close_window*::
+Close the current window. +
+Default value: *<Ctrl><Shift>Q*
+
+=== Navigation
+
+*cycle_next*::
+Focus the next terminal. This is an alias for *go_next*. +
+Default value: *<Ctrl>Tab*
+
+*cycle_prev*::
+Focus the previous terminal. This is an alias for *go_prev*. +
+Default value: *<Ctrl><Shift>Tab*
+
+*go_next*::
+Focus the next terminal. +
+Default value: *<Ctrl><Shift>N*
+
+*go_prev*::
+Focus the previous terminal. +
+Default value: *<Ctrl><Shift>P*
+
+*go_up*::
+Focus the terminal above the current one. +
+Default value: *<Alt>Up*
+
+*go_down*::
+Focus the terminal below the current one. +
+Default value: *<Alt>Down*
+
+*go_left*::
+Focus the terminal to the left of the current one. +
+Default value: *<Alt>Left*
+
+*go_right*::
+Focus the terminal to the right of the current one. +
+Default value: *<Alt>Right*
+
+// --- Scroll ---
+
+*page_up*::
+Scroll the terminal up one page.
+
+*page_down*::
+Scroll the terminal down one page.
+
+*page_up_half*::
+Scroll the terminal up half a page.
+
+*page_down_half*::
+Scroll the terminal down half a page.
+
+*line_up*::
+Scroll the terminal up one line.
+
+*line_down*::
+Scroll the terminal down one line.
+
+// --- Tab ---
+
+*next_tab*::
+Move to the next tab. +
+Default value: *<Ctrl>Page_Down*
+
+*prev_tab*::
+Move to the previous tab. +
+Default value: *<Ctrl>Page_Up*
+
+*switch_to_tab_1*, *switch_to_tab_2*, ... *switch_to_tab_10*::
+Move to the **N**th tab.
+Note that *<Alt><Shift>1* may be provided as *<Alt>!* or similar,
+depending on the keyboard layout.
+
+=== Organisation
+
+*resize_up*::
+Move the parent dragbar up. +
+Default value: *<Ctrl><Shift>Up*
+
+*resize_down*::
+Move the parent dragbar down. +
+Default value: *<Ctrl><Shift>Down*
+
+*resize_left*::
+Move the parent dragbar left. +
+Default value: *<Ctrl><Shift>Left*
+
+*resize_right*::
+Move the parent dragbar right. +
+Default value: *<Ctrl><Shift>Right*
+
+*rotate_cw*::
+Rotate terminals clockwise. +
+Default value: *<Super>R*
+
+*rotate_ccw*::
+Rotate terminals counter+clockwise. +
+Default value: *<Super><Shift>R*
+
+*move_tab_right*::
+Move the current tab to the right by swapping position with the next
+tab. +
+Default value: *<Ctrl><Shift>Page_Down*
+
+*move_tab_left*::
+Move the current tab to the left by swapping position with the previous
+tab. +
+Default value: *<Ctrl><Shift>Page_Up*
+
+=== Focus
+
+*full_screen*::
+Toggle window to fullscreen. +
+Default value: *F11*
+
+*toggle_zoom*::
+Toggle maximisation of the current terminal. +
+Default value: *<Ctrl><Shift>X*
+
+*scaled_zoom*::
+Toggle maximisation of the current terminal and scale the font when
+maximised. +
+Default value: *<Ctrl><Shift>Z*
+
+*hide_window*::
+Hide/Show all Terminator windows. +
+Default value: *<Ctrl><Shift><Alt>A*
+
+=== Grouping & Broadcasting
+
+*create_group*::
+Create a new group.
+
+// --- Grouping: All ---
+
+*group_all*::
+Group all terminals together. +
+Default value: *<Super>G*
+
+*ungroup_all*::
+Ungroup all terminals.
+
+*group_all_toggle*::
+Toggle grouping of all terminals.
+
+// --- Grouping: Window ---
+
+*group_win*::
+Group all terminals in the current window together.
+
+*ungroup_win*::
+Ungroup all terminals in the current window. +
+Default value: *<Super><Shift>W*
+
+*group_win_toggle*::
+Toggle grouping of all terminals in the current window.
+
+// --- Grouping: Tab ---
+
+*group_tab*::
+Group all terminals in the current tab together. +
+Default value: *<Super>T*
+
+*ungroup_tab*::
+Ungroup all terminals in the current tab. +
+Default value: *<Super><Shift>T*
+
+*group_tab_toggle*::
+Toggle grouping of all terminals in the current tab.
+
+// Broadcasting
+
+*broadcast_off*::
+Turn broadcasting off.
+
+*broadcast_group*::
+Broadcast to all terminals in the same group as the current terminal.
+
+*broadcast_all*::
+Broadcast to all terminals.
+
+=== Miscellaneous
+
+*help*::
+Open the full HTML manual in the browser. +
+Default value: *F1*
+
+*preferences*::
+Open the Preferences window.
+
+*preferences_keybindings*::
+Open the Preferences window and show the Keybindings tab. +
+Default value: *<Ctrl><Shift>K*
+
+*copy*::
+Copy the selected text to the Clipboard. +
+Default value: *<Ctrl><Shift>C*
+
+*paste*::
+Paste the current contents of the Clipboard. +
+Default value: *<Ctrl><Shift>V*
+
+*paste_selection*::
+Paste the current contents of the Primary Selection.
+
+*toggle_scrollbar*::
+Toggle the scrollbar. +
+Default value: *<Ctrl><Shift>S*
+
+*search*::
+Search for text in the terminal scrollback history. +
+Default value: *<Ctrl><Shift>F*
+
+*reset*::
+Reset the terminal state. +
+Default value: *<Ctrl><Shift>R*
+
+*reset_clear*::
+Reset the terminal state and clear the terminal window. +
+Default value: *<Ctrl><Shift>G*
+
+*zoom_in*::
+Increase the font size by one unit. +
+Default value: *<Ctrl>plus*
+
+*zoom_out*::
+Decrease the font size by one unit. +
+Default value: *<Ctrl>minus*
+
+*zoom_normal*::
+Restore the original font size. +
+Default value: *<Ctrl>0*
+
+*zoom_in_all*::
+Increase the font size by one unit for all terminals.
+
+*zoom_out_all*::
+Decrease the font size by one unit for all terminals.
+
+*zoom_normal_all*::
+Restore the original font size for all terminals.
+
+*edit_window_title*::
+Rename the current window. +
+Default value: *<Ctrl><Alt>W*
+
+*edit_tab_title*::
+Rename the current tab. +
+Default value: *<Ctrl><Alt>A*
+
+*edit_terminal_title*::
+Rename the current terminal. +
+Default value: *<Ctrl><Alt>X*
+
+*insert_number*::
+Insert the current terminal's number, i.e. 1 to 12. +
+Default value: *<Super>1*
+
+*insert_padded*::
+Insert the current terminal's number, but zero padded, i.e. 01 to 12. +
+Default value: *<Super>0*
+
+*next_profile*::
+Switch to the next profile.
+
+*previous_profile*::
+Switch to the previous profile.
+
+// ================================================================== \\
+
+== profiles
+These are the options Terminator currently supports in the *profiles*
+section. Each profile should be its own subsection with a header in the
+format *\[[name]]*.
+
+=== General
+
+*allow_bold* = _boolean_::
+If set to True, text in the terminal can displayed in bold. +
+Default value: *True*
+
+*copy_on_selection* = _boolean_::
+If set to True, text selections will be automatically copied to the
+Clipboard, in addition to being copied to the Primary Selection. +
+Default value: *False*
+
+*disable_mousewheel_zoom* = _boolean_::
+If set to True, Ctrl+mouse_wheel will not zoom or unzoom the terminal. +
+Default value: *False*
+
+*word_chars* = _string_::
+Specify the characters that will be considered part of a single word
+when selecting text by word.
+Hyphen and alphanumerics do not need to be specified.
+Ranges can be given, e.g. "A-Z". +
+For example, if *word_chars* = "," then "foo,bar" is considered a single
+word. +
+Default value: **-,./?%&#:_**
+
+*mouse_autohide* = _boolean_::
+If set to True, the mouse pointer will be hidden when typing. +
+Default value: *True*
+
+*term* = _string_::
+Specify the value Terminator will assign to the 'TERM' environment
+variable. +
+Default value: *xterm-256color*
+
+*colorterm* = _string_::
+Specify the value Terminator will assign to the 'COLORTERM' environment
+variable. +
+Default value: *truecolor*
+
+*split_to_group* = _boolean_::
+If set to True, the terminal created by splitting will be inserted in
+the current terminal's group. +
+Default value: *False*
+
+*autoclean_groups* = _boolean_::
+If set to True, empty groups will be removed. +
+Default value: *True*
+
+// --- Font ---
+
+*use_system_font* = _boolean_::
+If set to True, the system default font will be used for text in the
+terminal. Otherwise, the value of *font* will be used. +
+Default value: *True*
+
+*font* = _string_::
+Specify which font to use for text in the terminal.
+This option is ignored unless *use_system_font* is set to False. +
+Default value: *Mono 10*
+
+// --- Cursor ---
+
+*cursor_blink* = _boolean_::
+If set to True, the cursor will blink when not typing. +
+Default value: *True*
+
+*cursor_shape* = _string_::
+Specify the shape of the cursor.
+Can be any of: 'block', 'underline', 'ibeam'. +
+Default value: *block*
+
+*cursor_color_default* = _boolean_::
+If set to True, the background and foreground colors of the terminal
+will be used as foreground and background colors for the cursor,
+respectively. +
+Default value: *True*
+
+*cursor_fg_color* = _color string_::
+Specify the foreground color to use for the cursor.
+This option is ignored unless *cursor_color_default* is set to False.
+
+*cursor_bg_color* = _color string_::
+Specify the background color to use for the cursor.
+This option is ignored unless *cursor_color_default* is set to False.
+
+// --- Bell ---
+
+*audible_bell* = _boolean_::
+If set to True, a sound will be played when an application writes the
+escape sequence for the terminal bell. +
+Default value: *False*
+
+*visible_bell* = _boolean_::
+If set to True, the terminal will flash when an application writes the
+escape sequence for the terminal bell. +
+Default value: *False*
+
+*urgent_bell* = _boolean_::
+If set to True, the window's urgency hint will be set when an
+application writes the escape sequence for the terminal bell. +
+Default value: *False*
+
+*icon_bell* = _boolean_::
+If set to True, a small icon will be shown on the terminal titlebar when
+an application writes the escape sequence for the terminal bell. +
+Default value: *True*
+
+*force_no_bell* = _boolean_::
+If set to True, the terminal bell will be completely disabled. +
+Default value: *False*
+
+=== Command
+
+*login_shell* = _boolean_::
+If set to True, the terminal will run the default shell (or the command
+specified by *custom_command*) as a login shell.
+This means the first argument passed to the shell/command will be '-l'. +
+Default value: *False*
+
+*use_custom_command* = _boolean_::
+If set to True, the value of *custom_command* will be used instead of
+the default shell. +
+Default value: *False*
+
+*custom_command* = _string_::
+Specify the command to execute instead of the default shell.
+This option is ignored unless *use_custom_command* is set to True.
+
+*exit_action* = _string_::
+Specify the action to perform when the terminal is closed.
+'close' to remove the terminal.
+'restart' to restart the shell (or the command specified by
+*custom_command*).
+'hold' to keep the terminal open, even if the process in it has
+terminated. +
+Default value: *close*
+
+=== Colors
+
+*use_theme_colors* = _boolean_::
+If set to True, the theme's foreground and background colors will be
+used for the terminal. Otherwise, the values of *foreground_color* and
+*background_color* will be used. +
+Default value: *False*
+
+*foreground_color* = _color string_::
+Specify the foreground color to use for the terminal.
+This option is ignored unless *use_theme_colors* is set to False. +
+Default value: *#AAAAAA*
+
+*background_color* = _color string_::
+Specify the background color to use for the terminal.
+This option is ignored unless *use_theme_colors* is set to False. +
+Default value: *#000000*
+
+*palette* = _string list of colors_::
+Specify the 16-color palette to use for the terminal.
+The value must be a string containing a colon-separated list of colors
+in hex format. +
+For example, "#000000:#cd0000:#00cd00: ... ".
+
+*bold_is_bright* = _boolean_::
+If set to True, bold text will have brighter colors. +
+Default value: *False*
+
+=== Background
+
+*background_darkness* = _float_::
+Specify the transparency of the background color.
+The value must be between 0.0 and 1.0.
+This option is ignored unless *background_type* is set to 'transparent'
+or 'image'. +
+Default value: *0.5*
+
+*background_type* = _string_::
+Specify what type of background the terminal will have.
+'solid' for a solid (opaque) background.
+'transparent' for a transparent background.
+'image' for a background image. +
+If this is set to 'transparent', the transparency of the background will
+be the value of *background_darkness*.
+If this is set to 'image', the image specified by *background_image*
+will be the background; the background color will then be drawn on top
+of it, with a transparency specified by *background_darkness*. +
+Default value: *solid*
+
+*background_image* = _path string_::
+Specify the path to an image that will be used as background.
+This option is ignored unless *background_type* is set to 'image'.
+
+*background_image_mode* = _string_::
+Specify how the background image will be drawn.
+'stretch_and_fill' to fill the terminal entirely, without necessarily
+maintaining aspect ratio.
+'scale_and_fit' to fit the image inside the terminal, eventually leaving
+blank bars, while maintaining aspect ratio.
+'scale_and_crop' to fill the terminal entirely, eventually cropping the
+image, while maintaining aspect ratio.
+'tiling' to repeat the image as to fill the terminal.
+This option is ignored unless *background_type* is set to 'image'. +
+Default value: *stretch_and_fill*
+
+*background_image_align_horiz* = _string_::
+Specify the horizontal alignment of the background image.
+Can be any of: 'left', 'center', 'right'.
+This option is ignored unless *background_type* is set to 'image'. +
+Default value: *center*
+
+*background_image_align_vert* = _string_::
+Specify the vertical alignment of the background image.
+Can be any of: 'top', 'middle', 'bottom'.
+This option is ignored unless *background_type* is set to 'image'. +
+Default value: *middle*
+
+=== Scrolling
+
+*scrollbar_position* = _string_::
+Specify where the terminal scrollbar is put.
+Can be any of: 'left', 'right', 'hidden'. +
+Default value: *right*
+
+*scroll_on_output* = _boolean_::
+If set to True, the terminall will scroll to the bottom when an
+application writes text to it. +
+Default value: *False*
+
+*scroll_on_keystroke* = _boolean_::
+If set to True, the terminal will scroll to the bottom when typing. +
+Default value: *True*
+
+*scrollback_infinite* = _boolean_::
+If set to True, the terminal will keep the entire scrollback history. +
+Default value: *False*
+
+*scrollback_lines* = _integer_::
+Specify how many lines of scrollback history will be kept by the
+terminal. Lines that don't fit in the scrollback history will be
+discarted. Note that setting large values can slow down rewrapping and
+resizing.
+This option is ignored unless *scrollback_infinite* is set to False. +
+Default value: *500*
+
+=== Compatibility
+
+*backspace_binding* = _string_::
+Specify what code will be generated by the backspace key.
+The value can be:
+'ascii-del' for the ASCII DEL character;
+'control-h' for the ASCII BS character (Ctrl+H);
+'escape-sequence' for the escape sequence typically bound to backspace
+or delete;
+'automatic' for letting the terminal automatically decide the character
+sequence to use. +
+Default value: *ascii-del*
+
+*delete_binding* = _string_::
+Specify what code will be generated by the delete key.
+The value can be:
+'ascii-del' for the ASCII DEL character;
+'control-h' for the ASCII BS character (Ctrl+H);
+'escape-sequence' for the escape sequence typically bound to backspace
+or delete;
+'automatic' for letting the terminal automatically decide the character
+sequence to use. +
+Default value: *escape-sequence*
+
+=== Titlebar
+
+*show_titlebar* = _boolean_::
+If set to True, the terminal will have a titlebar showing the current
+title of that terminal. +
+Default value: *True*
+
+*title_hide_sizetext* = _boolean_::
+If set to True, the size of the terminal will not be written on its
+titlebar. +
+Default value: *False*
+
+*title_use_system_font* = _boolean_::
+If set to True, the system default font will be used for text in the
+terminal's titlebar. Otherwise, the value of *title_font* will be used. +
+Default value: *True*
+
+*title_font* = _string_::
+Specify which font to use for text in the terminal's titlebar.
+This option is ignored unless *title_use_system_font* is set to False. +
+Default value: *Sans 9*
+
+// --- Titlebar colors ---
+
+*title_transmit_fg_color* = _color string_::
+Specify the foreground color to use for the terminal's titlebar in case
+the terminal is focused. +
+Default value: *#ffffff*
+
+*title_transmit_bg_color* = _color string_::
+Specify the background color to use for the terminal's titlebar in case
+the terminal is focused. +
+Default value: *#c80003*
+
+*title_inactive_fg_color* = _color string_::
+Specify the foreground color to use for the terminal's titlebar in case
+the terminal is unfocused. +
+Default value: *#000000*
+
+*title_inactive_bg_color* = _color string_::
+Specify the background color to use for the terminal's titlebar in case
+the terminal is unfocused. +
+Default value: *#c0bebf*
+
+*title_receive_fg_color* = _color string_::
+Specify the foreground color to use for the terminal's titlebar in case
+the terminal is in a group and is receiving input while unfocused. +
+Default value: *#ffffff*
+
+*title_receive_bg_color* = _color string_::
+Specify the background color to use for the terminal's titlebar in case
+the terminal is in a group and is receiving input while unfocused. +
+Default value: *#0076c9*
+
+// ================================================================== \\
+
+== layouts
+The *layouts* section contains all the saved layouts. Each layout should
+be its own subsection with a header in the format *\[[name]]*.
+
+Each object in a layout is a named sub-sub-section with various
+properties.
+
+*type* = _string_::
+Can be any of: 'Window', 'Notebook', 'HPaned', 'VPaned', 'Terminal'.
+
+*parent* = _string_::
+Specify which object is the parent of the component being defined.
+All objects, except those of type Window, must specify a parent.
+
+This is an example of a *layouts* section containing only the layout
+named "default".
+
+----
+[layouts]
+  [[default]]
+    [[[window0]]]
+      type = Window
+      parent = ""
+    [[[child1]]]
+      type = Terminal
+      parent = window0
+----
+
+// ================================================================== \\
+
+== plugins
+Terminator plugins can add their own configuration to the config file,
+and it will appear as a subsection. Please refer to the documentation of
+individual plugins for more information.
+
+== SEE ALSO
+*terminator*(1), https://configobj.readthedocs.io/

po/POTFILES.in

@@ -12,7 +12,6 @@ terminatorlib/container.py
 terminatorlib/cwd.py
 terminatorlib/debugserver.py
 terminatorlib/editablelabel.py
-terminatorlib/encoding.py
 terminatorlib/factory.py
 terminatorlib/__init__.py
 terminatorlib/keybindings.py

remotinator

@@ -47,6 +47,8 @@ COMMANDS={
     'get_tab':              [True,  _('Get the UUID of a parent tab')],
     'get_tab_title':        [True,  _('Get the title of a parent tab')],
     'set_tab_title':        [True,  _('Set the title of a parent tab')],
+    'bg_img':               [True,  _('Set the background image')],
+    'bg_img_all':           [False, _('Set the background image for all terminals')],
     'switch_profile':       [True,  _('Switch current terminal profile')],
     'switch_profile_all':   [False, _('Switch profile of all currently running terminals')],
     }
@@ -75,10 +77,13 @@ if __name__ == '__main__':
                 help=_('Terminal UUID for when not in env var TERMINATOR_UUID'))
 
     parser.add_argument('-p', '--profile', dest='profile', type=str, default=argparse.SUPPRESS,
-                help=_('Terminal UUID for when not in env var TERMINATOR_UUID'))
+                help=_('Profile name to switch to'))
+
+    parser.add_argument('-f', '--file', dest='file', type=str, default=argparse.SUPPRESS,
+                help=_('File to pass to command'))
 
     parser.add_argument('-x', '--execute', dest='execute', type=str, default=argparse.SUPPRESS,
-                help=_('Terminal UUID for when not in env var TERMINATOR_UUID'))
+                help=_('Command to run in new terminal'))
 
     parser.add_argument('-t', '--tab-title', dest='tab-title', type=str, default="Missing Tab Title! Use -t argument!",
                 help=_('Tab name to set. Only used with "set_tab_title" command.'))