OLD | NEW |
| (Empty) |
1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859
-1"><title>xdg-file-dialog</title><meta name="generator" content="DocBook XSL St
ylesheets V1.68.1"></head><body bgcolor="white" text="black" link="#0000FF" vlin
k="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="xdg-file-di
alog"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>x
dg-file-dialog — command line tool for providing file and directory select
ion dialogs</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cm
dsynopsis"><p><code class="command">xdg-file-dialog</code> openfilename [<cod
e class="option">--title <em class="replaceable"><code>TITLE</code></em></code>]
[<em class="replaceable"><code>FILENAME</code></em>]</p></div><div class="cmdsy
nopsis"><p><code class="command">xdg-file-dialog</code> openfilenamelist [<co
de class="option">--title <em class="replaceable"><code>TITLE</code></em></code>
] [<em class="replaceable"><code>FILENAME</code></em>]</p></div><div class="cmds
ynopsis"><p><code class="command">xdg-file-dialog</code> savefilename [<code
class="option">--title <em class="replaceable"><code>TITLE</code></em></code>] [
<em class="replaceable"><code>FILENAME</code></em>]</p></div><div class="cmdsyno
psis"><p><code class="command">xdg-file-dialog</code> directory [<code class=
"option">--title <em class="replaceable"><code>TITLE</code></em></code>] [<em cl
ass="replaceable"><code>DIRNAME</code></em>]</p></div><div class="cmdsynopsis"><
p><code class="command">xdg-file-dialog</code> { <code class="option">--help</c
ode> | <code class="option">--manual</code> | <code class="option">--versi
on</code> }</p></div></div><div class="refsect1" lang="en"><a name="description"
></a><h2>Description</h2><p> | |
2 The xdg-file-dialog program can be used to let the native file selection d
ialog | |
3 handle file and directory input. | |
4 </p><p> | |
5 xdg-file-dialog is for use inside a desktop session only. | |
6 It is not recommended to use xdg-file-dialog as root. | |
7 </p></div><div class="refsect1" lang="en"><a name="commands"></a><h2>Command
s</h2><div class="variablelist"><dl><dt><span class="term">openfilename</span></
dt><dd> | |
8 Returns the filename with path for a file to read from. | |
9 <em class="replaceable"><code>FILENAME</code></em> can optionally
be used to | |
10 specify path and filename of a preselection. | |
11 </dd><dt><span class="term">openfilenamelist</span></dt><dd> | |
12 Returns one or more filenames with path for files to read from, | |
13 each on a new line. <em class="replaceable"><code>FILENAME</code></e
m> can optionally | |
14 be used to specify path and filename of a preselection. | |
15 </dd><dt><span class="term">savefilename</span></dt><dd> | |
16 Returns the filename with path for file to write to. | |
17 <em class="replaceable"><code>FILENAME</code></em> can optionally be
used to | |
18 specify path and filename of a preselection. | |
19 </dd><dt><span class="term">directory</span></dt><dd> | |
20 Returns the path for an exsiting directory. | |
21 <em class="replaceable"><code>DIRNAME</code></em> can optionally be
used to | |
22 specify a path of a preselection. | |
23 </dd></dl></div></div><div class="refsect1" lang="en"><a name="optio
ns"></a><h2>Options</h2><div class="variablelist"><dl><dt><span class="term"><co
de class="option">--title</code> <em class="replaceable"><code>TITLE</code></em>
</span></dt><dd> | |
24 Sets the dialog's title (caption) to the specified text. | |
25 </dd><dt><span class="term"><code class="option">--help</code></span><
/dt><dd> | |
26 Show command synopsis. | |
27 </dd><dt><span class="term"><code class="option">--manual</code></span
></dt><dd> | |
28 Show this manualpage. | |
29 </dd><dt><span class="term"><code class="option">--version</code></spa
n></dt><dd> | |
30 Show the xdg-utils version information. | |
31 </dd></dl></div></div><div class="refsect1" lang="en"><a name="exitcod
es"></a><h2>Exit Codes</h2><p> | |
32 An exit code of 0 indicates success while a non-zero exit code | |
33 indicates failure. The following failure codes can be returned: | |
34 </p><div class="variablelist"><dl><dt><span class="term"><code class="option
">1</code></span></dt><dd> | |
35 Error in command line syntax. | |
36 </dd><dt><span class="term"><code class="option">2</code></span></dt><
dd> | |
37 One of the files passed on the command line did not exist. | |
38 </dd><dt><span class="term"><code class="option">3</code></span></dt><
dd> | |
39 A required tool could not be found. | |
40 </dd><dt><span class="term"><code class="option">4</code></span></dt><
dd> | |
41 The action failed. | |
42 </dd></dl></div></div><div class="refsect1" lang="en"><a name="example
s"></a><h2>Examples</h2><p> | |
43 </p><pre class="programlisting"> | |
44 xdg-file-dialog savefilename /tmp/foobar.png | |
45 </pre><p> | |
46 Asks for a save file name starting in directory /tmp and suggesting foobar
.png as the filename | |
47 </p><p> | |
48 </p><pre class="programlisting"> | |
49 xdg-file-dialog directory --title "Select a target folder" /tmp | |
50 </pre><p> | |
51 Asks for a directory name starting in directory /tmp using the text "Selec
t a target folder" as the dialog's title/caption. | |
52 </p></div></div></body></html> | |
OLD | NEW |