gnue/geas INSTALL Makefile.am NEWS README geas....

[Reinhard Mueller]

CVSROOT:        /cvsroot/gnue
Module name:    gnue
Changes by:     Reinhard Mueller <address@hidden>       01/08/12 13:08:07

Modified files:
        geas           : INSTALL Makefile.am NEWS README geas.spec.in 

Log message:
        Documentation updates

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue/geas/INSTALL.diff?tr1=1.6&tr2=1.7&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue/geas/Makefile.am.diff?tr1=1.11&tr2=1.12&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue/geas/NEWS.diff?tr1=1.6&tr2=1.7&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue/geas/README.diff?tr1=1.10&tr2=1.11&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnue/geas/geas.spec.in.diff?tr1=1.1&tr2=1.2&r1=text&r2=text

Patches:
Index: gnue/geas/INSTALL
diff -u gnue/geas/INSTALL:1.6 gnue/geas/INSTALL:1.7
--- gnue/geas/INSTALL:1.6       Mon Jun 11 15:23:32 2001
+++ gnue/geas/INSTALL   Sun Aug 12 13:08:07 2001
@@ -1,85 +1,22 @@
-Contents
-========
-
-  ORBit Notes
-  Requirements (known dependancies)
-  Compiling
-  Configuring
-  Basic Installation (generic automake instructions)
-
-
-Installation
+Dependencies
 ============
-
-
-ORBit notes:
-------------
-ORBit version 0.5.6 is the latest version available at this time, and is
-believed to be stable. Version 0.5.3 should work, although it had a memory
-leak that would eventually cause a server to crash. (All remaining leaks are
-the fault of someone else, who shall remain nameless to protect the guilty  :)
-
-ORBit-python requires the latest version from their CVS. This should be
-available as a download soon. Version 0.1.3 will not work with ORBit
-versions later than 0.5.3.
-
-GEAS has not been tested with ORBit-mt, or ORBit2, but should work, with
-little or no trouble.
-
-
-Requirements:
--------------
-
-All of:
-    ORBit 0.5.1 or better. (Preferably at least 0.5.6)
-    libuuid (provided by e2fsprogs, requires development files. debian
-        package uuid-dev provides all necessary files.)
-
-For running the Python demo programs:
-    Python 1.5 or better
-    ORBit-python 0.2.0 or better.
-      (A suitable version is in their CVS server on sourceforge. A binary
-      release of version 0.2.0 is expected soon.
-      http://sourceforge.net/cvs/?group_id=3561)
 
-One or more of:
-    MySQL 3.23 or better (earlier versions may not work)
-    PostgreSQL (most recent versions should work)
-
+To run GEAS, you need
+* glib 1.2.0 or newer
+* ORBit 0.5.1 or newer, at least 0.5.6 is recommended
+* one or more of:
+  - MySQL 3.23 or newer (earlier versions may not work)
+  - PostgreSQL (most recent versions should work)
     (Strictly speaking, GEAS only requires the client development files
      for these servers, but a running server must exist at an accessible
-     place on the network when running GEAS.)
-
-Links to required dependancies: (except for libuuid dev files)
-    http://gnue.org/index.cgi/tools
-
-
-Compiling :
------------
-
-in the "geas" directory, run the configure script to configure the compile
-process. You must select at least one database to support.
-
-./configure --help shows all options, but these are some to take note of:
-
-At least one of these must be selected:
---with-mysql        : Select MySQL support.
---with-postgresql   : Select PostgreSQL support.
-
-Type "make" to compile GEAS.
-
-
-Configuring:
-------------
-
-Edit geas.conf to reflect the database you are using. This should be
-reasonably self-explanatory, and all options are commented in the default
-file.
+     place on the network when running GEAS)
 
-The geas.conf from the main directory gets installed. Another copy of geas.conf
-can be found in the src directory. This is used when geas-server is run from
-the source directory for testing purposes.
+To run the Python demo programs, you additionally need
+* Python 1.5 or newer
+* ORBit-python 0.2.0 or newer (http://projects.sault.org/orbit-python)
 
+To compile GEAS, you additionally need
+* libuuid 1.05 or newer (look for a package called ext2fs-dev or uuid-dev)
 
 Basic Installation
 ==================
Index: gnue/geas/Makefile.am
diff -u gnue/geas/Makefile.am:1.11 gnue/geas/Makefile.am:1.12
--- gnue/geas/Makefile.am:1.11  Mon Jun 11 15:23:32 2001
+++ gnue/geas/Makefile.am       Sun Aug 12 13:08:07 2001
@@ -1,8 +1,10 @@
-## $Id: Makefile.am,v 1.11 2001/06/11 22:23:32 reinhard Exp $
+## $Id: Makefile.am,v 1.12 2001/08/12 20:08:07 reinhard Exp $
 
 SUBDIRS = lib src tools examples idl
 
 sysconf_DATA = geas.conf
+
+EXTRA_DIST = FAQ
 
 install-data-local:
        $(mkinstalldirs) $(DESTDIR)$(localstatedir)/run
Index: gnue/geas/NEWS
diff -u gnue/geas/NEWS:1.6 gnue/geas/NEWS:1.7
--- gnue/geas/NEWS:1.6  Wed Jun 20 13:25:16 2001
+++ gnue/geas/NEWS      Sun Aug 12 13:08:07 2001
@@ -2,6 +2,9 @@
 
 o Use better PostgreSQL datatypes
 o New GEAS datatypes int16, int32, int64 and boolean
+o Improved configuration for MySQL
+o Started a FAQ for common problems when configuring, building, installing and
+  running GEAS
 
 New features/changes in version 0.0.5:  (2001-06-13)
 
Index: gnue/geas/README
diff -u gnue/geas/README:1.10 gnue/geas/README:1.11
--- gnue/geas/README:1.10       Thu Jun 21 00:28:25 2001
+++ gnue/geas/README    Sun Aug 12 13:08:07 2001
@@ -4,20 +4,28 @@
 presenting data as objects and business logic as methods to clients written in
 several popular programming languages.
 
-GEAS is actively being developed. Please refer to the file named 'NEWS' to
+GEAS is actively being developed. Please refer to the file named `NEWS' to
 see which version you are looking at here, and what has changed since earlier
 versions.
 
 To install GEAS on your system, follow the procedure described in the file
-'INSTALL'.
+`INSTALL'.
 
-The file 'examples/python/addrbook.py' can be used to test GEAS. Please note
+Use the file `geas.conf' to set the parameters (especially the database to use)
+for GEAS. Use the file `src/geas.conf' if you run GEAS from the source
+directory, and use the file `${prefix}/etc/geas.conf' if you installed GEAS
+with `make install'.
+
+The file `examples/python/addrbook.py' can be used to test GEAS. Please note
 that this program expects geas to be run from the source directory.
+
+If you have problems with configuring, building, installing, or running GEAS,
+the file named `FAQ' could contain a helpful hint.
 
-GEAS is free software. See the file 'COPYING' for the terms and conditions
+GEAS is free software. See the file `COPYING' for the terms and conditions
 for copying, distribution and modification.
 
-The subdirectory 'doc' contains additional information. Since this is a
+The subdirectory `doc' contains additional information. Since this is a
 development release, please don't expect all documentation to be 100% up
 to date.
 
Index: gnue/geas/geas.spec.in
diff -u gnue/geas/geas.spec.in:1.1 gnue/geas/geas.spec.in:1.2
--- gnue/geas/geas.spec.in:1.1  Tue Dec 19 19:08:14 2000
+++ gnue/geas/geas.spec.in      Sun Aug 12 13:08:07 2001
@@ -74,7 +74,7 @@
 %files
 %defattr(-,root,root)
 
-%doc AUTHORS COPYING ChangeLog NEWS README TODO
+%doc AUTHORS COPYING ChangeLog NEWS README TODO FAQ
 
 %{prefix}/bin/geas-server
 %{prefix}/bin/kill-geas-server