README for GLORP

These directories contain auxiliary code for GLORP: Generic Lightweight
Object-Relational Persistence. GLORP is an open source Smalltalk
library for storing and retrieving objects from relational databases. The main
body of the Glorp code is in the $(VISUALWORKS)/glorp directory.
 
For more information, see http://www.glorp.org. There is also a mailing list,
run from http://www.sourceforge.net/projects/glorp

The latest versions of GLORP can also be found in the public store 
repository. See http://www.cincomsmalltalk.com

Included in this directory are

 GenericSessionSwitchMiniTool.pcl/.pst - a prerequisite for GlorpVWLauncherTool
 GlorpUserGuide0.3.pdf - basic user-provided documentation (by Nevin Pratt)
 GlorpActiveRecord.pcl/.pst - A library that implements a simpler to configure descriptor system, using
convention and reading information from the database. The APIs are similar to those in the Ruby on Rails
ActiveRecord implementation, although you still have access to all of the underlying mapping facilities
to permit much more sophisticated mappings.
 GlorpActiveRecordDemo.pcl/.pst - A simple demo of the GlorpActiveRecord code.
 GlorpActiveRecordTests.pcl/.pst - Tests for GlorpActiveRecord.
 GlorpUtilities.pcl/.pst - A utility for writing out GLORP source code
for various dialects.
 GlorpVWGUIExamples.pcl/.pst - A trivial example GUI using Glorp for persistence, illustrating some of the concepts.
 GlorpVWLauncherTool.pcl/.pst - a utility to manage GLORP logins and options.
 GlorpVWPort.pcl/.pst - VisualWorks-specific code, a prerequisite for
the main library.
 ProcediumNamespace.pcl/.pst - Required for GenericSessionSwitchMiniTool
 RBPrerequisiteVWPort.pcl/.pst - Prerequisite for browsing store packages/bundles in the database using the refactoring browser.
 README.TXT - this file
 releasenotes.txt - release notes for this version
 StoreForGlorp.pcl/.pst - A mapping of the Store schema. Note that in the repository, the StoreGlorp bundle contains all of these parcels.
 StoreForGlorpBrowserUI.pcl/.pst - Browsing Store packages from the database in the refactoring browser
 StoreForGlorpExternalReplication.pcl/.pst - Code to help replicating between other version control systems and Store, notably
ENVY/Developer with both VisualAge and older VisualWorks version. Contributed primarily by Niall Ross.
 StoreForGlorpNonVW7RBExtensions.pcl/.pst - Refactoring browser extensions for older versions of VisualWorks.
 StoreForGlorpReplication.pcl/.pst - Base code for synchronizing two store databases.
 StoreForGlorpReplicationTest.pcl/.pst - Tests for replication. Be careful, these do things like destroy databases. There are
some safeguards, but exercise caution anyway.
 StoreForGlorpTests.pcl/.pst - Tests for general StoreForGlorp functionality. The same warnings apply.
 StoreForGlorpVWUI.pcl/.pst - VisualWorks GUI for various facilities, including replication and browsing the database.