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 |