VERSION

  This is version 1.10 of the mySTEP libraries.
  
  The code is based on mGstep-0.536. Many thanks to Felipe A. Rodriguez for providing the source codes!!!
  
  I (Nikolaus Schaller <hns@computer.org>) have modified the sources as
  described in the file HISTORY.rtf
	
SUPPORTED PLATFORMS

  Currently, this package has been built on ARM-Linux for the Sharp Zaurus 5500G PDA.

HOW TO BUILD

  This package builds within it's own hierarchy.  You may need to edit the 
  platform makefile in Makefiles/config to reflect your particular system.

  At the top of the source tree (this directory) enter:

    make  --  interactive prompt of the available Makefile configurations.
              Select the appropriate supported configuration.

  Now build the libraries:

    make all

  If you are building on Linux where shared libraries are the default you
  will need to install the libraries before running the tests.  See the
  section below titled 'INSTALLATION' for details.

  Set the MGSTEP_ROOT environment variable:

    export MGSTEP_ROOT=/<<Absolute path to the top of the mGSTEP source tree >>

  Build and run the Foundation tests:

    cd Foundation/Testing
    make all
    make run

  Build and run the AppKit examples:

    cd AppKit/Testing
    make all
    ./run <<name of a test app>>.app  (eg. "./run Workspace.app")

  Build and run the Distributed Objects (DO) tests (Linux only):

    cd Foundation/DO
    make
       << if not already defined add: "gdomap	538/tcp" to /etc/services >>
    gdomap   
    server &
    client

  Configuring the example service (Linux only, requires DO):

    cp AppKit/Testing/Resources/.mGSTEPServices  << your home/.mGSTEP dir >>

    You will need to edit the 'ServicePath' entries to reflect the location
    of the AppKit/Testing 'example.service'.  When you next run Edit.app the 
    example service will be accessible via Edit's 'services' menu.

  Build on MacOS X and test/run on Sharp Zaurus (needs Apple X11 and MacOS X cross compiler):
  
  Open the mySTEP.xcode project and build.
	
INSTALLATION

  mySTEP can be installed anywhere.  The key is to define the 'MGSTEP_ROOT'
  environment variable so that it points to the top of the mGSTEP source 
  tree.  You may want to edit the top makefile in this directory to specify 
  an install path for the libraries other than the default '/usr/local/lib'.  
  Installation is then:

    make install


LICENSE

   The mySTEP library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.
   
   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with this library; see the file COPYING.LIB.
   If not, write to the Free Software Foundation,
   59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

   Various files in mGSTEP/Foundation are derived from libFoundation
   and in deference to it's authors these files retain a BSD type 
   license as follows:

     Copyright (C) 1995, 1996 Ovidiu Predescu and Mircea Oancea.
     All rights reserved.

     Permission to use, copy, modify, and distribute this software and
     its documentation for any purpose and without fee is hereby granted,
     provided that the above copyright notice appear in all copies and 
     that both that copyright notice and this permission notice appear
     in supporting documentation.

     We disclaim all warranties with regard to this software, including all
     implied warranties of merchantability and fitness, in no event shall
     we be liable for any special, indirect or consequential damages or any
     damages whatsoever resulting from loss of use, data or profits, whether
     in an action of contract, negligence or other tortious action, arising
     out of or in connection with the use or performance of this software.



Felipe A. Rodriguez
far@pcmagic.net
Agoura Hills, CA
###############################################################################