[sawfish: 2/6] Small manual reorganization.

[Christopher Bratusek <chrisb src gnome org>]

commit c5cc94e745ad836c40066451539ea05452276be7
Author: Teika kazura <teika lavabit com>
Date:   Tue Dec 8 21:32:57 2009 +0900

    Small manual reorganization.

 man/sawfish.texi |  140 +++++++++++++++++++++++++++++-------------------------
 1 files changed, 75 insertions(+), 65 deletions(-)
---
diff --git a/man/sawfish.texi b/man/sawfish.texi
index a845a1b..e7663b4 100644
--- a/man/sawfish.texi
+++ b/man/sawfish.texi
@@ -5571,8 +5571,12 @@ under @code{system}.
 @defunx destroy-window
 @defunx kill-client
 @defunx no-operation
+
 Calls the function of the same name.  @code{destroy-window} and
 @code{kill-client} both take @code{%W} as argument.
+
+(Strictly speaking, @code{kill-client} calls @code{x-kill-client},
+and @code{no-operation} calls @code{nop}.)
 @end defun
 
 @node Keymaps, Event Loop, Commands, Top
@@ -5796,6 +5800,7 @@ Returns the number of X events waiting to be handled.
 * Display Functions::
 * Rectangle Functions::
 * Gradient Functions::
+* Sawfish Invocation Functions::
 * Other Functions::
 @end menu
 
@@ -6265,7 +6270,7 @@ head on some viewport.
 @end defun
 
 
- node Gradient Functions, Other Functions, Rectangle Functions, Miscellaneous Functions
+ node Gradient Functions, Sawfish Invocation Functions, Rectangle Functions, Miscellaneous Functions
 @section Gradient Functions
 @cindex Gradient functions
 @cindex Functions, gradients
@@ -6292,8 +6297,74 @@ will be @var{from}, the color at the bottom-right @var{to}, with a
 smooth transition between.
 @end defun
 
+ node Sawfish Invocation Functions, Other Functions, Gradient Functions, Miscellaneous Functions
+ section Sawfish Invocation Functions
+ cindex Sawfish Invocation Functions
+ cindex Functions, Sawfish invocation
+
+ defvar sawfish-version
+The version number of the running Sawfish.
+ end defvar
+
+ defvar sawfish-directory
+The home directory for Sawfish files.  For example:
+ code{"/usr/share/sawfish"}. You can override it with the environment
+variable @code{SAWFISHDIR}.
+ end defvar
+
+ defvar sawfish-exec-directory
+The directory for architechture-specific Sawfish executables.  For
+example: @code{"/usr/lib/sawfish/1.3/i386-pc-linux-gnu"}. You can
+override it with the environment variable @code{SAWFISHEXECDIR}.
+ end defvar
+
+ defvar sawfish-lisp-lib-directory
+The top-level directory for Sawfish lisp files.  For example:
+ code{"/usr/share/sawfish/1.3/lisp"}. You can override it with the
+environment variable @code{SAWFISHLISPDIR}.
+ end defvar
+
+ defvar sawfish-locale-directory
+The system directory where Sawfish can find locale files.  This is not
+part of the Sawfish distribution.  For example:
+ code{"/usr/share/locale"}.
+ end defvar
+
+ defvar sawfish-site-lisp-directory
+The top-level directory for site-specific Sawfish lisp files.  For
+example: @code{"/usr/share/sawfish/site-lisp"}. You can override it
+with the environment variable @code{SAWFISHSITELISPDIR}.
+ end defvar
+
+ defun exit-type
+If Sawfish is shutting down, this function returns one of the strings
+ code{"user-quit"}, @code{"user-restart"} or @code{"session-quit"}.
+If Sawfish is not shutting down, it returns @code{nil}.
+ end defun
+
+ defun poweroff action
+A function for rebooting, halting, suspending and hibernating
+your machine. Normally this is only used when running outside
+of GNOME or KDE; they provied their own versions of functions.
+
+ var{action} is a symbol, and each invokes the shell command
+defined by the variable as follows:
+
+ multitable @columnfractions .2 .5
+ headitem @var{action} @tab variable
+ item @code{reboot} @tab @code{reboot-command}
+ item @code{halt} @tab @code{halt-command}
+ item @code{suspend} @tab @code{suspend-command}
+ item @code{hibernate} @tab @code{hibernate-command}
+ end multitable
+
+When @var{action} is @code{reboot} or @code{halt}, 
+ code{before-exit-hook} is called, and @code{delete-windows} is
+applied to each window to ensure we safely quit the current session.
+ end defun
+
 
- node Other Functions, , Gradient Functions, Miscellaneous Functions
+ node Other Functions, , Sawfish Invocation Functions, Miscellaneous Functions
 @section Other Functions
 @cindex Other functions
 @cindex Functions, other
@@ -6319,12 +6390,6 @@ specified dimensions.
 Returns the window id of the new window.
 @end defun
 
- defun exit-type
-If Sawfish is shutting down, this function returns one of the strings
- code{"user-quit"}, @code{"user-restart"} or @code{"session-quit"}.
-If Sawfish is not shutting down, it returns @code{nil}.
- end defun
-
 @defun x-atom symbol
 Return the integer identifying the X atom with the same name as
 @var{symbol}.
@@ -6346,66 +6411,11 @@ A string containing the name of the X display, exactly as passed to
 Sawfish.  For example: @code{":0"}, or @code{"foo:0.0"}.
 @end defvar
 
- defun poweroff action
-A function for rebooting, halting, suspending and hibernating
-your machine. Normally this is only used when running outside
-of GNOME or KDE; they provied their own versions of functions.
-
- var{action} is a symbol, and each invokes the shell command
-defined by the variable as follows:
-
- multitable @columnfractions .2 .5
- headitem @var{action} @tab variable
- item @code{reboot} @tab @code{reboot-command}
- item @code{halt} @tab @code{halt-command}
- item @code{suspend} @tab @code{suspend-command}
- item @code{hibernate} @tab @code{hibernate-command}
- end multitable
-
-When @var{action} is @code{reboot} or @code{halt}, 
- code{before-exit-hook} is called, and @code{delete-windows} is
-applied to each window to ensure we safely quit the current session.
- end defun
-
 @defvar saved-command-line-args
 Holds a list of all of the command line arguments (including the
 executable name).
 @end defvar
 
- defvar sawfish-directory
-The home directory for Sawfish files.  For example:
- code{"/usr/share/sawfish"}. You can override it with the environment
-variable @code{SAWFISHDIR}.
- end defvar
-
- defvar sawfish-exec-directory
-The directory for architechture-specific Sawfish executables.  For
-example: @code{"/usr/lib/sawfish/1.3/i386-pc-linux-gnu"}. You can
-override it with the environment variable @code{SAWFISHEXECDIR}.
- end defvar
-
- defvar sawfish-lisp-lib-directory
-The top-level directory for Sawfish lisp files.  For example:
- code{"/usr/share/sawfish/1.3/lisp"}. You can override it with the
-environment variable @code{SAWFISHLISPDIR}.
- end defvar
-
- defvar sawfish-locale-directory
-The system directory where Sawfish can find locale files.  This is not
-part of the Sawfish distribution.  For example:
- code{"/usr/share/locale"}.
- end defvar
-
- defvar sawfish-site-lisp-directory
-The top-level directory for site-specific Sawfish lisp files.  For
-example: @code{"/usr/share/sawfish/site-lisp"}. You can override it
-with the environment variable @code{SAWFISHSITELISPDIR}.
- end defvar
-
- defvar sawfish-version
-The version number of the running Sawfish.
- end defvar
-
 @defun call-with-error-handler thunk
 Call the zero-parameter function @var{thunk}.  If an error occurs,
 trap it and pass its @code{car} and @code{cdr} to
@@ -7187,7 +7197,7 @@ Return the X11 keysym (an integer) named by the Lisp symbol
 
 
 @node X Bitmaps and Pixmaps, X Drawing, X Keysyms, Low-level X Interface
- section X Windows
+ section X Bitmaps and Pixmaps
 
 @defun x-bitmap-p
 Return @code{t} if @var{arg} is an X-bitmap object.
@@ -7234,7 +7244,7 @@ Return @code{t} if @var{obj} is an X pixmap object.
 
 
 @node X Drawing, Available X Symbols, X Bitmaps and Pixmaps, Low-level X Interface
- section X Windows
+ section X Drawing
 
 @defun x-clear-window window
 Clear the window associated with @var{window} to its background color.