[sawfish] Docs.

[Christopher Bratusek <chrisb src gnome org>]

commit 049053e6c326a694c0a7874dff94018cbc7709b0
Author: Teika kazura <teika lavabit com>
Date:   Tue May 11 14:34:54 2010 +0900

    Docs.

 ChangeLog        |    9 ++++-----
 man/faq.texi     |    2 +-
 man/news.texi    |   11 ++++++-----
 man/sawfish.texi |   14 +++++++++++---
 4 files changed, 22 insertions(+), 14 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 6f1e70e..90fdd1c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -3,10 +3,8 @@
 			-- [modified patch from Gentoo]
 
 	* lisp/sawfish/wm/ext/apps-menu.jl: Allow whitespace and comments
-	                                    at the beginning of .desktop files
-					    and skip the file, if the first valid
-					    line is not [Desktop Entry].
-					    -- [Matthew Love/Teika Kazura]
+	                                    at the beginning of .desktop files.
+					    -- [Matthew Love, Teika Kazura]
 
 	* src/Makefile.in
 	* src/display.c
@@ -49,7 +47,8 @@
 	* lisp/sawfish/wm/state/maximize.jl: make maximize-/-fullscreen/fullxinerama
 	                                     honor maximize-raises [Nolan Leake]
 
-	* lisp/sawfish/wm/ext/apps-menu.jl: more robustness
+	* lisp/sawfish/wm/ext/apps-menu.jl: Anti-brekage for "R".
+	Removal of phony constants. Some code refactoring. [Teika Kazura]
 
 2010-03-13  Christopher Bratusek <zanghar freenet de>
 	* lisp/sawfish/wm/util/display-wininfo.jl: missing require
diff --git a/man/faq.texi b/man/faq.texi
index f798ffe..01b4e27 100644
--- a/man/faq.texi
+++ b/man/faq.texi
@@ -6,7 +6,7 @@
 
 @enumerate
 
- item How can I get informations on Sawfish?
+ item How can I get information on Sawfish?
 
 @itemize
 @item Homepage: @url{http://sawfish.wikia.com/}.
diff --git a/man/news.texi b/man/news.texi
index a355050..d258303 100644
--- a/man/news.texi
+++ b/man/news.texi
@@ -24,13 +24,13 @@ window, if that is too small [Fuchur]
 @code{maximize-window-fullxinerama}, too, not just in maximize-window
 [Nolan Leake]
 
- item More robustness in applications menu [Teika Kazura] [Matthew Love]
+ item More robustness in applications menu [Teika Kazura, Matthew Love]
 
 Before it broke for 'R' (statistics software), and whitespace handling
-didn't follow the specification. Phony constants are removed, too.
+didn't follow the specification.
 
-Allow whitespace and comments at the beginning of .desktop files and skip
-the file, if the first valid line is not [Desktop Entry].
+Some *.desktop files are not ignored any more either, i.e., leading
+empty lines and comments are allowed.
 @end itemize
 
 @item New Features
@@ -95,7 +95,8 @@ lisp files, but now it's guaranteed for all files.
 
 @item ``Windows'' chapter is partly revised. Function @code{display-window}
 is documented. Difference between @code{window-wants-input-p} and
- code{window-really-wants-input-p} is described.
+ code{window-really-wants-input-p} is described. Short description on
+the root window.
 
 @item In past few versions we made more changes which were not described in
 the news, including clarification in viewport, workspace and event,
diff --git a/man/sawfish.texi b/man/sawfish.texi
index 94da14b..a185a30 100644
--- a/man/sawfish.texi
+++ b/man/sawfish.texi
@@ -672,6 +672,11 @@ Returns @code{t} if @var{arg} is a member of the window type, and has a
 client window associated with it.
 @end defun
 
+Since the root window is not a managed client window, it is not
+represented by a window object. Sometimes functions' arguments and
+return value treat the symbol @code{root} as the root window. Window
+hooks are so. But sometimes not.
+
 @menu
 Basics:
 * Window Attributes::
@@ -6684,14 +6689,17 @@ the hooks mechanism. For more details on the hooks mechanism see
 
 As well as using the standard @code{call-hook} function, sawfish also
 provides the @code{call-window-hook} function. This is used to invoke
-hooks which refer to a single window. If the hook has a local value
-defined in the window's property list then this value is used, before
-the default value defined by the actual variable.
+hooks which refer to a single window. Such hook is called ``window
+hook''. If a window hook has a local value defined in the window's
+property list then this value is used, before the default value
+defined by the actual variable.
 
 @defun call-window-hook hook window &optional args hook-type
 Call @var{hook} for @var{window} with further arguments @var{args}. See
 @code{call-hook} for a description of @var{hook-type}. Each function in
 the hook is called with arguments @code{(@var{window} . @var{args})}.
+
+Root window is represented by the symbol @code{root}.
 @end defun
 
 The available hooks are listed below.