From bc3fb616494bd78ddf9e555c962b2a18f08f1d4f Mon Sep 17 00:00:00 2001 From: Chris Jones Date: Fri, 2 Apr 2010 12:47:17 +0100 Subject: [PATCH] Update the configuration manpage to mention the full GUI, and also clarify the need for quoting of hex colour values --- doc/terminator_config.5 | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/doc/terminator_config.5 b/doc/terminator_config.5 index dcf8d903..1275d0a7 100644 --- a/doc/terminator_config.5 +++ b/doc/terminator_config.5 @@ -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