forked from AgoraDesktop/apps-terminal
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathTerminal.1
164 lines (164 loc) · 6.97 KB
/
Terminal.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
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
.TH TERMINAL 1 "December 17, 2004"
.SH NAME
Terminal \- GNUstep Terminal Emulator
.SH SYNOPSIS
.B openapp Terminal [program [arguments ...]]
.SH DESCRIPTION
This manual page documents briefly the
.B Terminal
GNUstep application.
This manual page was written for the Debian distribution
because the original program does not have a manual page.
.PP
\fBTerminal\fP provides terminal emulation in a GNUstep environment.
It gives colorized terminals with configurable fonts, and also allows
users to configure shell utilities as GNUstep services.
.SS Fonts
You can change the fonts used for normal and bold text in the preferences
panel. Terminal will get the metrics for the character cells from the
normal font, so this font really should be a fixed pitch font or things
will look messed up. The bold font should closely match the normal
font.
.PP
Terminal assumes that all characters, bold and normal, stay inside
the normal font's bounding box. If they don't, there will be visual
glitches. However, it is more common that a non-fixed pitch font's
bounding box is very large (since it needs to enclose \fIall\fP
characters in the font), so that the terminal window will be very
wide.
.SS Keys
By default, the command key is used to access key equivalents for menu
entries, and thus can't be used as a meta key in the terminal. If you
have command mapped to the key you want to use as meta, you can enable
`Treat the command key as meta' in the preferences panel. However, this
will disable all key equivalents in Terminal. The `proper' solution
to this problem is to remap the command key (and possibly alternate key).
The alternate key will always be treated as meta.
.PP
Often, the escape key can be used to emulate a meta key. This means that
in some programs, you might have to press escape twice to get a `real'
escape, or there will be a delay before it is handled. The `Send a double
escape...' option causes Terminal to send a double escape when you hit
the escape key (ie. "\\e\\e"), which should work better (but you can no
longer use the escape key as meta).
.SS Terminal services
Terminal can provide services for other applications by piping the
selection through arbitrary commands. Services are configured in one
of the preferences panel's tabs. The first time you open this tab, a
default set of services will be loaded. To save these where
make_services will actually find them, press `Apply and save'. This
will also run make_services to update the services list, but it may
take up to 30 seconds for running applications to notice the change.
.PP
The `Add' and `Remove' buttons add and remove services. Using the
`Export' button it is possible to save a set of services to a file.
These files can be imported using the `Import' button, so it is
possible for users to share terminal services definitions. The
extension of the file should be `.svcs'. The default set of services
is such a file located in the application wrapper's resource
directory. If you import a service with the same name as an existing
service, and they aren't identical, the new one will be renamed to
avoid a conflict.
.TP 8
.SS Name
This is the name of the service as it appears in the services menu.
By default, terminal services will be placed in a `Terminal' submenu
of the Services menu, but you can override this by giving the name a
leading `/'. In this case, you can also use a second `/' to create
your own submenus. (gnustep-gui doesn't support submenus of submenus,
though.) Names must be unique.
.TP 8
.SS Key
The key equivalent for this command, if any. Note that if an
application uses this key for some other menu entry, the key will
activate that menu entry, not the service.
.TP 8
.SS Command line
The command line. It is passed to /bin/sh, so any shell commands will
work, and arguments may have to be quoted. A `%p' in the command line
will cause a prompt to be brought up when the service is run. If
input is to be placed on the command line, you can mark the place to
put it at with `%s' (otherwise it will be appended to the command
line). You can use `%%' to get a real `%'.
.TP 8
.SS Run in background/new window/idle window
If a service is set to run in the background, the command will have to
complete before the service will return, and the service can return
output. Otherwise, the command's output will appear in a window.
``new window'' causes a completely new window to be opened (and it will
close automatically when the command is completed if that option is
set).
``idle window'' causes Terminal to try to reuse an existing idle
window. If there is no such window it will open a new window (and that
window won't close automatically).
.TP 8
.SS Ignore/return output (only applies to background services)
If set to ignore, the output of the command will be discarded.
Otherwise, it will be parsed to a string or a bunch of filenames,
depending on the acceptable types. The output is assumed to be utf8
encoded.
.TP 8
.SS No input/Input in stdin/Input on command line
If set to `No input', the service won't accept any input. Otherwise
it is necessary to select something to run it, and the selection will
be either piped to the command (`in stdin') or placed on the service's
command line (either at the `%s' or at the end, see above). Input will
be sent to the command utf8 encoded.
.TP 8
.SS Accept types
Plain text will be sent verbatim to the command. A list of filenames
(possibly just one) will be sent separated by ' ':s (if on the command
line), or newlines (if in stdin).
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
.SH OPTIONS
Commands can be given on the command line which will be run in the
newly opened shell window.
.SH EMULATION
The terminal emulation code is based on Linux's console code, and nearly
all parts of it are handled. Thus, the TERM environment variable is set
to `linux'. Additionally, `vt100', `vt220', `xterm', and others similar
to these should mostly work. To distinguish Terminal from a `real'
linux console, the environment variable \fBTERM_PROGRAM\fP is set to
GNUstep_Terminal.
.PP
The xterm extensions for setting the window's title are also supported.
You set the title using:
.TP 0
\&'\033]'+0, 1, or 2+';'+the title+'\007'
1 sets the miniwindow title, 2 sets the window title, and 0 sets both.
.PP
Example (from Jeff Teunissen):
.PP
export PROMPT_COMMAND='echo\ \-ne\ "\\033]2;Terminal\ \-\ ${HOSTNAME}:${PWD}\\007"'
.SH ENVIRONMENT
.B Terminal
sets the following environment variables:
.TP 5
.B TERM
Will be set to \fBlinux\fP.
.
.TP 5
.B TERM_PROGRAM
Will be set to \fBGNUstep_Terminal\fP.
.
.SH LANGUAGES
\fBTerminal\fP speaks English, French, German, Hungarian, Norwegian,
Russian, Spanish, Italian, Swedish and Turkish.
.SH NOTES
The content of this manual page is taken from the packages README
file and was converted into a manual page for Debian.
.SH SEE ALSO
.BR http://gap.nongnu.org/terminal/
.br
.BR http://www.gnustep.org/
.br
.BR GNUstep (7)
.br
.BR openapp (1)
.br
.BR open (1)
.br
.BR make_services (1)