OLD | NEW |
(Empty) | |
| 1 '\" t |
| 2 .\" Title: xdg-settings |
| 3 .\" Author: Mike Mammarella |
| 4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> |
| 5 .\" Date: 12/31/2010 |
| 6 .\" Manual: xdg-settings Manual |
| 7 .\" Source: [FIXME: source] |
| 8 .\" Language: English |
| 9 .\" |
| 10 .TH "XDG\-SETTINGS" "1" "12/31/2010" "[FIXME: source]" "xdg-settings Manual" |
| 11 .\" ----------------------------------------------------------------- |
| 12 .\" * Define some portability stuff |
| 13 .\" ----------------------------------------------------------------- |
| 14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 15 .\" http://bugs.debian.org/507673 |
| 16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
| 17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 18 .ie \n(.g .ds Aq \(aq |
| 19 .el .ds Aq ' |
| 20 .\" ----------------------------------------------------------------- |
| 21 .\" * set default formatting |
| 22 .\" ----------------------------------------------------------------- |
| 23 .\" disable hyphenation |
| 24 .nh |
| 25 .\" disable justification (adjust text to left margin only) |
| 26 .ad l |
| 27 .\" ----------------------------------------------------------------- |
| 28 .\" * MAIN CONTENT STARTS HERE * |
| 29 .\" ----------------------------------------------------------------- |
| 30 .SH "NAME" |
| 31 xdg-settings \- get various settings from the desktop environment |
| 32 .SH "SYNOPSIS" |
| 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] |
| 35 .HP \w'\fBxdg\-settings\fR\ 'u |
| 36 \fBxdg\-settings\fR {\fB\-\-help\fR | \fB\-\-list\fR | \fB\-\-manual\fR | \fB\-\
-version\fR} |
| 37 .SH "DESCRIPTION" |
| 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)\&. |
| 40 .PP |
| 41 xdg\-settings is for use inside a desktop session only\&. It is not recommended
to use xdg\-settings as root\&. |
| 42 .SH "OPTIONS" |
| 43 .PP |
| 44 \fB\-\-help\fR |
| 45 .RS 4 |
| 46 Show command synopsis\&. |
| 47 .RE |
| 48 .PP |
| 49 \fB\-\-list\fR |
| 50 .RS 4 |
| 51 List all properties xdg\-settings knows about\&. |
| 52 .RE |
| 53 .PP |
| 54 \fB\-\-manual\fR |
| 55 .RS 4 |
| 56 Show this manualpage\&. |
| 57 .RE |
| 58 .PP |
| 59 \fB\-\-version\fR |
| 60 .RS 4 |
| 61 Show the xdg\-utils version information\&. |
| 62 .RE |
| 63 .SH "EXIT CODES" |
| 64 .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: |
| 66 .PP |
| 67 \fB1\fR |
| 68 .RS 4 |
| 69 Error in command line syntax\&. |
| 70 .RE |
| 71 .PP |
| 72 \fB2\fR |
| 73 .RS 4 |
| 74 One of the files passed on the command line did not exist\&. |
| 75 .RE |
| 76 .PP |
| 77 \fB3\fR |
| 78 .RS 4 |
| 79 A required tool could not be found\&. |
| 80 .RE |
| 81 .PP |
| 82 \fB4\fR |
| 83 .RS 4 |
| 84 The action failed\&. |
| 85 .RE |
| 86 .SH "EXAMPLES" |
| 87 .PP |
| 88 Get the desktop file name of the current default web browser |
| 89 .sp |
| 90 .if n \{\ |
| 91 .RS 4 |
| 92 .\} |
| 93 .nf |
| 94 xdg\-settings get default\-web\-browser |
| 95 |
| 96 .fi |
| 97 .if n \{\ |
| 98 .RE |
| 99 .\} |
| 100 .PP |
| 101 Check whether the default web browser is firefox\&.desktop, which can be false e
ven if "get default\-web\-browser" says that is the current value (if only some
of the underlying settings actually reflect that value) |
| 102 .sp |
| 103 .if n \{\ |
| 104 .RS 4 |
| 105 .\} |
| 106 .nf |
| 107 xdg\-settings check default\-web\-browser firefox\&.desktop |
| 108 |
| 109 .fi |
| 110 .if n \{\ |
| 111 .RE |
| 112 .\} |
| 113 .PP |
| 114 Set the default web browser to google\-chrome\&.desktop |
| 115 .sp |
| 116 .if n \{\ |
| 117 .RS 4 |
| 118 .\} |
| 119 .nf |
| 120 xdg\-settings set default\-web\-browser google\-chrome\&.desktop |
| 121 |
| 122 .fi |
| 123 .if n \{\ |
| 124 .RE |
| 125 .\} |
| 126 .sp |
| 127 .SH "AUTHOR" |
| 128 .PP |
| 129 \fBMike Mammarella\fR |
| 130 .RS 4 |
| 131 Author. |
| 132 .RE |
| 133 .SH "COPYRIGHT" |
| 134 .br |
| 135 Copyright \(co 2009 |
| 136 .br |
OLD | NEW |