OLD | NEW |
---|---|
1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859 -1"><title>xdg-settings</title><meta name="generator" content="DocBook XSL Style sheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink=" #840084" alink="#0000FF"><div class="refentry" title="xdg-settings"><a name="xdg -settings"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2 ><p>xdg-settings — get various settings from the desktop environment</p></ div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cm dsynopsis"><p><code class="command">xdg-settings</code> { <code class="option"> <em class="replaceable"><code>get</code></em></code> | <code class="option">< em class="replaceable"><code>check</code></em></code> | <code class="option"> <em class="replaceable"><code>set</code></em></code> } {<code class="option">pro perty</code>} [<code class="option">value</code>]</p></div><div class="cmdsynops is"><p><code class="command">xdg-settings</code> { <code class="option">--help< /code> | <code class="option">--list</code> | <code class="option">--manua l</code> | <code class="option">--version</code> }</p></div></div><div class= "refsect1" title="Description"><a name="description"></a><h2>Description</h2><p> | 1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859 -1"><title>xdg-settings</title><meta name="generator" content="DocBook XSL Style sheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink=" #840084" alink="#0000FF"><div class="refentry" title="xdg-settings"><a name="xdg -settings"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2 ><p>xdg-settings — get various settings from the desktop environment</p></ div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cm dsynopsis"><p><code class="command">xdg-settings</code> { <code class="option"> <em class="replaceable"><code>get</code></em></code> | <code class="option">< em class="replaceable"><code>check</code></em></code> | <code class="option"> <em class="replaceable"><code>set</code></em></code> } {<code class="option">pro perty</code>} [<code class="option">subproperty</code>] [<code class="option">va lue</code>]</p></div><div class="cmdsynopsis"><p><code class="command">xdg-setti ngs</code> { <code class="option">--help</code> | <code class="option">--lis t</code> | <code class="option">--manual</code> | <code class="option">--v ersion</code> }</p></div></div><div class="refsect1" title="Description"><a name ="description"></a><h2>Description</h2><p> |
2 xdg-settings gets various settings from the desktop environment. | 2 xdg-settings gets various settings from the desktop environment. |
3 For instance, desktop environments often provide proxy configuration | 3 For instance, desktop environments often provide proxy configuration |
4 and default web browser settings. Using xdg-settings these parameters | 4 and default web browser settings. Using xdg-settings these parameters |
5 can be extracted for use by applications that do not use the desktop | 5 can be extracted for use by applications that do not use the desktop |
6 environment's libraries (which would use the settings natively). | 6 environment's libraries (which would use the settings natively). |
7 </p><p> | 7 </p><p> |
8 xdg-settings is for use inside a desktop session only. | 8 xdg-settings is for use inside a desktop session only. |
9 It is not recommended to use xdg-settings as root. | 9 It is not recommended to use xdg-settings as root. |
10 </p></div><div class="refsect1" title="Options"><a name="options"></a><h2>Op tions</h2><div class="variablelist"><dl><dt><span class="term"><code class="opti on">--help</code></span></dt><dd> | 10 </p></div><div class="refsect1" title="Options"><a name="options"></a><h2>Op tions</h2><div class="variablelist"><dl><dt><span class="term"><code class="opti on">--help</code></span></dt><dd> |
11 Show command synopsis. | 11 Show command synopsis. |
12 </dd><dt><span class="term"><code class="option">--list</code></span>< /dt><dd> | 12 </dd><dt><span class="term"><code class="option">--list</code></span>< /dt><dd> |
13 List all properties xdg-settings knows about. | 13 List all properties xdg-settings knows about. |
14 </dd><dt><span class="term"><code class="option">--manual</code></span ></dt><dd> | 14 </dd><dt><span class="term"><code class="option">--manual</code></span ></dt><dd> |
15 Show this manualpage. | 15 Show this manualpage. |
16 </dd><dt><span class="term"><code class="option">--version</code></spa n></dt><dd> | 16 </dd><dt><span class="term"><code class="option">--version</code></spa n></dt><dd> |
17 Show the xdg-utils version information. | 17 Show the xdg-utils version information. |
18 </dd></dl></div></div><div class="refsect1" title="Exit Codes"><a name ="exitcodes"></a><h2>Exit Codes</h2><p> | 18 </dd></dl></div></div><div class="refsect1" title="Properties"><a name ="properties"></a><h2>Properties</h2><p> |
19 When using xdg-settings to get, check or set a destkop setting, properties | |
20 and possibly sub-properties are used to specify the setting to be changed. | |
21 </p><p> | |
22 Some properties (such as default-web-browser) fully describe the setting | |
23 to be changed. Other properties (such as default-url-scheme-handler) requi re | |
24 more information (in this case the actual scheme to set the default handle r | |
25 for) which must be provided in a sub-property. | |
26 </p></div><div class="refsect1" title="Exit Codes"><a name="exitcodes"></a>< h2>Exit Codes</h2><p> | |
19 An exit code of 0 indicates success while a non-zero exit code | 27 An exit code of 0 indicates success while a non-zero exit code |
20 indicates failure. The following failure codes can be returned: | 28 indicates failure. The following failure codes can be returned: |
21 </p><div class="variablelist"><dl><dt><span class="term"><code class="option ">1</code></span></dt><dd> | 29 </p><div class="variablelist"><dl><dt><span class="term"><code class="option ">1</code></span></dt><dd> |
22 Error in command line syntax. | 30 Error in command line syntax. |
23 </dd><dt><span class="term"><code class="option">2</code></span></dt>< dd> | 31 </dd><dt><span class="term"><code class="option">2</code></span></dt>< dd> |
24 One of the files passed on the command line did not exist. | 32 One of the files passed on the command line did not exist. |
25 </dd><dt><span class="term"><code class="option">3</code></span></dt>< dd> | 33 </dd><dt><span class="term"><code class="option">3</code></span></dt>< dd> |
26 A required tool could not be found. | 34 A required tool could not be found. |
27 </dd><dt><span class="term"><code class="option">4</code></span></dt>< dd> | 35 </dd><dt><span class="term"><code class="option">4</code></span></dt>< dd> |
28 The action failed. | 36 The action failed. |
29 </dd></dl></div></div><div class="refsect1" title="Examples"><a name=" examples"></a><h2>Examples</h2><p> | 37 </dd></dl></div></div><div class="refsect1" title="Examples"><a name=" examples"></a><h2>Examples</h2><p> |
30 Get the desktop file name of the current default web browser | 38 Get the desktop file name of the current default web browser |
31 </p><pre class="programlisting"> | 39 </p><pre class="programlisting"> |
32 xdg-settings get default-web-browser | 40 xdg-settings get default-web-browser |
33 </pre><p> | 41 </pre><p> |
34 </p><p> | 42 </p><p> |
35 Check whether the default web browser is firefox.desktop, which can be | 43 Check whether the default web browser is firefox.desktop, which can be |
36 false even if "get default-web-browser" says that is the current value | 44 false even if "get default-web-browser" says that is the current value |
37 (if only some of the underlying settings actually reflect that value) | 45 (if only some of the underlying settings actually reflect that value) |
38 </p><pre class="programlisting"> | 46 </p><pre class="programlisting"> |
39 xdg-settings check default-web-browser firefox.desktop | 47 xdg-settings check default-web-browser firefox.desktop |
40 </pre><p> | 48 </pre><p> |
41 </p><p> | 49 </p><p> |
42 Set the default web browser to google-chrome.desktop | 50 Set the default web browser to google-chrome.desktop |
43 </p><pre class="programlisting"> | 51 </p><pre class="programlisting"> |
44 xdg-settings set default-web-browser google-chrome.desktop | 52 xdg-settings set default-web-browser google-chrome.desktop |
45 </pre><p> | 53 </pre><p> |
54 </p><p> | |
55 Set the default mailto URL scheme handler to be evolution.desktop | |
56 </p><pre class="programlisting"> | |
57 xdg-settings set default-url-scheme-handler evolution.desktop | |
Mike Mammarella
2011/07/20 00:58:11
This file is generated, right? Otherwise same comm
benwells
2011/07/20 04:33:42
Done.
| |
58 </pre><p> | |
46 </p></div></div></body></html> | 59 </p></div></div></body></html> |
OLD | NEW |