diff options
| -rw-r--r-- | idle-inhibit/specification.xml | 73 |
1 files changed, 42 insertions, 31 deletions
diff --git a/idle-inhibit/specification.xml b/idle-inhibit/specification.xml index 4bd7525..8c6db47 100644 --- a/idle-inhibit/specification.xml +++ b/idle-inhibit/specification.xml @@ -1,5 +1,7 @@ -<?xml version="1.0"?> -<book xml:id="index" xmlns="http://docbook.org/ns/docbook" version="5.0"> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" +"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ +]> +<book xml:id="index" xmlns="http://docbook.org/ns/docbook"> <bookinfo> <title>Idle Inhibition Service Draft</title> <releaseinfo> @@ -26,9 +28,9 @@ </bookinfo> - <part xml:id="description"> + <part id="description"> <title>API Documentation</title> - <chapter xml:id="introduction"> + <chapter id="introduction"> <title>Introduction</title> <para>The Idle Inhibition Service API allows client applications to inhibit a @@ -42,34 +44,33 @@ a common way to inhibit idleness.</para> </chapter> - <chapter xml:id="consequences"> + <chapter id="consequences"> <title>Consequences of idleness</title> <para>Depending on the user session software running, idleness can have multiple - consequences, including, but not limited to: - <segmentedlist> - <?dbhtml list-presentation="list"?> - <seglistitem>Screen backlight dimming</seglistitem> - <seglistitem>Screensaver animation replacing the desktop content</seglistitem> - <seglistitem>Instant messenging client going to "auto-away"</seglistitem> - <seglistitem>Computer suspending or hibernating</seglistitem> - </segmentedlist> + consequences, including, but not limited to: + <itemizedlist> + <listitem><para>Screen backlight dimming</para></listitem> + <listitem><para>Screensaver animation replacing the desktop content</para></listitem> + <listitem><para>Instant messenging client going to "auto-away"</para></listitem> + <listitem><para>Computer suspending or hibernating</para></listitem> + </itemizedlist> </para> <para>Inhibiting idleness is supposed to stop all those actions from taking place, specifically in response to idleness. A user action asking for any of those states would obviously - be acted upon witout delay.</para>. + be acted upon witout delay.</para> </chapter> - <chapter xml:id='api'> + <chapter id='api'> <title>API overview</title> <para>Idle inhibition is achieved by the application calling an - <link linked="org.freedesktop.ScreenSaver.Inhibit"><function>Inhibit</function></link> + <link linkend="org.freedesktop.ScreenSaver.Inhibit"><function>Inhibit</function></link> method on a well-known D-Bus name.</para> - <para>Inhibition will stop when the <link linked="org.freedesktop.ScreenSaver.UnInhibit"><function> + <para>Inhibition will stop when the <link linkend="org.freedesktop.ScreenSaver.UnInhibit"><function> UnInhibit</function></link> method is called, or the application disconnects from the D-Bus session bus (which usually happens upon exit).</para> @@ -98,7 +99,7 @@ </part> - <part xml:id="ref-dbus-api"> + <part id="ref-dbus-api"> <title>D-Bus API Reference</title> <xi:include href="reference.xml" xpointer="interfaces" xmlns:xi="http://www.w3.org/2001/XInclude"> @@ -107,19 +108,29 @@ </part> - <bibliography> + <part> <title>References</title> - - <bibliomixed> - <abbrev>kde-api</abbrev> - <ulink url="https://projects.kde.org/projects/kde/kde-workspace/repository/revisions/master/entry/ksmserver/screenlocker/dbus/org.freedesktop.ScreenSaver.xml">KDE Screenlocker D-Bus API</ulink> - </bibliomixed> - - <bibliomixed> - <abbrev>gnome-impl</abbrev> - <ulink url="http://git.gnome.org/browse/gnome-settings-daemon/tree/plugins/screensaver-proxy">GNOME org.freedesktop.ScreenSaver proxy implementation</ulink> - </bibliomixed> - - </bibliography> + <chapter> + <title>References</title> + <variablelist> + <varlistentry> + <term>kde-api</term> + <listitem> + <para> + <ulink url="https://projects.kde.org/projects/kde/kde-workspace/repository/revisions/master/entry/ksmserver/screenlocker/dbus/org.freedesktop.ScreenSaver.xml">KDE Screenlocker D-Bus API</ulink> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>gnome-impl</term> + <listitem> + <para> + <ulink url="http://git.gnome.org/browse/gnome-settings-daemon/tree/plugins/screensaver-proxy">GNOME org.freedesktop.ScreenSaver proxy implementation</ulink> + </para> + </listitem> + </varlistentry> + </variablelist> + </chapter> + </part> </book> |