gterm.1


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

.TH GTERM 1 "(c) 2019 Gerd Hoffmann" "GTERM" "terminal application"
\#
\#
.SH NAME
gterm - terminal application
\#
\#
.SH SYNOPSIS
.TP
\fBgterm\fP [\fIoptions\fP]
\#
\#
.SH DESCRIPTION
.BR gterm
is a terminal application.  Command line options are compatible with
xterm, not all xterm options are actually implemented though.
\#
\#
.SH OPTIONS
.TP
.B -e
Command line to run within the terminal.  All arguments following this
one are passed to the command started and will not be parsed, so this
should be last on your command line.  If not specified a shell is
started.
.TP
.BI -fa " face"
The font face to use.
.br
Config file key: faceName.
.TP
.BI -fs " size"
The font size to use.
.br
Config file key: faceSize.
.br
Only in the config file: faceSize1 .. faceSize6, they will be added as
alternative font sizes to the popup menu.
.TP
.BI -geometry " WxH"
The width and height of the terminal window (in columns/rows, not pixels).
.br
Config file key: geometry.
.TP
.BI -title " text"
Set the window title.
.br
Config file key: title.
.TP
.BI -T " text"
Shortcut for -title.
.TP
.B -bc
Enable cursor blinking.
.br
Config file key: cursorBlink.
.TP
.B +bc
Disable cursor blinking.
.TP
.BI -cr " color"
Set the cursor color
.br
Config file key: cursorColor.
.TP
.BI -fg " color"
Set the foreground color
.br
Config file key: foreground.
.TP
.BI -fg " color"
Set the background color
.br
Config file key: background.
.TP
.BI -name " profile"
Set profile.  gterm will read settings from a [profile] section in the
config file (if present).  This mimics xterm's behavior of changing
application name / application class when reading resources, so you
could have different config sets in ~/.Xdefaults which are selected
that way.
.TP
.BI -class " profile"
Alias for -name.
.TP
.B -vb
Disable audible bell (xterm enables visual bell instead, but vte
widget doesn't support that).
.br
Config file key: visualBell.
.TP
.B +vb
Enable audible bell.
.TP
.BI -sl " lines"
Set the number of scrollback lines
.br
Config file key: saveLines.
\#
\#
.SH "CONFIG FILE"
.BR gterm
reads the configuration from the 
.BR ~/.config/gterm.conf
config file.
A "[default]" section holds the config options.
Example:
.P
.in +4n
[default]
.br
faceName=Terminus
.br
faceSize=12
.in
.P
This has the same effect this ~/.Xdefaults snippet has for xterm:
.P
.in +4n
XTerm.vt100*faceName: Terminus
.br
XTerm.vt100*faceSize: 12
.in
.P
\#
\#
.SH "SEE ALSO"
.BR xterm(1)
\#
\#
.SH AUTHOR
Gerd Hoffmann
.BR <gerd@kraxel.org>