Update the configuration manpage to mention the full GUI, and also clarify the need for quoting of hex colour values
This commit is contained in:
Chris Jones
parent
4fd06ba8b3
commit
bc3fb61649
|
|
@ -4,7 +4,7 @@
|
|||
.SH "DESCRIPTION"
|
||||
This manual page documents briefly the
|
||||
.B Terminator
|
||||
config file.
|
||||
config file. Terminator manages its configuration file via the ConfigObj library to combine flexibility with clear, human editable files. As of version 0.90, 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.
|
||||
.PP
|
||||
.SH "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)
|
||||
|
|
@ -21,9 +21,9 @@ This is what a Terminator config file should look like:
|
|||
[profiles]
|
||||
[[default]]
|
||||
font = Fixed 10
|
||||
background_color = #000000
|
||||
foreground_color = "#FFFFFF" #Another comment. Quotes can be used for any value
|
||||
scrollback_lines = "500" #More comment. Single quotes are valid too
|
||||
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.
|
||||
|
||||
|
|
@ -78,27 +78,27 @@ Default value: \fBFalse\fR on Linux, \fBTrue\fR otherwise.
|
|||
.TP
|
||||
.B title_transmit_fg_color
|
||||
Sets the colour of the text shown in the titlebar of the active terminal.
|
||||
Default value: \fB#FFFFFF\fR
|
||||
Default value: \fB'#FFFFFF'\fR
|
||||
.TP
|
||||
.B title_transmit_bg_color
|
||||
Sets the colour of the background of the titlebar in the active terminal.
|
||||
Default value: \fB#C80003\fR
|
||||
Default value: \fB'#C80003'\fR
|
||||
.TP
|
||||
.B title_receive_fg_color
|
||||
Sets the colour of the text shown in the titlebar of any terminal that \fBwill\fR receive input from the active terminal.
|
||||
Default value: \fB#FFFFFF\fR
|
||||
Default value: \fB'#FFFFFF'\fR
|
||||
.TP
|
||||
.B title_receive_bg_color
|
||||
Sets the colour of the background of the titlebar of any terminal that \fBwill\fR receive input from the active terminal.
|
||||
Default value: \fB#0076C9\fR
|
||||
Default value: \fB'#0076C9'\fR
|
||||
.TP
|
||||
.B title_inactive_fg_color
|
||||
Sets the colour of the text shown in the titlebar of any terminal that will \fBnot\fR receive input from the active terminal.
|
||||
Default value: \fB#000000\fR
|
||||
Default value: \fB'#000000'\fR
|
||||
.TP
|
||||
.B title_inactive_bg_color
|
||||
Sets the colour of the background of the titlebar of any terminal that will \fBnot\fR receive input from the active terminal.
|
||||
Default value: \fB#C0BEBF\fR
|
||||
Default value: \fB'#C0BEBF'\fR
|
||||
.TP
|
||||
.B disabled_plugins
|
||||
A list of plugins which should not be loaded by default.
|
||||
|
|
@ -306,7 +306,7 @@ Default value: \fBFalse\fR
|
|||
.TP
|
||||
.B background_color
|
||||
Default colour of terminal background, as a colour specification (can be HTML-style hex digits, or a colour name such as "red"). \fBNote:\fR You may need to set \fBuse_theme_colors=False\fR to force this setting to take effect.
|
||||
Default value: \fB#000000\fR
|
||||
Default value: \fB'#000000'\fR
|
||||
.TP
|
||||
.B background_darkness
|
||||
A value between 0.0 and 1.0 indicating how much to darken the background image. 0.0 means no darkness, 1.0 means fully dark. If the terminal is set to transparent, this setting controls how transparent it is. 0.0 means fully transparent, 1.0 means fully opaque.
|
||||
|
|
@ -358,7 +358,7 @@ Default value: \fBMono 8\fR
|
|||
.TP
|
||||
.B foreground_color
|
||||
Default colour of text in the terminal, as a colour specification (can be HTML-style hex digits, or a colour name such as "red"). \fBNote:\fR You may need to set \fBuse_theme_colors=False\fR to force this setting to take effect.
|
||||
Default value: \fB#AAAAAA\fR
|
||||
Default value: \fB'#AAAAAA'\fR
|
||||
.TP
|
||||
.B scrollbar_position
|
||||
Where to put the terminal scrollbar. Possibilities are "left", "right", and "disabled".
|
||||
|
|
@ -403,11 +403,11 @@ Default value: \fBclose\fR
|
|||
.TP
|
||||
.B palette
|
||||
Terminals have a 16-colour palette that applications inside the terminal can use. This is that palette, in the form of a colon-separated list of colour names. Colour names should be in hex format e.g. "#FF00FF".
|
||||
Default value: \fB#000000000000:#CDCD00000000:#0000CDCD0000:#CDCDCDCD0000:#30BF30BFA38E:#A53C212FA53C:#0000CDCDCDCD:#FAFAEBEBD7D7:#404040404040:#FFFF00000000:#0000FFFF0000:#FFFFFFFF0000:#00000000FFFF:#FFFF0000FFFF:#0000FFFFFFFF:#FFFFFFFFFFFF\fR
|
||||
Default value: \fB'#000000000000:#CDCD00000000:#0000CDCD0000:#CDCDCDCD0000:#30BF30BFA38E:#A53C212FA53C:#0000CDCDCDCD:#FAFAEBEBD7D7:#404040404040:#FFFF00000000:#0000FFFF0000:#FFFFFFFF0000:#00000000FFFF:#FFFF0000FFFF:#0000FFFFFFFF:#FFFFFFFFFFFF'\fR
|
||||
.TP
|
||||
.B word_chars
|
||||
When selecting text by word, sequences of these characters are considered single words. Ranges can be given as "A-Z". Literal hyphen (not expressing a range) should be the first character given.
|
||||
Default value: \fB\-A\-Za\-z0\-9,./?%&#:_\fR
|
||||
Default value: \fB'\-A\-Za\-z0\-9,./?%&#:_'\fR
|
||||
.TP
|
||||
.B mouse_autohide \fR(boolean)
|
||||
Controls whether the mouse cursor should be hidden while typing.
|
||||
|
|
@ -455,4 +455,4 @@ Window objects may not have a parent attribute. \fBEvery\fR other object must sp
|
|||
Terminator plugins can add their own configuration to the config file, and will appear as a sub-section. Please refer to the documentation of individual plugins for more information.
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR gnome\-terminal(1)
|
||||
.BR gnome\-terminal(1), http://www.voidspace.org.uk/python/configobj.html
|
||||
|
|
|
|||
Loading…
Reference in New Issue