| 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 |