Copyright (c)2008 Jonathan Arkell. (by)(nc)(sa)  Some rights reserved.
             2009 Sami Samhuri

Distributed under the terms of the GNU Public License v2, see LICENSE.

Authors: Jonathan Arkell <jonnay@jonnay.net>
         Sami Samhuri <sami.samhuri@gmail.com>


Overview
========
Mojo.el is an Emacs package that provides interactive functions to aid the
development of webOS apps.

Latest version is available on github:
    http://github.com/samsonjs/mojo.el
    
And usually also on Emacs Wiki:
    http://emacswiki.org/emacs/MojoSdk
    http://emacswiki.org/emacs/mojo.el


Installation
============

1. Put json.el and mojo.el somewhere in your load-path.
   (Use M-x show-variable RET load-path to see what your load path is.)

2. Add this to your Emacs init file: (require 'mojo)

3. Make sure you customize the variables:
   mojo-project-directory, mojo-sdk-directory and mojo-build-directory
   (Use M-x customize-group RET mojo RET)

(optional)

4. I recommend that you define a few keyboard shortcuts in your Emacs init
   file. Maybe something like this:

    (global-set-key [f2] mojo-generate-scene)
    (global-set-key [f3] mojo-emulate)
    (global-set-key [f4] mojo-package)
    (global-set-key [f5] mojo-package-install-and-inspect)


Commands
========
The complete command list:

 mojo-generate
   Generate a new Mojo application in the mojo-project-directory.
   
 mojo-generate-scene
   Generate a new Mojo scene for the application found by mojo-root.
   (a.k.a. the current application)

 mojo-emulate
   Launch the palm emulator.

 mojo-package
   Package the specified application (defaults to current app id).

 mojo-install
   Install the specified package (defaults to current app id).
   The emulator needs to be running.

 mojo-list
   List all installed packages.

 mojo-delete
   Remove the specified application. (defaults to current app id)

 mojo-launch
   Launch the specified application in the emulator. (defaults to current app id)

 mojo-close
   Close specified application. (defaults to current app id)

 mojo-inspect
   Run the dom inspector on the specified application. (defaults to current app id)

 mojo-hard-reset
   Perform a hard reset, clearing all data.

 mojo-package-install-and-launch
   Package, install, and launch the current app.

 mojo-package-install-and-inspect
   Package, install, and launch the current app for inspection.

 mojo-target-device
   Set the target device to USB.

 mojo-target-emulator
   Set the target device to the emulator.


Customizations
==============
Customizable options:
 mojo-sdk-directory
   Path to where the mojo SDK is. (default ok for windows and mac os x)
   default = (case system-type
   	        ((windows-nt) "c:/progra~1/palm/sdk")
   	        ((darwin) "/opt/PalmSDK/Current")
   	        (t ""))

 mojo-project-directory
   Directory where all your Mojo projects are located.
   default = ""

 mojo-build-directory
   Directory to store packaged Mojo applications.
   default = ""

 mojo-debug
   Run Mojo in debug mode.  Assumed true while in such an early version.
   default = t