Processing mode for Emacs.

Written by Rudolf Olah.

Licensed under the GNU GPL version 3 or later.

== About ==

This mode is a derivative of the java-mode. It adds key-bindings for

running/compiling Processing sketches and it also highlights keywords

found in the Processing language, such as ``setup'', ``draw'', and

``frameRate''.

== Setup ==

In your .emacs file, add this:

    (add-to-list 'load-path "/path/to/processing-emacs/")

    (autoload 'processing-mode "processing-mode" "Processing mode" t)

    (add-to-list 'auto-mode-alist '("\\.pde$" . processing-mode))

    (setq processing-location "/path/to/processing")

== Usage ==

The key-bindings are:

    C-c C-b    Preprocess, and compile a sketch into .class files.

    C-c C-r    Preprocess, compile, and run a sketch.

    C-c C-p    Preprocess, compile, and run a sketch full screen.

The mode also includes helpful code snippets. To use them you must

install the YASnippet package found here:

    http://code.google.com/p/yasnippet/

== Bugs ==

* Compilation...there is a bug in the compilation because the

  Commander class of Processing does not accept the ``--preferences''

  option. The workaround is to copy your ``preferences.txt'' from your

  home directory (in Linux it can be found in ``~/.processing/'') to

  the sketch directory. You will have to create a sub-directory called

  ``lib'' in the sketch directory which is where the

  ``preferences.txt'' file will reside. Sym-linking also works.

=== Using Processing Libraries ===

Processing allows developers to extend its functionality with

libraries. These are collections of JAR (Java ARchive) files that can

be included with a sketch.

processing-mode handles the inclusion of libraries by opening up a

file named ``libraries_required.txt'' in the sketch folder. On each

line of that file will be the name of the library's folder.

As an example, let's say we have a sketch that uses the JavaScript

library. To include it with the sketch, our ``libraries_required.txt''

would look like:

    javascript

Just a single line :D processing-mode will do some magic and use the

following path when including the library with the sketch compilation:

    <processing_path>/libraries/javascript/library/

In the ``library'' sub-folder of all libraries there will be a set of

JAR files. They will be added to the classpath when the sketch is

compiled or run.

== Fixed Bugs ==

* Compilation errors...The regular expression used to detect

  compilation error messages does indeed work. Unfortunately there is

  another regular expression that is interfering and being matched

  _before_ it.

  The fix is to shadow the global variable with a local one that

  narrows down the searchable regex list to a single regexp:

  'processing.