blob: 50d759b172e0721d3e09d10110f561e784a951bd (
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
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
|
.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "XDG-FILE-DIALOG" 1 "" "" "xdg-file-dialog Manual"
.SH NAME
xdg-file-dialog \- command line tool for providing file and directory selection dialogs
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 16
\fBxdg\-file\-dialog\fR openfilename [\fB\-\-title\ \fITITLE\fR\fR] [\fIFILENAME\fR]
.ad
.hy
.ad l
.hy 0
.HP 16
\fBxdg\-file\-dialog\fR openfilenamelist [\fB\-\-title\ \fITITLE\fR\fR] [\fIFILENAME\fR]
.ad
.hy
.ad l
.hy 0
.HP 16
\fBxdg\-file\-dialog\fR savefilename [\fB\-\-title\ \fITITLE\fR\fR] [\fIFILENAME\fR]
.ad
.hy
.ad l
.hy 0
.HP 16
\fBxdg\-file\-dialog\fR directory [\fB\-\-title\ \fITITLE\fR\fR] [\fIDIRNAME\fR]
.ad
.hy
.ad l
.hy 0
.HP 16
\fBxdg\-file\-dialog\fR {\fB\fB\-\-help\fR\fR | \fB\fB\-\-manual\fR\fR | \fB\fB\-\-version\fR\fR}
.ad
.hy
.SH "DESCRIPTION"
.PP
The xdg\-file\-dialog program can be used to let the native file selection dialog handle file and directory input\&.
.PP
xdg\-file\-dialog is for use inside a desktop session only\&. It is not recommended to use xdg\-file\-dialog as root\&.
.SH "COMMANDS"
.TP
openfilename
Returns the filename with path for a file to read from\&. \fIFILENAME\fR can optionally be used to specify path and filename of a preselection\&.
.TP
openfilenamelist
Returns one or more filenames with path for files to read from, each on a new line\&. \fIFILENAME\fR can optionally be used to specify path and filename of a preselection\&.
.TP
savefilename
Returns the filename with path for file to write to\&. \fIFILENAME\fR can optionally be used to specify path and filename of a preselection\&.
.TP
directory
Returns the path for an exsiting directory\&. \fIDIRNAME\fR can optionally be used to specify a path of a preselection\&.
.SH "OPTIONS"
.TP
\fB\-\-title\fR \fITITLE\fR
Sets the dialog's title (caption) to the specified text\&.
.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
\fB2\fR
One of the files passed on the command line did not exist\&.
.TP
\fB3\fR
A required tool could not be found\&.
.TP
\fB4\fR
The action failed\&.
.SH "EXAMPLES"
.PP
.nf
xdg\-file\-dialog savefilename /tmp/foobar\&.png
.fi
Asks for a save file name starting in directory /tmp and suggesting foobar\&.png as the filename
.PP
.nf
xdg\-file\-dialog directory \-\-title "Select a target folder" /tmp
.fi
Asks for a directory name starting in directory /tmp using the text "Select a target folder" as the dialog's title/caption\&.
.SH AUTHOR
Kevin Krammer.
|
