README - Phos 

Copyright 2009,2010,2011,2012 David J. Goehrig <dave@nexttolast.com>
All Rights Reserved

----------------------------------------------------------------------------------------------------
Introduction 

Phos is a javascript library designed to make programming HTML5 canvas applications easier.  Most of
what it does is provide a coherent API for building interactive components.  It provides a unified
widget / drawing / event statemachine which seeks to minimize the overall complexity of the derived
applications.

Phos is also a javascript development environment that allows the programmer to directly manipulate
the contents of live javascript objects.  The basic concept is that each text block can either be
evaluated (by pressing enter) or inspected (by right clicking).  For properties of objects, their
values can be set by changing the contents of the slot and then pressing enter.

Together Phos allows for the development of rich internet applications, in a dynamic and
exploratory fashion.  The user can either extend existing objects, or create new derived objects 
using "classy objects".  Rather than a traditional javascript prototype based inheritance, any object
can act as a "class".  Instances of that "class" are spawned using the "clone()" method.

----------------------------------------------------------------------------------------------------
Getting Started

The easiest way to use Phos is to include in your HTML file:

	<script src="/js"></script>

----------------------------------------------------------------------------------------------------
Contributing

Phos is licensed under the GPL3 license. A copy of the license can be found in
the git repository and is available from the Free Software Foundation at:

	 http://www.gnu.org/copyleft/gpl.html

If you'd like to submit your own fixes, extensions, or features please feel free to send them to:

	dave at nexttolast.com

I'm always happy to incorporate good ideas, especially if they make things simpler, smaller, and
faster.  If you'd like to use Phos in a commercial product, licensing and support
arrangements can also be made to meet your needs.

----------------------------------------------------------------------------------------------------
Keeping Up To Date

The latest and greatest source code is always available for Phos at:

	http://github.com/cthulhuology/Phos/tree/master

In order to obtain the latest version of the source code from git you can use the git command:

	git clone git://github.com/cthulhuology/Phos.git

To stay up to date, you can grab the most current version using the command:

	git pull

----------------------------------------------------------------------------------------------------
End Transmission