[rep-gtk] DOCS



commit 70ba20f47ef3ce464949eae288f243fe6c5e6811
Author: Christopher Roy Bratusek <zanghar freenet de>
Date:   Sat Sep 11 06:33:41 2010 +0200

    DOCS

 BUGS            |    3 --
 ChangeLog       |   10 ++++++
 HACKING         |    5 ---
 MAINTAINERS     |    7 ----
 README          |   96 +++++++++++++++----------------------------------------
 README-GTK-2    |   10 ------
 README.gtk-defs |    5 ---
 7 files changed, 36 insertions(+), 100 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 27571c4..2d0d7a8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2010-08-28  Teika Kazura <teika lavabit com>
+	* BUGS
+	* HACKING
+	* MAINTAINERS
+	* README
+	* README-GTK-2
+	* README.gtk-defs: Doc update. Deleted obsolete references to
+	gnome and guile. Files 'BUGS', 'HACKING' and 'MAINTAINERS' are
+	merged to 'README'. File 'README-GTK-2' is deleted.
+
 2010-08-22  Christopher Bratusek <zanghar freenet de>
 	* gtk.defs:
 	*************** gtkwidget.h *******************
diff --git a/README b/README
index 3316db9..ab28ffa 100644
--- a/README
+++ b/README
@@ -1,29 +1,28 @@
 -*- text -*-
 
-This is rep-gtk 0.18.2, a binding of GTK+/GNOME/libglade for the rep Lisp
-system. It is based on Marius Vollmer's guile-gtk binding (initially
-version 0.15, updated to 0.17), with a new glue-code generator.
+This is rep-gtk, a binding of GTK+ for the librep Lisp system. It is
+based on Marius Vollmer's guile-gtk binding (initially version 0.15,
+updated to 0.17), with a new glue-code generator.
 
 For more details see:
 
-	http://rep-gtk.sourceforge.net/
-
-Browse the SVN tree at:
-
-	http://svn.gnome.org/viewvc/rep-gtk/
+	http://sawfish.wikia.com
 
 Installation
 ============
 
 Basically, `./configure ; make ; make install'. If you're building from
-the SVN repository, use ./autogen.sh instead of ./configure.
+the git repository, use ./autogen.sh instead of ./configure.
 
 It requires Gtk+ version 2.
 
-WARNING: The GNOME bindings are currently untested and
-probably broken since the port to Gtk2, use at your own risk.
+Feedbacks
+=========
+Please report Bugs and all patches to the mailing list
+<sawfish-list gnome org>.
 
-The libglade binding is definitively broken
+When possible, please make patches in unified diff format 
+(i.e. 'diff -u' or use 'git diff').
 
 Usage
 =====
@@ -33,65 +32,10 @@ functions as in guile-gtk. The only difference is that Lisp conventions
 are used for booleans, i.e. nil for #f, and non-nil for #t.
 
 See the included *.defs files for the details of how the library maps
-to lisp functions.
-
-
-libglade
-========
-
-From the libglade README file:
-
-    This library allows you to load glade interface files in a program
-    at runtime. It doesn't require GLADE to be used, but GLADE is by
-    far the easiest way to create the interface files.
-
-So you can now use GLADE with rep! Here's an example from the
-examples/test-libglade script:
-
-    (require 'gui.gtk-2.libglade)
-
-    (let ((xml (or (glade-xml-new (car command-line-args))
-		   (error "something bad happened"))))
-      (glade-xml-signal-autoconnect xml)
-      (gtk-main))
-
-The glade-xml-new function takes a filename, and creates a widget
-hierarchy. glade-xml-signal-autoconnect connects all signal handlers to
-the lisp functions named in the GLADE file. You can also use the
-glade-xml-signal-connect function to connect individually named
-handlers. (see libglade.defs for the complete function list)
-
-
-GNOME
-=====
-
-There's also now reasonably complete bindings of gnome and gnomeui.
-These extra modules will get built and installed:
-
-	gui.gtk-2.gnome-lib	Non-UI GNOME functions, doesn't require GTK
-	gui.gtk-2.gnome-ui	GNOME UI widgets and utilities
-	gui.gtk-2.gnome-canvas	GNOME Canvas widgets and utilities
-
-see the .defs files for the gruesome details about what goes in what.
-The dependence tree is something like:
-
-	types -+- gtk -+- libglade
-		     \  \
-		      \   gnome-ui -+- gnome-canvas
-		       \
-			 gnome-lib
-
-gui.gtk-2.types provides conversions for the basic C types (and GLIB's
-GList and GSList types).
-
-When `gui.gtk-2.gnome-ui' is loaded the gnome-init function is called
-automatically. If the special variables `*gnome-app-id*' and
-`*gnome-app-version*' are bound to strings, then these values will be
-used, otherwise something will be fabricated.
-
-However, if using `gui.gtk-2.gnome-lib' without `gui.gtk-2.gnome-ui',
-you should call `gnomelib-init' manually.
+to lisp functions. See also examples.
 
+*** Don't test it from sawfish-client, but use the bare rep. Otherwise,
+Sawfish will crash. ***
 
 Caveats
 =======
@@ -99,3 +43,15 @@ Caveats
 It's still too easy to crash the Lisp interpreter through invalid use
 of GTK..
 
+Copyright
+=========
+
+Rep-gtk is released under GPLv2.
+
+Maintainer
+==========
+
+Rep-gtk was originally written by John Harper. The current maintainer
+is Christopher Bratusek.
+E-mail: zanghar freenet de
+Userid: chrisb
diff --git a/README.gtk-defs b/README.gtk-defs
index bd916d2..4506223 100644
--- a/README.gtk-defs
+++ b/README.gtk-defs
@@ -87,11 +87,6 @@ GTK fundamental types seem to include:
 	string, enum, flags, boxed, foreign, callback, args, pointer,
 	signal, c-callback, object
 
-The guile-gtk .defs files seem to add the following:
-
-	static_string, full_callback, file-descriptor, list, slist,
-	double, SCM, cvec, cvecr, fvec, ret, tvec
-
 static_string:
   a static string returned from a function
 



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]