summaryrefslogtreecommitdiff
path: root/scripts/man/xdg-terminal.1
blob: 595158d661cfb5ea68fddd86643deddcf9273952 (plain)
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
.\" ** You probably do not want to edit this file directly **
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
.TH "XDG\-TERMINAL" "1" "12/07/2006" "xdg\-utils 1.0" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
xdg\-terminal \- opens the user's preferred terminal emulator application
.SH "SYNOPSIS"
.HP 13
\fBxdg\-terminal\fR [\fB\fIcommand\fR\fR]
.HP 13
\fBxdg\-terminal\fR {\fB\-\-help\fR \fB\-\-manual\fR \fB\-\-version\fR}
.SH "DESCRIPTION"
.PP
xdg\-terminal opens the user's preferred terminal emulator application. If a command is provided the command will be executed by the shell within the newly opened terminal window.
.PP
xdg\-terminal is for use inside a desktop session only. It is not recommended to use xdg\-terminal as root.
.SH "OPTIONS"
.TP
\fB\-\-help\fR
Show command synopsis.
.TP
\fB\-\-manual\fR
Show this manualpage.
.TP
\fB\-\-version\fR
Show the xdg\-utils version information.
.SH "EXIT CODES"
.PP
An exit code of 0 indicates success while a non\-zero exit code indicates failure. The following failure codes can be returned:
.TP
\fB1\fR
Error in command line syntax.
.TP
\fB3\fR
A required tool could not be found.
.TP
\fB4\fR
The action failed.
.SH "EXAMPLES"
.PP
.nf
xdg\-terminal
.fi
.sp
Opens the user's default terminal emulator, just starting an interactive shell.
.PP
.nf
xdg\-terminal top
.fi
.sp
Opens the user's default terminal emulator and lets it run the top executable.
.SH "AUTHOR"
Kevin Krammer. 
.br
<kevin.krammer@gmx.at>