[Xfce4-commits] <libxfce4ui:new-sm-client> finish up the XfceSMClient docs
Brian J. Tarricone
brian at tarricone.org
Tue Sep 15 12:42:01 CEST 2009
Updating branch refs/heads/kelnos/new-sm-client
to bef8eee3c84fd9c40d008b5486ff4c01d5069f4e (commit)
from 53a05e42bb84aa0ab31e41b7cb2f86f002b788ba (commit)
commit bef8eee3c84fd9c40d008b5486ff4c01d5069f4e
Author: Brian J. Tarricone <brian at tarricone.org>
Date: Tue Sep 15 01:18:51 2009 -0700
finish up the XfceSMClient docs
docs/libxfce4ui-sections.txt | 2 -
docs/tmpl/xfce-sm-client.sgml | 87 +++++++++++++++++++++++++++--------------
libxfce4ui/xfce-sm-client.h | 6 +-
3 files changed, 60 insertions(+), 35 deletions(-)
diff --git a/docs/libxfce4ui-sections.txt b/docs/libxfce4ui-sections.txt
index 60daa3f..ef8f4e3 100644
--- a/docs/libxfce4ui-sections.txt
+++ b/docs/libxfce4ui-sections.txt
@@ -108,7 +108,6 @@ xfce_sm_client_set_restart_style
xfce_sm_client_get_shutdown_command
xfce_sm_client_set_shutdown_command
<SUBSECTION Standard>
-XfceSMClientClass
XFCE_IS_SM_CLIENT
XFCE_IS_SM_CLIENT_CLASS
XFCE_SM_CLIENT
@@ -120,7 +119,6 @@ XFCE_TYPE_SM_CLIENT_RESTART_STYLE
XFCE_TYPE_SM_CLIENT_SHUTDOWN_HINT
XFCE_TYPE_SM_CLIENT_STATE
<SUBSECTION Private>
-XfceSMClientPrivate
xfce_sm_client_get_type
xfce_sm_client_priority_get_type
xfce_sm_client_restart_style_get_type
diff --git a/docs/tmpl/xfce-sm-client.sgml b/docs/tmpl/xfce-sm-client.sgml
index b68c55b..4c39565 100644
--- a/docs/tmpl/xfce-sm-client.sgml
+++ b/docs/tmpl/xfce-sm-client.sgml
@@ -1,12 +1,14 @@
<!-- ##### SECTION Title ##### -->
-xfce-sm-client
+XfceSMClient
<!-- ##### SECTION Short_Description ##### -->
-
+Session management client
<!-- ##### SECTION Long_Description ##### -->
<para>
-
+#XfceSMClient is a session management client that speaks the X Session
+Management Protocol (XSMP). It's designed to be easy to use and hide some
+of the more esoteric feaures of XSMP from the API user.
</para>
<!-- ##### SECTION See_Also ##### -->
@@ -19,55 +21,80 @@ xfce-sm-client
<!-- ##### STRUCT XfceSMClient ##### -->
<para>
-
+An opaque struct with only private fields.
</para>
<!-- ##### ENUM XfceSMClientPriority ##### -->
<para>
-
+Some sample priority values for use with xfce_sm_client_set_priority().
</para>
- at XFCE_SM_CLIENT_PRIORITY_HIGHEST:
- at XFCE_SM_CLIENT_PRIORITY_WM:
- at XFCE_SM_CLIENT_PRIORITY_DESKTOP:
- at XFCE_SM_CLIENT_PRIORITY_CORE:
- at XFCE_SM_CLIENT_PRIORITY_DEFAULT:
+ at XFCE_SM_CLIENT_PRIORITY_HIGHEST: A relatively-high priority value. You
+ probably don't want to use this.
+ at XFCE_SM_CLIENT_PRIORITY_WM: A priority value for use by the window manager.
+ at XFCE_SM_CLIENT_PRIORITY_DESKTOP: A priority value for use by applications
+ that draw on the desktop.
+ at XFCE_SM_CLIENT_PRIORITY_CORE: A priority value for use by applications that
+ place windows on the screen and possibly set
+ window manager struts.
+ at XFCE_SM_CLIENT_PRIORITY_DEFAULT: A priority value for regular applications.
<!-- ##### ENUM XfceSMClientRestartStyle ##### -->
<para>
-
+An enumeration describing how the session manager should restart
+the application.
</para>
- at XFCE_SM_CLIENT_RESTART_IF_RUNNING:
- at XFCE_SM_CLIENT_RESTART_ANYWAY:
- at XFCE_SM_CLIENT_RESTART_IMMEDIATELY:
- at XFCE_SM_CLIENT_RESTART_NEVER:
+ at XFCE_SM_CLIENT_RESTART_IF_RUNNING: Only restart the application if it is
+ still running at the end of the current
+ session
+ at XFCE_SM_CLIENT_RESTART_ANYWAY: Always restart the application the next
+ time the session starts
+ at XFCE_SM_CLIENT_RESTART_IMMEDIATELY: Immediately restart the application
+ if it ever quits
+ at XFCE_SM_CLIENT_RESTART_NEVER: Don't restart the application; after it
+ runs once, remove it from the session
<!-- ##### ENUM XfceSMClientShutdownHint ##### -->
<para>
-
+Hints to the session manager what kind of shutdown the session manager
+should perform.
</para>
- at XFCE_SM_CLIENT_SHUTDOWN_HINT_ASK:
- at XFCE_SM_CLIENT_SHUTDOWN_HINT_LOGOUT:
- at XFCE_SM_CLIENT_SHUTDOWN_HINT_HALT:
- at XFCE_SM_CLIENT_SHUTDOWN_HINT_REBOOT:
+ at XFCE_SM_CLIENT_SHUTDOWN_HINT_ASK: Prompt the user for a choice
+ at XFCE_SM_CLIENT_SHUTDOWN_HINT_LOGOUT: End the current session
+ at XFCE_SM_CLIENT_SHUTDOWN_HINT_HALT: Shut down the computer
+ at XFCE_SM_CLIENT_SHUTDOWN_HINT_REBOOT: Restart the computer
<!-- ##### ENUM XfceSMClientState ##### -->
<para>
-
-</para>
-
- at XFCE_SM_CLIENT_STATE_IDLE:
- at XFCE_SM_CLIENT_STATE_SAVING_PHASE_1:
- at XFCE_SM_CLIENT_STATE_WAITING_FOR_PHASE_2:
- at XFCE_SM_CLIENT_STATE_SAVING_PHASE_2:
- at XFCE_SM_CLIENT_STATE_WAITING_FOR_INTERACT:
- at XFCE_SM_CLIENT_STATE_INTERACTING:
- at XFCE_SM_CLIENT_STATE_FROZEN:
- at XFCE_SM_CLIENT_STATE_DISCONNECTED:
- at XFCE_SM_CLIENT_STATE_REGISTERING:
+Describes the various X Session Management Protocol states the client
+may be in
+</para>
+
+ at XFCE_SM_CLIENT_STATE_IDLE: The application is running normally
+ at XFCE_SM_CLIENT_STATE_SAVING_PHASE_1: The application is saving its state
+ at XFCE_SM_CLIENT_STATE_WAITING_FOR_PHASE_2: The application has requested
+ an extended save state, and is
+ waiting for the session manaer's
+ response
+ at XFCE_SM_CLIENT_STATE_SAVING_PHASE_2: The application is saving extended
+ state information
+ at XFCE_SM_CLIENT_STATE_WAITING_FOR_INTERACT: The application is waiting its
+ turn to interact with the user
+ during shutdown
+ at XFCE_SM_CLIENT_STATE_INTERACTING: The application is interacting with the
+ user during shutdown
+ at XFCE_SM_CLIENT_STATE_FROZEN: The application is frozen (and should not
+ interact with the user) while waiting for
+ further instructions from the session
+ manager
+ at XFCE_SM_CLIENT_STATE_DISCONNECTED: The application has disconnected from
+ the session manager
+ at XFCE_SM_CLIENT_STATE_REGISTERING: The application has just connected to
+ the session manager and is in the
+ registration phase
<!-- ##### FUNCTION xfce_sm_client_get_option_group ##### -->
<para>
diff --git a/libxfce4ui/xfce-sm-client.h b/libxfce4ui/xfce-sm-client.h
index a0e4859..dc67782 100644
--- a/libxfce4ui/xfce-sm-client.h
+++ b/libxfce4ui/xfce-sm-client.h
@@ -36,12 +36,12 @@
G_BEGIN_DECLS
-typedef enum /*< prefix=XFCE_SM_CLIENT_RESTART_ >*/
+typedef enum
{
XFCE_SM_CLIENT_RESTART_IF_RUNNING = 0,
- XFCE_SM_CLIENT_RESTART_ANYWAY, /* TODO: maybe not support this? */
+ XFCE_SM_CLIENT_RESTART_ANYWAY,
XFCE_SM_CLIENT_RESTART_IMMEDIATELY,
- XFCE_SM_CLIENT_RESTART_NEVER, /* TODO: maybe not support this? */
+ XFCE_SM_CLIENT_RESTART_NEVER,
} XfceSMClientRestartStyle;
typedef enum
More information about the Xfce4-commits
mailing list