[sawfish: 2/4] Doc.

[Christopher Bratusek <chrisb src gnome org>]

commit 13b7dc08b059ffcb9f5cf2d947ecb90a82912bfb
Author: Teika kazura <teika lavabit com>
Date:   Tue Oct 19 15:12:18 2010 +0900

    Doc.
    
    * News. Deleted changes "invisible" to users, almost invisible to developers.
    * More translation doc improvements.
    * Added Kim B Heino to the "Thanks" list.

 CONTRIBUTING  |    1 +
 Makefile.in   |   10 ++++++----
 man/news.texi |   54 +++++++++++++++++++++++++-----------------------------
 po/README     |   14 ++++++++------
 po/make-pot   |   10 +---------
 5 files changed, 41 insertions(+), 48 deletions(-)
---
diff --git a/CONTRIBUTING b/CONTRIBUTING
index e3b72b7..c698080 100644
--- a/CONTRIBUTING
+++ b/CONTRIBUTING
@@ -102,6 +102,7 @@ Christopher Bratusek (Maintainer since Dec 2008)
  - Jeremy Hankins for some new window-matchers
  - Jonathan Sambrook for Maximize fullscreen xinerama patch
  - Jürgen Hötzel for general help
+ - Kim B Heino for Red Hat and other installation cleanups
  - Mark Schreiber for move-window-"direction" focus patch
  - Martin Mares for Avoid errors on windows with no class patch
  - Matthew Love for sawfish.wm.ext.fdo-menu
diff --git a/Makefile.in b/Makefile.in
index c3f3eba..2b6b341 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -1,6 +1,6 @@
-# Makefile.in for sawfish version 4
-# Copyright (C) 1998 John Harper <john dcs warwick ac uk>
-# $Id: Makefile.in,v 1.31 2003/04/03 02:24:42 jsh Exp $
+# Makefile.in for sawfish
+# Copyright (C) 1998 - 2008 John Harper
+#               2008 - 2010 Sawfish Community
 #
 # This file is part of sawfish.
 #
@@ -30,7 +30,7 @@ SUBDIRS = @SUBDIRS@
 all : build.h DOC
 	for dir in $(SUBDIRS); do \
 	  [ -d $$dir ] && ( cd $$dir && $(MAKE) $@ ) || exit 1; \
- 	done
+	done
 
 # this depends on config.status so it's rebuilt if configure is re-run
 build.h : build-info config.status
@@ -72,6 +72,8 @@ uninstall :
 	rm -f $(DESTDIR)$(GNOMEDIR)/share/gnome/wm-properties/sawfish-wm.desktop
 	rm -f $(DESTDIR)$(KDEDIR)/ksmserver/windowmanagers/sawfish.desktop
 
+# At this stage, DOC file omits some docstrings. (Only small portion,
+# though.) Byte compilation makes it complete.
 DOC :
 	repdoc DOC `find $(srcdir) \( -name '*.c' -o -name '*.jl' \) -print`
 
diff --git a/man/news.texi b/man/news.texi
index f71e553..62bee4b 100644
--- a/man/news.texi
+++ b/man/news.texi
@@ -4,10 +4,10 @@
 
 @chapter News
 
-This lists the user-visible changes made to Sawfish, and which releases
-they occurred between. For more detailed information see the
- file{ChangeLog} file in the Sawfish source tree, or git log.
-(See Wiki page on how to access git repository.)
+This lists user-visible changes, and which releases they occurred
+between. For more detailed information see the @file{ChangeLog} file
+in the Sawfish source tree, or git log.  (See Wiki page on how to
+access git repository.)
 
 @c @heading x.y.z ``Code name''
 @c @itemize @bullet
@@ -45,12 +45,13 @@ they occurred between. For more detailed information see the
 @itemize @minus
 
 @item Poweroff-menu fix [Teika Kazura, Christopher Bratusek]
-When running standalone the poweroff menu-items in the Session menu were not
-accessible by the user, this has been fixed.
+
+In Sawfish-1.7.0, poweroff related items in the popup menu couldn't be
+invoked, if run without any desktop environment. Fixed it.
 
 @item Correctly build SawfishPager [Christopher Bratusek]
-The sawfish.pc file was improved, so that it is ensured that SawfishPager does
-build correctly.
+
+It is ensured that SawfishPager builds correctly, by improving @file{sawfish.pc} file.
 @end itemize
 @item Misc Changes
 @itemize @minus
@@ -58,39 +59,34 @@ build correctly.
 @item Window-operation menu improvement [Christopher Bratusek]
 
 @itemize +
- item The window-operation menu now honours window-matchers.
-For example, if you have a window matched with @code{fixed-size} the
+ item The window-operation menu now honours window rules better.
+For example, if you have a window with @code{fixed-size} flag, the
 window-operations menu-entry @code{Resize} becomes unclickable.
- item The entries for moving and copying windows to the previous or
-next workspace are now bundled in the new @code{Workspace} sub-menu.
+ item The entries for moving and copying windows to another workspace are
+now bundled in the new @code{Workspace} sub-menu.
 @end itemize
- item Cleaned-up desktop-environment detection [Teika Kazura]
-
- item Sawfish emacs major-mode now indents let-fluids [Teika Kazura]
 
 @item Translation related changes [Teika Kazura]
 
 @itemize +
- item revised make-pot update.sh
- item cleaned-up sawfish.pot
- item added po/README translator instructions
- item the spanish translations has been updated [gnome-es translation-team]
+ item Added translator instructions in @file{po/README} file.
+ item Before you run @file{po/make-pot} to generate @file{sawfish.pot}, you
+now have to do @code{make all} at the top directory. Previously it was
+possible to produce wrong @file{sawfish.pot}.
+ item Banished some bogus items in @file{sawfish.pot}
+ item the Spanish translations has been updated [gnome-es translation-team]
 @end itemize
 
- item SawfishConfig changes [Teika Kazura]
+ item Emacs sawfish-mode now indents let-fluids correctly [Teika Kazura]
 
- itemize +
- item renamed window-rules category @code{Placement} to @code{Geometry}
- item moved window-rule @code{shade-hover} to @code{appearance} category
- item moved window-rule @code{fixed-size} to @code{geometry} category
- end itemize
- item Spec-File compatibility for RHEL 6beta [Kim B. Heino]
+ item SawfishConfig ``Window rules'' section changes [Teika Kazura]
 
- item Removed a bogus import from scheme-boolean.jl [Teika Kazura]
+Category @code{Placement} is renamed to @code{Geometry}.  The item
+ code{shade-hover} is moved to @code{appearance} category, and
+ code{fixed-size} to @code{geometry}.
 
- item Overall indention fixes for better code-readability [Teika Kazura]
+ item Spec-File compatibility for RHEL 6beta [Kim B. Heino]
 
- item In xfce-integration module replace GNOME with XFCE in comments [Christopher Bratusek]
 @end itemize
 @end itemize
 
diff --git a/po/README b/po/README
index fb68dd5..d308de0 100644
--- a/po/README
+++ b/po/README
@@ -63,8 +63,8 @@ may depend on languages. (Don't ask them Sawfish specific questions.)
 
 Web:
 First go to the GNOME translation home[1], and check your language
-team. Register there, go to the Sawfish page[2], "reserve for
-translation", and paste your po file.
+team. Register there, go to the Sawfish page[2], choose "Review
+required", and paste your po file.
 
 [1]: http://l10n.gnome.org/
 [2]: http://l10n.gnome.org/module/sawfish/
@@ -99,13 +99,15 @@ difficult to get the meaning, without reading the documentation of
 that command. Notice that command `foo-bar-baz' appears as "Foo bar
 baz" in msgid.
 
+c-format are probably not c
+---------------------------
+`c-format' flags are probably wrong, but we can't disable it. You may
+have to change them to `no-c-format' to submit a po file to GNOME web
+page.
+
 Not all are translated
 ----------------------
 Please expand this list of untranslated strings.
 
 * Event names like "Button1-Off". (This is difficult to support, so
   we won't fix it in near future.)
-
-Po file comments
-----------------
-Please ignore `c-format' flag. We can't disable it.
diff --git a/po/make-pot b/po/make-pot
index e1652d8..7dda8e9 100755
--- a/po/make-pot
+++ b/po/make-pot
@@ -19,18 +19,10 @@
 # the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
 if [ ! -r ../DOC ]; then
-    echo "First do \"make all\"."
+    echo "First do \"make all\". (Read Makefile for the reason.)"
     exit 0
 fi
 
-# The problem is that the following misses several items. "make all"
-# has to preceed.
-# $ rm -f ../DOC
-# $ repdoc ../DOC `find ../ \( -name '*.c' -o -name '*.jl' \) -print`
-
-# Some jl files are generated by make, but this problem is not related
-# to it. For example, some in commands.jl are ignored.
-
 REP_SRCS="../scripts/*.jl ../themes/*/theme.jl"
 REP_SRCS="$REP_SRCS `find ../lisp -name '*.jl' -print`"
 rm -f sawfish.pot