create a new Offsider called `simon':
-------------------------------

	offsider create simon


set a value for a key ( `said' ). The key is created as neccessary.
-------------------------------

	simon said: Hello World


get the value
-------------------------------

	simon said


create a new method, using a text editor.
-------------------------------

	simon editMethod says

	enter the following code, save and exit:

		#!/bin/sh
		this said: $*
		this said

	NOTES: The default editor is `vi'.  You can get a different editor
		by specifying it like so:  simon editMethod says emacs
		or by setting the $EDITOR environment variable

	       `this', when used inside a method, simply sends its command line
		arguments as a message to the current Offsider.

	       Your method does not have to be a shell script, any language can be used.


use the new method
-------------------------------

	simon says Hello Sailor.

	simon said


what methods and keys does your new offsider have?
-------------------------------

	simon keys
	simon pairs
	simon methods
	simon allMethods | column
	simon asText


create a new Offsider by cloning `simon'
------------------------------

	simon clone mary

	mary says Hello Simon.
	mary said

	simon pairs
	mary pairs


attach child offsiders to an offsider
-----------------------------

	mary addChildDictionary hair

	mary hair colour: brown
	mary hair length: short
	mary hair pairs

	mary addChildDictionary friend simon
	# note, we are saying `mary friend' is a clone of `simon',
	#	not that Simon is Mary's friend!

	mary friend says I am not Simon!

	simon said
	mary said
	mary friend said



That should get you started!  Good luck, and enjoy.

The API documentation is a good place to look further.


cheers, Glen.
glenelgsmith@gmail.com