diff options
-rw-r--r-- | Makefile.am | 1 | ||||
-rw-r--r-- | configure.ac | 3 | ||||
-rw-r--r-- | man/Makefile.am | 19 | ||||
-rw-r--r-- | man/gnome-settings-daemon.xml | 140 |
4 files changed, 163 insertions, 0 deletions
diff --git a/Makefile.am b/Makefile.am index f4fb3789..c0cbb0ee 100644 --- a/Makefile.am +++ b/Makefile.am @@ -5,6 +5,7 @@ SUBDIRS = \ plugins \ data \ po \ + man \ $(NULL) # Honor aclocal flags diff --git a/configure.ac b/configure.ac index 485585da..6ccfe391 100644 --- a/configure.ac +++ b/configure.ac @@ -415,6 +415,8 @@ AC_SUBST([plugindir]) PLUGIN_CFLAGS="-DG_LOG_DOMAIN=\"\\\"\$(plugin_name)-plugin\\\"\" -DPLUGIN_NAME=\"\\\"\$(plugin_name)\\\"\" " AC_SUBST(PLUGIN_CFLAGS) +AC_PATH_PROG([XSLTPROC], [xsltproc]) + dnl --------------------------------------------------------------------------- dnl - Finish dnl --------------------------------------------------------------------------- @@ -523,6 +525,7 @@ data/org.gnome.settings-daemon.plugins.xrandr.gschema.xml.in data/org.gnome.settings-daemon.peripherals.wacom.gschema.xml.in data/org.gnome.settings-daemon.plugins.print-notifications.gschema.xml.in po/Makefile.in +man/Makefile ]) dnl --------------------------------------------------------------------------- diff --git a/man/Makefile.am b/man/Makefile.am new file mode 100644 index 00000000..644259d2 --- /dev/null +++ b/man/Makefile.am @@ -0,0 +1,19 @@ +XSLTPROC_FLAGS = \ + --nonet \ + --stringparam man.output.quietly 1 \ + --stringparam funcsynopsis.style ansi \ + --stringparam man.th.extra1.suppress 1 \ + --stringparam man.authors.section.enabled 0 \ + --stringparam man.copyright.section.enabled 0 + +.xml.1: + $(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $< + +man_MANS = \ + gnome-settings-daemon.1 + +xml_files = $(man_MANS:.1=.xml) + +EXTRA_DIST = $(xml_files) + +DISTCLEANFILES = $(man_MANS) diff --git a/man/gnome-settings-daemon.xml b/man/gnome-settings-daemon.xml new file mode 100644 index 00000000..b5678e2f --- /dev/null +++ b/man/gnome-settings-daemon.xml @@ -0,0 +1,140 @@ +<?xml version='1.0'?> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> + +<refentry id="gnome-settings-daemon"> + + <refentryinfo> + <title>gnome-settings-daemon</title> + <productname>GNOME</productname> + + <authorgroup> + <author> + <contrib>Maintainer</contrib> + <firstname>Bastien</firstname> + <surname>Nocera</surname> + <email>hadess@hadess.net</email> + </author> + </authorgroup> + + </refentryinfo> + + <refmeta> + <refentrytitle>gnome-settings-daemon</refentrytitle> + <manvolnum>1</manvolnum> + <refmiscinfo class="manual">User Commands</refmiscinfo> + </refmeta> + + <refnamediv> + <refname>gnome-settings-daemon</refname> + <refpurpose>GNOME settings daemon</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis> + <command>gnome-settings-daemon <arg choice="opt" rep="repeat">OPTION</arg></command> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Description</title> + + <para><command>gnome-settings-daemon</command> provides many + session-wide services and functions that require a + long-running process. + Among the services implemented by gnome-settings-daemon + are an XSettings manager, which provides theming, font + and other settings to GTK+ applications, and a clipboard + manager, which preserves clipboard contents when an + application exits. + Many user interface elements of + <command>gnome-shell</command> and + <command>gnome-control-center</command> rely on + gnome-settings-daemon for their functionality. + </para> + + <para>The internal architecture of gnome-settings-daemon + consists of a number of plugins, which provide functionality + such as printer notifications, software update monitoring, + background changing, etc. For debugging purposes, these + plugins can be individually disabled by changing the + gsettings key <literal>org.gnome.settings-daemon.plugins.<replaceable>plugin-name</replaceable>.active</literal>, where + <replaceable>plugin-name</replaceable> is + the name of the plugin. To see a list of all plugins, + use the command + <userinput> + gsettings list-children org.gnome.settings-daemon.plugins + </userinput> + </para> + + <para>gnome-settings-daemon takes the name + org.gnome.SettingsDaemon on the session bus to ensure + that only one instance is running. Some plugins export + objects under this name to make their functionality + available to other applications. The interfaces of + these objects should generally be considered private + and unstable.</para> + + <para>gnome-settings-daemon is a required component of + the GNOME desktop, i.e. it is listed in the + RequiredComponents field of + <filename>/usr/share/gnome-session/sessions/gnome.session</filename>. + It is started in the initialization phase of the session, + and <command>gnome-session</command> will restart it + if it crashes. + </para> + + </refsect1> + + <refsect1> + <title>Options</title> + + <variablelist> + <varlistentry> + <term><option>-h</option>, <option>--help</option></term> + + <listitem><para>Prints a short help + text and exits.</para></listitem> + </varlistentry> + + <varlistentry> + <term><option>--debug</option></term> + + <listitem><para>Enables debugging code.</para></listitem> + </varlistentry> + + <varlistentry> + <term><option>--timed-exit</option></term> + + <listitem><para>Exits after a timeout (30 seconds) for debugging.</para></listitem> + </varlistentry> + + </variablelist> + </refsect1> + + <refsect1> + <title>Files</title> + <variablelist> + <varlistentry> + <term><filename>/usr/share/gnome-session/sessions/gnome.session</filename></term> + + <listitem><para>GNOME session definition file where gnome-settings-daemon is listed as a required component.</para></listitem> + </varlistentry> + <varlistentry> + <term><filename>/etc/xdg/autostart/gnome-settings-daemon.desktop</filename></term> + + <listitem><para>Autostart file for gnome-settings-daemon, where its autostart phase is set.</para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>See Also</title> + <para> + <citerefentry><refentrytitle>gnome-shell</refentrytitle><manvolnum>1</manvolnum></citerefentry>, + <citerefentry><refentrytitle>gnome-control-center</refentrytitle><manvolnum>1</manvolnum></citerefentry>, + <citerefentry><refentrytitle>gnome-session</refentrytitle><manvolnum>1</manvolnum></citerefentry> + </para> + </refsect1> + +</refentry> |