Sparklin' new README for the gem

README

@@ -0,0 +1,61 @@
+=
+   ____        _                 ____                              _             
+  |  _ \ _   _| |__  _   _      |  _ \ _ __ ___   ___ ___  ___ ___(_)_ __   __ _ 
+  | |_) | | | | '_ \| | | |_____| |_) | '__/ _ \ / __/ _ \/ __/ __| | '_ \ / _` |
+  |  _ <| |_| | |_) | |_| |_____|  __/| | | (_) | (_|  __/\__ \__ \ | | | | (_| |
+  |_| \_\\__,_|_.__/ \__, |     |_|   |_|  \___/ \___\___||___/___/_|_| |_|\__, |
+                     |___/                                                 |___/ 
+
+
+  Ruby-Processing is a Ruby wrapper for the Processing code art framework. It's
+  this thin little shim that squeezes between Processing and JRuby, passing 
+  along some neat goodies like:
+
+  * Applet and Application exporting of your sketches. Hand them out to 
+    your party guests, ready-to-run.
+
+  * Live Coding via JRuby's IRB. Loads in your sketch so you can futz with 
+    variables and remake methods on the fly.
+
+  * A "Control Panel" library, so that you can easily create sliders, buttons,
+    checkboxes and drop-down menus, and hook them into your sketch's instance 
+    variables.
+
+  * "Watch" mode, where Ruby-Processing keeps an eye on your sketch and reloads 
+    it from scratch every time you make a change. A pretty nice REPL-ish way
+    to work on your Processing sketches.
+
+  If some quality time with Ruby is your idea of a pleasant afternoon, or you
+  harbor ambitions of entering the fast-paced and not altogether cutthroat world 
+  of Code Art, then Ruby-Processing is probably something you should try on for 
+  size. You can grab it as a gem:
+
+  sudo gem install ruby-processing
+
+
+  ~ But Processing? ~
+
+  Processing is an MIT-developed framework for making little code artifacts, 
+  animations, visualizations, and the like, developed originally by Ben Fry
+  and Casey Reas, supported by a small army of open-source contributors. 
+  Processing has become a sort of standard for visually-oriented programming,
+  strongly influencing the designs of Nodebox, Shoes, Arduino, and other kindred
+  projects. For more information, take a look at http://processing.org/
+
+
+  ~ What does it look like? How does it smell? ~
+
+  Processing provides a tidy API, with a bunch of handy methods you can call 
+  from Ruby-Processing. Here's a smattering:
+
+  alpha, arc, background, blend, blue, ellipse, frame_rate, hue, lerp, 
+  load_image, load_pixels, mouse_pressed, noise, rect, saturation, shape, 
+  smooth, text_align, translate, triangle...
+
+  And so on, and so forth. See the full list here: 
+  http://www.processing.org/reference/index_ext.html
+
+  ~ How can I learn more? ~
+
+  For full, up-to-date info, always check the wiki:
+  http://wiki.github.com/jashkenas/ruby-processing

ruby-processing.gemspec

@@ -11,11 +11,11 @@ Gem::Specification.new do |s|
   s.description = "Code as Art, Art as Code. Processing and Ruby are meant for each other."
   s.email = "jeremy@ashkenas.com"
   s.executables = ["rp5"]
-  s.extra_rdoc_files = ["LICENSE", "README.rdoc"]
-  s.files = FileList['bin/**/*', 'lib/**/*', 'library/**/*', 'README.rdoc', 'samples/**/*'].to_a
+  s.extra_rdoc_files = ["README", "CHANGELOG", "LICENSE"]
+  s.files = FileList['bin/**/*', 'lib/**/*', 'library/**/*', 'samples/**/*'].to_a
   s.has_rdoc = true
   s.homepage = "http://github.com/jashkenas/ruby-processing/wikis"
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Ruby-Processing", "--main", "README.rdoc"]
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Ruby-Processing", "--main", "README"]
   s.require_paths = ["lib"]
   s.rubyforge_project = "ruby-processing"
   s.summary = "Code as Art, Art as Code. Processing and Ruby are meant for each other."