This README file describes how to use the current version of the
Palcom Virtual Machine (pal-vm).

*** Usage:

The scripts contained in palcom/developer/bin can be used to launch
the virtual machine, the Smalltalk compiler, and component
manipulation tools.  See doc/Command-line-tools.txt

pal-dev-vm: virtual machine
pal-dev-st: Smalltalk compiler
pal-dev-asm: component assembler
pal-dev-dis: component disassembler
pal-dev-build-base: rebuilds the base Smalltalk library (use after editing
            core Smalltalk classes in palcom/developer/runtime/base.

Eclipse automatically rebuilds the tools when the source files are
edited, hence explicit compilation is only needed when editing
Smalltalk files.

*** Tutorial:

This tutorial shows how to compile and run a few sample Smalltalk
applications from pal-st/src-st/examples

NEW CVS STRUCTURE: The stuff below has not been updated!!!!!

(1) Make a component repository, and cd into it

(2) Compile the hello world program in Examples/Hello:

pal-st -cp ${ECLIPSE_WORKSPACE}/pal-st/src-st/Examples/Hello -o hello.prc -serviceMainClass Hello Hello.som

"-cp": Class path, where to find source files, can take multiple
      directories using the appropriate separation character

"-o": The component file to generate, all the compiled classes are
      stored in this component.  The file name is used as the name of
      the component.

"-serviceMainClass": If the component is used to instantiate a service
      (see below), create an instance of this class and call the "run"
      method to activate the service.

(3) Run the hello world program

pre-vm hello.prc

(4) Compile the extended and highly abused byebye program in
    Example/HelloComponents:

pal-st -cp ${ECLIPSE_WORKSPACE}/pal-st/src-st/Examples/HelloComponents -o byebye.prc -requires "hello:hello.prc" -serviceMainClass ByeBye -import "hello.prc:Hello" ByeBye.som InTheWay.som HelloHello.som

"-requires": Indicate a component which is required by this component,
     meaning that the required component must be loaded before this
     component.  The symbol before ':' indicates the name by which the
     required component is accessible in this component.  The symbol
     after ':' indicates the name of the component which is used when
     loading the component and for managing the component inside the
     service.

"-import": Make the name of a class from a required component visible
     in the scope of this component.  Essentially shortcuts the
     standard scoping mechanism for components, primarily to allow
     inheritance across components (the name of a superclass defined
     in a required component must be importet into this component).

(5) Run the byebye program

pre-vm byebye.prc

Note that this program only can execute when the "hello.prc" component
is either in the same directory or in an explicitly specified
component path provided using "-cp" as an argument to "pre-vm".

