OLD | NEW |
1 '\" t | 1 '\" t |
2 .\" Title: xdg-settings | 2 .\" Title: xdg-settings |
3 .\" Author: Mike Mammarella | 3 .\" Author: Mike Mammarella |
4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> | 4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> |
5 .\" Date: 12/31/2010 | 5 .\" Date: 07/20/2011 |
6 .\" Manual: xdg-settings Manual | 6 .\" Manual: xdg-settings Manual |
7 .\" Source: [FIXME: source] | 7 .\" Source: [FIXME: source] |
8 .\" Language: English | 8 .\" Language: English |
9 .\" | 9 .\" |
10 .TH "XDG\-SETTINGS" "1" "12/31/2010" "[FIXME: source]" "xdg-settings Manual" | 10 .TH "XDG\-SETTINGS" "1" "07/20/2011" "[FIXME: source]" "xdg-settings Manual" |
11 .\" ----------------------------------------------------------------- | 11 .\" ----------------------------------------------------------------- |
12 .\" * Define some portability stuff | 12 .\" * Define some portability stuff |
13 .\" ----------------------------------------------------------------- | 13 .\" ----------------------------------------------------------------- |
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
15 .\" http://bugs.debian.org/507673 | 15 .\" http://bugs.debian.org/507673 |
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html | 16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
18 .ie \n(.g .ds Aq \(aq | 18 .ie \n(.g .ds Aq \(aq |
19 .el .ds Aq ' | 19 .el .ds Aq ' |
20 .\" ----------------------------------------------------------------- | 20 .\" ----------------------------------------------------------------- |
21 .\" * set default formatting | 21 .\" * set default formatting |
22 .\" ----------------------------------------------------------------- | 22 .\" ----------------------------------------------------------------- |
23 .\" disable hyphenation | 23 .\" disable hyphenation |
24 .nh | 24 .nh |
25 .\" disable justification (adjust text to left margin only) | 25 .\" disable justification (adjust text to left margin only) |
26 .ad l | 26 .ad l |
27 .\" ----------------------------------------------------------------- | 27 .\" ----------------------------------------------------------------- |
28 .\" * MAIN CONTENT STARTS HERE * | 28 .\" * MAIN CONTENT STARTS HERE * |
29 .\" ----------------------------------------------------------------- | 29 .\" ----------------------------------------------------------------- |
30 .SH "NAME" | 30 .SH "NAME" |
31 xdg-settings \- get various settings from the desktop environment | 31 xdg-settings \- get various settings from the desktop environment |
32 .SH "SYNOPSIS" | 32 .SH "SYNOPSIS" |
33 .HP \w'\fBxdg\-settings\fR\ 'u | 33 .HP \w'\fBxdg\-settings\fR\ 'u |
34 \fBxdg\-settings\fR {\fB\fIget\fR\fR | \fB\fIcheck\fR\fR | \fB\fIset\fR\fR} {\fB
property\fR} [\fBvalue\fR] | 34 \fBxdg\-settings\fR {\fB\fIget\fR\fR | \fB\fIcheck\fR\fR | \fB\fIset\fR\fR} {\fB
property\fR} [\fBsubproperty\fR] [\fBvalue\fR] |
35 .HP \w'\fBxdg\-settings\fR\ 'u | 35 .HP \w'\fBxdg\-settings\fR\ 'u |
36 \fBxdg\-settings\fR {\fB\-\-help\fR | \fB\-\-list\fR | \fB\-\-manual\fR | \fB\-\
-version\fR} | 36 \fBxdg\-settings\fR {\fB\-\-help\fR | \fB\-\-list\fR | \fB\-\-manual\fR | \fB\-\
-version\fR} |
37 .SH "DESCRIPTION" | 37 .SH "DESCRIPTION" |
38 .PP | 38 .PP |
39 xdg\-settings gets various settings from the desktop environment\&. For instance
, desktop environments often provide proxy configuration and default web browser
settings\&. Using xdg\-settings these parameters can be extracted for use by ap
plications that do not use the desktop environment\*(Aqs libraries (which would
use the settings natively)\&. | 39 xdg\-settings gets various settings from the desktop environment\&. For instance
, desktop environments often provide proxy configuration and default web browser
settings\&. Using xdg\-settings these parameters can be extracted for use by ap
plications that do not use the desktop environment\*(Aqs libraries (which would
use the settings natively)\&. |
40 .PP | 40 .PP |
41 xdg\-settings is for use inside a desktop session only\&. It is not recommended
to use xdg\-settings as root\&. | 41 xdg\-settings is for use inside a desktop session only\&. It is not recommended
to use xdg\-settings as root\&. |
42 .SH "OPTIONS" | 42 .SH "OPTIONS" |
43 .PP | 43 .PP |
44 \fB\-\-help\fR | 44 \fB\-\-help\fR |
45 .RS 4 | 45 .RS 4 |
46 Show command synopsis\&. | 46 Show command synopsis\&. |
47 .RE | 47 .RE |
48 .PP | 48 .PP |
49 \fB\-\-list\fR | 49 \fB\-\-list\fR |
50 .RS 4 | 50 .RS 4 |
51 List all properties xdg\-settings knows about\&. | 51 List all properties xdg\-settings knows about\&. |
52 .RE | 52 .RE |
53 .PP | 53 .PP |
54 \fB\-\-manual\fR | 54 \fB\-\-manual\fR |
55 .RS 4 | 55 .RS 4 |
56 Show this manualpage\&. | 56 Show this manualpage\&. |
57 .RE | 57 .RE |
58 .PP | 58 .PP |
59 \fB\-\-version\fR | 59 \fB\-\-version\fR |
60 .RS 4 | 60 .RS 4 |
61 Show the xdg\-utils version information\&. | 61 Show the xdg\-utils version information\&. |
62 .RE | 62 .RE |
| 63 .SH "PROPERTIES" |
| 64 .PP |
| 65 When using xdg\-settings to get, check or set a destkop setting, properties and
possibly sub\-properties are used to specify the setting to be changed\&. |
| 66 .PP |
| 67 Some properties (such as default\-web\-browser) fully describe the setting to be
changed\&. Other properties (such as default\-url\-scheme\-handler) require mor
e information (in this case the actual scheme to set the default handler for) wh
ich must be provided in a sub\-property\&. |
63 .SH "EXIT CODES" | 68 .SH "EXIT CODES" |
64 .PP | 69 .PP |
65 An exit code of 0 indicates success while a non\-zero exit code indicates failur
e\&. The following failure codes can be returned: | 70 An exit code of 0 indicates success while a non\-zero exit code indicates failur
e\&. The following failure codes can be returned: |
66 .PP | 71 .PP |
67 \fB1\fR | 72 \fB1\fR |
68 .RS 4 | 73 .RS 4 |
69 Error in command line syntax\&. | 74 Error in command line syntax\&. |
70 .RE | 75 .RE |
71 .PP | 76 .PP |
72 \fB2\fR | 77 \fB2\fR |
(...skipping 43 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
116 .if n \{\ | 121 .if n \{\ |
117 .RS 4 | 122 .RS 4 |
118 .\} | 123 .\} |
119 .nf | 124 .nf |
120 xdg\-settings set default\-web\-browser google\-chrome\&.desktop | 125 xdg\-settings set default\-web\-browser google\-chrome\&.desktop |
121 | 126 |
122 .fi | 127 .fi |
123 .if n \{\ | 128 .if n \{\ |
124 .RE | 129 .RE |
125 .\} | 130 .\} |
| 131 .PP |
| 132 Set the default mailto URL scheme handler to be evolution\&.desktop |
| 133 .sp |
| 134 .if n \{\ |
| 135 .RS 4 |
| 136 .\} |
| 137 .nf |
| 138 xdg\-settings set default\-url\-scheme\-handler mailto evolution\&.deskt
op |
| 139 |
| 140 .fi |
| 141 .if n \{\ |
| 142 .RE |
| 143 .\} |
126 .sp | 144 .sp |
127 .SH "AUTHOR" | 145 .SH "AUTHOR" |
128 .PP | 146 .PP |
129 \fBMike Mammarella\fR | 147 \fBMike Mammarella\fR |
130 .RS 4 | 148 .RS 4 |
131 Author. | 149 Author. |
132 .RE | 150 .RE |
133 .SH "COPYRIGHT" | 151 .SH "COPYRIGHT" |
134 .br | 152 .br |
135 Copyright \(co 2009 | 153 Copyright \(co 2009-2011 |
136 .br | 154 .br |
OLD | NEW |