OLD | NEW |
| (Empty) |
1 .\"Generated by db2man.xsl. Don't modify this, modify the source. | |
2 .de Sh \" Subsection | |
3 .br | |
4 .if t .Sp | |
5 .ne 5 | |
6 .PP | |
7 \fB\\$1\fR | |
8 .PP | |
9 .. | |
10 .de Sp \" Vertical space (when we can't use .PP) | |
11 .if t .sp .5v | |
12 .if n .sp | |
13 .. | |
14 .de Ip \" List item | |
15 .br | |
16 .ie \\n(.$>=3 .ne \\$3 | |
17 .el .ne 3 | |
18 .IP "\\$1" \\$2 | |
19 .. | |
20 .TH "XDG-FILE-DIALOG" 1 "" "" "xdg-file-dialog Manual" | |
21 .SH NAME | |
22 xdg-file-dialog \- command line tool for providing file and directory selection
dialogs | |
23 .SH "SYNOPSIS" | |
24 .ad l | |
25 .hy 0 | |
26 .HP 16 | |
27 \fBxdg\-file\-dialog\fR openfilename [\fB\-\-title\ \fITITLE\fR\fR] [\fIFILENAME
\fR] | |
28 .ad | |
29 .hy | |
30 .ad l | |
31 .hy 0 | |
32 .HP 16 | |
33 \fBxdg\-file\-dialog\fR openfilenamelist [\fB\-\-title\ \fITITLE\fR\fR] [\fIFILE
NAME\fR] | |
34 .ad | |
35 .hy | |
36 .ad l | |
37 .hy 0 | |
38 .HP 16 | |
39 \fBxdg\-file\-dialog\fR savefilename [\fB\-\-title\ \fITITLE\fR\fR] [\fIFILENAME
\fR] | |
40 .ad | |
41 .hy | |
42 .ad l | |
43 .hy 0 | |
44 .HP 16 | |
45 \fBxdg\-file\-dialog\fR directory [\fB\-\-title\ \fITITLE\fR\fR] [\fIDIRNAME\fR] | |
46 .ad | |
47 .hy | |
48 .ad l | |
49 .hy 0 | |
50 .HP 16 | |
51 \fBxdg\-file\-dialog\fR {\fB\fB\-\-help\fR\fR | \fB\fB\-\-manual\fR\fR | \fB\fB\
-\-version\fR\fR} | |
52 .ad | |
53 .hy | |
54 | |
55 .SH "DESCRIPTION" | |
56 | |
57 .PP | |
58 The xdg\-file\-dialog program can be used to let the native file selection dialo
g handle file and directory input\&. | |
59 | |
60 .PP | |
61 xdg\-file\-dialog is for use inside a desktop session only\&. It is not recommen
ded to use xdg\-file\-dialog as root\&. | |
62 | |
63 .SH "COMMANDS" | |
64 | |
65 .TP | |
66 openfilename | |
67 Returns the filename with path for a file to read from\&. \fIFILENAME\fR can opt
ionally be used to specify path and filename of a preselection\&. | |
68 | |
69 .TP | |
70 openfilenamelist | |
71 Returns one or more filenames with path for files to read from, each on a new li
ne\&. \fIFILENAME\fR can optionally be used to specify path and filename of a pr
eselection\&. | |
72 | |
73 .TP | |
74 savefilename | |
75 Returns the filename with path for file to write to\&. \fIFILENAME\fR can option
ally be used to specify path and filename of a preselection\&. | |
76 | |
77 .TP | |
78 directory | |
79 Returns the path for an exsiting directory\&. \fIDIRNAME\fR can optionally be us
ed to specify a path of a preselection\&. | |
80 | |
81 .SH "OPTIONS" | |
82 | |
83 .TP | |
84 \fB\-\-title\fR \fITITLE\fR | |
85 Sets the dialog's title (caption) to the specified text\&. | |
86 | |
87 .TP | |
88 \fB\-\-help\fR | |
89 Show command synopsis\&. | |
90 | |
91 .TP | |
92 \fB\-\-manual\fR | |
93 Show this manualpage\&. | |
94 | |
95 .TP | |
96 \fB\-\-version\fR | |
97 Show the xdg\-utils version information\&. | |
98 | |
99 .SH "EXIT CODES" | |
100 | |
101 .PP | |
102 An exit code of 0 indicates success while a non\-zero exit code indicates failur
e\&. The following failure codes can be returned: | |
103 | |
104 .TP | |
105 \fB1\fR | |
106 Error in command line syntax\&. | |
107 | |
108 .TP | |
109 \fB2\fR | |
110 One of the files passed on the command line did not exist\&. | |
111 | |
112 .TP | |
113 \fB3\fR | |
114 A required tool could not be found\&. | |
115 | |
116 .TP | |
117 \fB4\fR | |
118 The action failed\&. | |
119 | |
120 .SH "EXAMPLES" | |
121 | |
122 .PP | |
123 | |
124 | |
125 .nf | |
126 | |
127 xdg\-file\-dialog savefilename /tmp/foobar\&.png | |
128 | |
129 .fi | |
130 Asks for a save file name starting in directory /tmp and suggesting foobar\&.pn
g as the filename | |
131 | |
132 .PP | |
133 | |
134 | |
135 .nf | |
136 | |
137 xdg\-file\-dialog directory \-\-title "Select a target folder" /tmp | |
138 | |
139 .fi | |
140 Asks for a directory name starting in directory /tmp using the text "Select a t
arget folder" as the dialog's title/caption\&. | |
141 | |
142 .SH AUTHOR | |
143 Kevin Krammer. | |
OLD | NEW |