[Xfce4-commits] <garcon:master> Update AUTHORS, README, NEWS and more.

[Jannis Pohlmann]

Updating branch refs/heads/master
         to a241b0ab3f9c1d8660c56ffe0d82d13840c75aeb (commit)
       from 662304674ee25950570d0041b8737bba0e69d265 (commit)

commit a241b0ab3f9c1d8660c56ffe0d82d13840c75aeb
Author: Jannis Pohlmann <jannis at xfce.org>
Date:   Sat Oct 10 02:46:07 2009 +0200

    Update AUTHORS, README, NEWS and more.

 AUTHORS                   |    1 +
 HACKING                   |    2 +-
 NEWS                      |   46 ++++++++------------------------------------
 NEWS => NEWS.libxfce4menu |    0
 README                    |   17 ++++++++++++---
 STATUS                    |    8 ++----
 6 files changed, 27 insertions(+), 47 deletions(-)

diff --git a/AUTHORS b/AUTHORS
index 4efd77d..e7e34a7 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -1,2 +1,3 @@
 Jannis Pohlmann <jannis at xfce.org>
+Nick Schermer <nick at xfce.org>
 Travis Watkins <amaranth at ubuntu.com>
diff --git a/HACKING b/HACKING
index 870fb72..7f58f0d 100644
--- a/HACKING
+++ b/HACKING
@@ -39,7 +39,7 @@ Coding Style
 Release process
 ===============
 
-  1) Check out a fresh copy from Subversion
+  1) Check out a fresh copy from Git
   2) Increment the version number in configure.in.in and the major version
      number of the library whenever new functions got added.
   3) Update NEWS and ChangeLog, and don't forget to add a note about the new
diff --git a/NEWS b/NEWS
index e91cda1..19d57fb 100644
--- a/NEWS
+++ b/NEWS
@@ -1,37 +1,9 @@
-=========================
-OLD NEWS FOR libxfce4menu
-=========================
-
-4.5.99.2
-========
-- Add hint about no invariant sections to COPYING.
-- Fix crash when reading invalid menu files (bug #4879).
-
-4.5.99.1
-========
-- Add GNU Free Documentation License 1.1 to COPYING.
-- Update translations: da, eu, fr, ja, nb_NO, pt_BR, sv, zh_CN.
-
-4.5.93
-======
-- Add weak pointers to the XfceMenuItemCache and XfceMenuSeparator objects
-  so you can run xfce_menu_init() and xfce_menu_shutdown() multiple times.
-- Always using xfce_menu_get_element() when comparing two menu elements
-  instead of comparing menus and items in different ways. 
-- Review strings.
-- Updated translations: cs, es, eu, fi, hu, ja, pt_BR, sq, sv.
-
-4.5.92
-======
-- Translations: ca, da, ku, nb_NO, sq, tr.
-
-4.5.91
-======
-- Translations: cs, da, de, el, en_GB, es, fi, fr, gl, id, ja, lv, 
-  pl, pt_BR, pt_PT, sq, uk, ur.
-
-4.5.90
-======
-- Initial release as part of Xfce.
-- Translations: cs, da, de, el, en_GB, fi, fr, gl, id, ja, lv, pl, 
-  pt_BR, pt_PT, sq, uk, ur.
+0.1.0
+=====
+- This is a complete rewrite of the former Xfce menu library called 
+  libxfce4menu. It covers almost every part of the menu specification
+  except for legacy menus and a few XML attributes. In contrast to 
+  libxfce4menu, it can also load menus modified with menu editors such
+  as Alacarte as menu merging is now supported. The only crucial 
+  feature still missing is monitoring menus and menu items for changes.
+  This is something that will be worked on for the next release.
diff --git a/NEWS b/NEWS.libxfce4menu
similarity index 100%
copy from NEWS
copy to NEWS.libxfce4menu
diff --git a/README b/README
index a52c92a..e7ae28d 100644
--- a/README
+++ b/README
@@ -2,14 +2,23 @@ What is it?
 ===========
 
 This is garcon, a freedesktop.org compliant menu implementation based
-on GLib and GIO.
+on GLib and GIO. It was started as a complete rewrite of the former 
+Xfce menu library called libxfce4menu, which, in contrast to garcon, 
+was lacking menu merging features essential for loading menus modified 
+with menu editors.
 
 
 Current state
 =============
 
-garcon already covers the most important parts of the menu specification. 
-It is however still in development and thus, neither stable nor complete.
+Garcon covers almost every part of the menu specification except for
+legacy menus and a few XML attributes. In contrast to 
+libxfce4menu, it can also load menus modified with menu editors such
+as Alacarte as menu merging is now supported. The only crucial 
+feature still missing is monitoring menus and menu items for changes.
+This is something that will be worked on for the next release.
+
+The garcon API will most likely not be frozen until its 1.0.0 release!
 
 
 Installation
@@ -41,7 +50,7 @@ How to report bugs?
 ===================
 
 Bugs should be reported to the Xfce bug tracking system 
-(http://bugzilla.xfce.org, product garcon). You will need to create an 
+(http://bugzilla.xfce.org, product Garcon). You will need to create an 
 account for yourself.
 
 Please read the HACKING file for information on where to send changes or 
diff --git a/STATUS b/STATUS
index 7a89abc..85eaabe 100644
--- a/STATUS
+++ b/STATUS
@@ -153,8 +153,6 @@ II. Test suite results
 III. Filesystem monitoring
 ==========================
 
-  Filesystem monitoring is done by moving the actual work into the 
-  client application. Using GarconMenuMonitorVTable applications 
-  can register functions to be called when monitoring of a file or
-  directory is needed. They then have to care about monitoring 
-  themselves (see garconmenumonitor.{c,h} for details.
+  Filesystem monitoring is currently not supported but will be part of
+  future releases. Fine-grained change notifications via per-menu and
+  per-item signals are planned.