Allow xdg-settings to set the default OS handler for url protocols.

scripts/man/xdg-settings.1

 '\" t
 .\"     Title: xdg-settings
 .\"    Author: Mike Mammarella

[Mike Mammarella, 2011/07/20 00:58:11]

You can probably add yourself (if you want) as a significant contributor to
xdg-settings. :)

[benwells, 2011/07/20 04:33:42]

Maybe next time ;)

 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 12/31/2010
+.\"      Date: 07/11/2011
 .\"    Manual: xdg-settings Manual
 .\"    Source: [FIXME: source]
 .\"  Language: English
 .\"
-.TH "XDG\-SETTINGS" "1" "12/31/2010" "[FIXME: source]" "xdg-settings Manual"
+.TH "XDG\-SETTINGS" "1" "07/11/2011" "[FIXME: source]" "xdg-settings Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 .\" http://bugs.debian.org/507673
 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
 .ad l
 .\" -----------------------------------------------------------------
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
 .SH "NAME"
 xdg-settings \- get various settings from the desktop environment
 .SH "SYNOPSIS"
 .HP \w'\fBxdg\-settings\fR\ 'u
-\fBxdg\-settings\fR {\fB\fIget\fR\fR | \fB\fIcheck\fR\fR | \fB\fIset\fR\fR} {\fBproperty\fR} [\fBvalue\fR]
+\fBxdg\-settings\fR {\fB\fIget\fR\fR | \fB\fIcheck\fR\fR | \fB\fIset\fR\fR} {\fBproperty\fR} [\fBsubproperty\fR] [\fBvalue\fR]
 .HP \w'\fBxdg\-settings\fR\ 'u
 \fBxdg\-settings\fR {\fB\-\-help\fR | \fB\-\-list\fR | \fB\-\-manual\fR | \fB\-\-version\fR}
 .SH "DESCRIPTION"
 .PP
 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 applications that do not use the desktop environment\*(Aqs libraries (which would use the settings natively)\&.
 .PP
 xdg\-settings is for use inside a desktop session only\&. It is not recommended to use xdg\-settings as root\&.
 .SH "OPTIONS"
 .PP
 \fB\-\-help\fR
 .RS 4
 Show command synopsis\&.
 .RE
 .PP
 \fB\-\-list\fR
 .RS 4
 List all properties xdg\-settings knows about\&.
 .RE
 .PP
 \fB\-\-manual\fR
 .RS 4
 Show this manualpage\&.
 .RE
 .PP
 \fB\-\-version\fR
 .RS 4
 Show the xdg\-utils version information\&.
 .RE
+.SH "PROPERTIES"
+.PP
+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\&.
+.PP
+Some properties (such as default\-web\-browser) fully describe the setting to be changed\&. Other properties (such as default\-url\-scheme\-handler) require more information (in this case the actual scheme to set the default handler for) which must be provided in a sub\-property\&.
 .SH "EXIT CODES"
 .PP
 An exit code of 0 indicates success while a non\-zero exit code indicates failure\&. The following failure codes can be returned:
 .PP
 \fB1\fR
 .RS 4
 Error in command line syntax\&.
 .RE
 .PP
 \fB2\fR
@@ skipping 43 matching lines @@
 .if n \{\
 .RS 4
 .\}
 .nf
         xdg\-settings set default\-web\-browser google\-chrome\&.desktop
       
 .fi
 .if n \{\
 .RE
 .\}
+.PP
+Set the default mailto URL scheme handler to be evolution\&.desktop
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+        xdg\-settings set default\-url\-scheme\-handler evolution\&.desktop

[Mike Mammarella, 2011/07/20 00:58:11]

Same comment here.

[benwells, 2011/07/20 04:33:42]

Done.

+      
+.fi
+.if n \{\
+.RE
+.\}
 .sp
 .SH "AUTHOR"
 .PP
 \fBMike Mammarella\fR
 .RS 4
 Author.
 .RE
 .SH "COPYRIGHT"
 .br
 Copyright \(co 2009
 .br