

Alberi:  A Graphical User Interface for POSTGRES


The current release is a pre-beta release.  Please report any
bugs/comments/hints/improvements to:

  kochut@cs.uga.edu

Please, remember that this is not a commercial product:

  NO WARRANTIES EXPRESSED OR IMPLIED WHATSOEVER.


Please, read the COPYRIGHT file in this directory.  Also, since some fragments
of the POSTGRES monitor and libpq communication functions have been modified 
and used in Alberi, read also the POSTGRES-COPYRIGHT file in this 
directory.

========================================================================

Alberi is a graphical front-end to the POSTGRES database management
system.  It replaces the usual POSTGRES monitor, performing all of the
functions of the monitor, and many more.  Alberi is an OpenLook-based
GUI interface.  Majority of the POSTQUEL commands can be performed in
a "point-and-click, drag-and-drop" fashion.  POSTQUEL retrieve,
replace, append, and delete commands are constructed by graphically
creating expression trees (Alberi means trees in Italian).  Alberi
provides schema browsing capabilities as well.



Requirements:

Before you can compile the program make sure you have
the following installed on your UNIX system:

POSTGRES  4.1	(should also work with 4.0.1, and
		after introducing a small change with 3.1)
OpenLook  3.0	(should also work with 2.0)
DEVGuide  3.0*
SlingShot 1.0 	(will not work with 2.0!)
		You must get a corrected version from
		athena.cs.uga.edu (same directory as Alberi), file is
		sspkg1.0.tar.Z.  The SlingShot 1.0 package available
		from export.lcs.mit.edu (and suggested here in
		previous releases of Alberi) contains a bug in
		tree drawing routines and fails in certain 
		situations when used with Alberi.


*) As long as you do not intend to modify screens, you do not
   need DEVGuide.  WARNING: do not run 'make very-clean' in the src 
   directory, since it will erase C source files generated by
   DevGuide's gxv precompiler.



Installation:

0. Make sure you have installed SlingShot 1.0.
   cd to the alberi/src directory

1. Edit the provided Makefile and update various variables defining
   placement of required software packages.
   If you intend to use DevGuide, make sure that you have the
   environment variable GUIDEHOME defined and pointing to your DevGuide 
   place.

2. Run 'make'.

   This should not produce any errors and/or warnings.  Presence of
   any warnings (not to mention errors) may cause various failures.


Please, send me a note if you installed Alberi.  I will also
appreciate your comments, hints, and suggestions for improvements.



It is advisable that you set your Text.MaxDocumentSize resource to a
large value, something like:

	Text.MaxDocumentSize:   350000

(in your .Xdefaults file) in order to freely process many queries.


===========================================================================

Ruben Robles' thesis can be obtained through an inter-library loan from:

   University of Georgia Libraries
   University of Georgia
   Athens, GA

Title:  Alberi:  A Graphical User Interface for an Advanced 
        Database Management System POSTGRES
Author: Ruben Robles
Year:   1992

===========================================================================

You are free to modify the code with the condition of keeping
the short message included at the beginning of every alberi source file
intact.  If you have any problems, you can contact me at:

    kochut@cs.uga.edu

Please remember, this is not a commercial product:

    NO WARRANTIES EXPRESSED OR IMPLIED WHATSOEVER!

===========================================================================

You may also contact Ruben Robles at rubenr3@aol.com or
rubenr3@psi.com@aol.com.
If you have time you can drop Ruben a postcard (he collects them):

  Ruben Robles
  234 Randolph Drive 207-D
  Madison, WI 53717

===========================================================================
