formtastic 1.2.5 → 2.0.0.rc1

data/.gitignore

@@ -0,0 +1,13 @@
+.DS_Store
+.rvmrc
+coverage
+coverage.data
+pkg
+*~
+*watchr.rb
+log/*
+.rvmrc
+.bundle
+Gemfile.lock
+.yardoc
+doc/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=progress

data/.yardopts

@@ -0,0 +1 @@
+--no-private --title "Formtastic Documentation" --markup markdown --quiet

data/CHANGELOG

@@ -0,0 +1,279 @@
+2.0.0.rc1
+
+* Removed the "inline_order" configuration (redefine input_wrapping instead)
+* Removed the "special" implementation of label() from FormBuilder, so builder.label will call Rails' label helper, not ours
+* Changed the HTML id attribute used for hidden inputs to be consistent with all other inputs
+* Changed formtastic:form generator include the wrapping semantic_form_for block
+* Changed formtastic:form generator to generate a partial by default (instead of copying to clipboard, which can be done with --copy)
+* Removed formtastic_stylesheet_link_tag
+* Improved some documentation, much more to come
+* Tagged many modules as @private to remove from YARD documentation
+* Added YARD as development dependency for a massive documentation effort
+* Renamed Formtastic::SemanticFormHelper to Formtastic::Helpers::FormHelper (SemanticFormHelper still exists as a module which includes the new module, need to handle deprecation notices somehow)
+* Renamed Formtastic::SemanticFormBuilder to Formtastic::FormBuilder (SemanticFormBuilder still exists as a subclass, need to handle deprecation notices somehow)
+* Massive refactoring of formtastic.rb into around 30 files and modules like StringInput and ButtonsHelper
+* Removed chunks of Rails 2 specific code, tests and documentation
+* Added support for HTML5 required attribute on input, select and textarea tags
+* Added support for HTML5 min/max/step attributes on NumericInput
+* Added support for HTML5 placeholder attributes on Stringish inputs (string, email, phone, url, search, number, password)
+* Added support for HTML5 autofocus attributes
+* Changed nested inputs() blocks to be automatically wrapped in an `<li>` tag to preserve HTML validity
+* Changed quick forms to skip polymorphic associations (they didn't work)
+* Changed short hand forms to raise an error when trying to render an input for a polymorphic association (it didn't work, need a collection)
+* Changed input() to raise an error when a :collection is not provided for a polymorphic association (we can't guess which class to use)
+* Removed semantic_remote_form_for etc, the remote_form_for helpers don't exist in Rails 3
+* Changed :label_method option to :member_label (with backwards compat and deprecation warnings)
+* Changed :value_method option to :member_value (with backwards compat and deprecation warnings)
+* Changed :grouped_label_method option to :grouped_label (with backwards compat and deprecation warnings)
+* Added support for a Method objects to :member_label/:member_value (aka :label_method/:value_method)
+* Improved support for Mongoid 
+* Changed Rails dependency from ~> 3.0.0 to ~> 3.0 to allow experimentation with Rails 3.1 betas
+* Removed some overly eager CSS resets on form elements that made Opera and FF inputs look pretty ugly
+* Removed specificity and duplication in CSS
+* Added many new classes to DOM elements to enable more efficient and descriptive CSS
+* Improved visual/spacing consistency in checkboxes
+* Added non-standard zoom:1; to clearfixes to support IE better
+* Changed CSS coding style to multi-line so we can annotate the styles better
+* Fixed that overly specific CSS rules weren't applied to nested form elements properly
+* Removed formtastic:form generator and changed formtastic:install generator
+to override scaffold generator
+* Refactored and consolidated CSS by adding extra class names into the mark-up, preferring to style by class instead of element wherever possible
+* Added IE6 and IE7 stylesheets for specific fixes if needed (uncomplicates formtastic.css)
+* Added support for Rails 3.1 asset pipeline as well as previous generated CSS for Rails < 3.1
+* Made many subtle visual improvements to CSS, especially in IE
+
+1.2.4
+
+* no changes
+
+1.2.4.beta2
+
+* Changed :boolean inputs to use Rails' check_box_checked? instead of our own logic
+* Changed developer instructions in README
+* Fixed :boolean inputs to disable the included hidden input when disabling the actual checkbox
+* Fixed that Formtastic was making changes to the options hash directly instead of on a duplicate, causing problems for those trying to reuse options on multiple inputs in the view 
+* Fixed that tiny scroll bars were appearing on legends in date/time/radio/cbheckboxes fielsets (GH-477)    
+* Fixed an issue when formtastic fails to determine if a checkbox is checked with custom checked and unchecked values (thanks to Eugene Bolshakov)
+* Fixed that the hidden input rendered with a boolean checkbox did nt use the custom :name from :input_html options hash
+* Fixed issue where Firefox 4 gives focus to the <li> wrapper (fixes #524).
+* Fixed that a shared input options hash could not be re-used in the view without being altered by each input
+* Improved compatibility with Mongoid Documents
+* Updated i18n dependency to ~> 0.4
+
+1.2.4.beta
+
+* Changed :boolean inputs to use Rails' check_box_checked? instead of our own logic
+* Changed developer instructions in README
+* Fixed :boolean inputs to disable the included hidden input when disabling the actual checkbox
+* Fixed that Formtastic was making changes to the options hash directly instead of on a duplicate, causing problems for those trying to reuse options on multiple inputs in the view
+* Fixed that tiny scroll bars were appearing on legends in date/time/radio/cbheckboxes fielsets (GH-477)
+* Fixed an issue when formtastic fails to determine if a checkbox is checked with custom checked and unchecked values (thanks to Eugene Bolshakov)
+* Fixed that the hidden input rendered with a boolean checkbox did nt use the custom :name from :input_html options hash
+
+1.2.3
+
+* Removed deprecated methods input_field_set, button_field_set, boolean_select_input, boolean_radio_input and boolean_radio_input
+* Removed deprecated :class option on commit_button (use :input_html instead)
+* Fixed that stylesheets and initializers directories would be removed on uninstalling
+* Fixed some documentation and formatting
+* Fixed test coverage issues under Ruby 192 and Rails 2
+* Fixed that input_html options were not being passed down to checkbox tags
+* Changed internal duplication of the options hash so that the same options hash can be re-used over multiple inputs without being altered
+* Changed internal configuration to use class_attribute when available (Rails 3) to avoid deprecation warnings
+* Added Rails 3 compatible form generator templates in addition to existing Rails 2 support
+* Added reflection on allow_blank option when determining the 'required' status of an input
+
+
+1.2.2
+
+* Removed deprecated aliased input names (:as => :boolean_select, :as => :boolean_radio_input
+* Removed deprecated aliased method names (input_field_set, button_field_set)
+* Removed deprecated :class => 'whatever' on commit_button
+* Fixed that classes in :button_html were being merged into :wrapper_html
+* Fixed that :include_blank was being ignored (always false) for multi selects
+* Fixed that we should reflect on allow_blank option to determine required status with validates_inclusion_of
+* Added the ability to pass :input_html options be passed to the checkbox on a boolean input
+* Developers: Added bundler support to for developer/contribution
+* Developers: Fixed spec coverage under Rails 2 and Ruby 1.9.2
+
+1.2.1
+
+* test suite compatibilities with Rails 3.0.3
+
+1.2.1.beta3
+
+* Fixed bad merge related to :boolean inputs in 1.2.1.beta
+
+1.2.1.beta2
+
+* Fixed typos in gemspec post-install message
+
+1.2.1.beta
+
+* Fixed that unchecking :boolean inputs would not send the correct params (and not persist the change the the DB)
+* Fixed that :boolean inputs checked state was not reflecting the database/model value
+* Fixed that init.rb and rails/init.rb were not included in the gem (affecting Rails 2)
+
+1.2.0
+
+* Changed default_text_area_width to nil, overlooked in recent CSS/width changes
+* Improved documentation
+
+1.2.0.beta2
+
+* Added :wrapper_html functionality to commit_button() to match what input() does
+* Deprecated the :class option on commit_button(), use :wrapper_html instead
+* Added hpricot as missing development dependency
+* Improved documentation
+
+1.2.0.beta
+
+* New Stuff
+
+  * Added support for Paperclip's questionable use of multiple error keys on a single attribute, so errors on Paperclip :file inputs Just Work
+  * Added ability for the error and hint class to be overridden with :hint_class and :error_class, and configurable defaults app-wide
+  * Added basic support for multiple forms in the same document by allowing the element ids to be prefixed with the :namespace option on semantic_form_for
+  * Added a fallback to Rails' helpers.label key if Formtastic label translation are not found
+  * Added support for default_text_area_width
+  * Added support for #persisted? over #new_record? (ActiveModel)
+  * Added the 'required' logic to attributes with validates_inclusion_of validation, in addition to validates_presence_of
+  * Added new HTML5 :as => :email input (Rails 3)
+  * Added new HTML5 :as => :phone input (Rails 3)
+  * Added new HTML5 :as => :search input (Rails 3)
+  * Added new HTML5 :as => :url input (Rails 3)
+  * Added the ability for the :collection option to accept a string of HTML (like the output from grouped_options_for_select), rather than just Arrays, Hashes, collections, etc.
+  * Added the ability to set your own form class, instead of 'formtastic'
+  * Added maxlength attributes to inputs if it can be determined via the ValidationReflection plugin or ActiveModel validation reflections
+  * Added the ability to override the form class (Post => "post") through an :as option on semantic_form_for option
+  * Added the ability to customize the order for specific types of inputs. This is configured on a type basis and if a type is not found it willfall back to the default order as defined by @@inline_order
+  * Added :first as a new rendering choice for the errors on each input
+  * Added custom_inline_order to allow inline ordering per input type
+  * Added the ability to override the generator templates in Rails 3
+
+* Fixes
+
+  * Fixed invalid HTML generated by Rails' hidden inputs on checkboxes (by rendering our own hidden tag in a more deliberate place)
+  * Fixed a bunch of invalid i18n key defaults
+  * Fixed that 'required' classes and logic were not being applied to :check_boxes and :radio inputs
+  * Fixed CSS bugs around Firefox's quirks with form elements that resulted in overflow/scroll bar issues
+  * Fixed that errors on fields with association were not marking the wrapping tag with the error class
+  * Fixed CSS where FF was displaying extra scroll bars on .check_boxes and .radio inputs (and the choices within them)
+
+* Changes
+
+  * Changed that we were defaulting to a :select input for columns ending in _id, instead of columns with an appropriate associations
+  * Deprecated a bunch of aliased method names that should no longer be used
+  * Removed deprecated :selected, :checked and :default options
+  * Changed the width styling for string, numeric, password and other basic inputs, defaults to 75% unless the size attribute is present
+  * Changed string, numeric, password and other basic inputs' default text field size config to nil instead of 50, meaning the size attribute will be ommitted from most inputs, makeing styling easier, and custom sizes with the size attribute more deliberate
+  * Changed string, numeric, password and other basic inputs to no longer add the size attribute based on column information (the default config is applied, unless it's nil)
+  * Changed text input css behaviour updated to be similar to string etc
+  * Changed text inputs to no longer include a default cols attribute, specify it with :input_html if you need it, but the value we were using was useless... also beefed up spec coverage
+  * Removed :label calls from the generated ERB in the form generator (i18n is preferred)
+  * Changed that :select inputs for HABTM associations would ignore the :include_blank option
+  * Changed the default method on collections from Model.find(:all) to Model.all
+  * Removed the deprecated formtastic_stylesheets generator
+  * Changed the minimum Rails version to 2.3.7, which the earliest version which the specs pass with
+  * Changed :password inputs to be sized by percentage (like other string-ish inputs), rather then em-based
+
+1.1.0
+
+* documentation changes only
+
+1.1.0.beta [Specs passed against Rails 2.3.8, 3.0.0.rc & 3.0.0]
+
+* Changed semantic_remote_form_for to allow for unobstrusive javascript / :remote option (rails3)
+* Changed spec_helper to support Rails 2 with RSpec or Rails 3 with RSpec 2 environments
+* Changed Rakefile to initalize the correct testing framework for the enviroment
+* Changed i18n dependency to >= 0.4
+* Fixed use of model_name.human instead of model_name.human_name (rails3)
+* Fixed use of deprecated Errors#on_base
+* Fixed use of ActionController::RecordIdentifier#singular_class_name (rails3)
+* Added railtie to perform initialization tasks after the rails framework is available (rails3)
+* Added compatible install and form helpers (rails3)
+* Added support for ActiveModel Validations, thanks to Guillaume Belleguic (rails3)
+
+1.0.1
+
+* fixed "already initialised constant" warnings on boot
+
+1.0.0
+
+* nothing changed from rc2
+
+1.0.0.rc2
+
+* Fixed that :label=>false didn't disable the label on checkboxes/radiobuttons (#331)
+* Added full support of :input_html options for hidden fields
+
+1.0.0.rc
+
+* Fixed that :checked_value and :unchecked_value options were being passed down into the HTML tags as attributes
+
+1.0.0.beta4
+
+* ensure i18n < 0.4 is listed as a dependency in the gemspec
+
+1.0.0.beta3
+
+* Added :ignore_date option to time inputs (#308)
+* Fixed inputs_for_nested_attributes returning out of the proc on has_many associated nested models.
+* Fixed with_custom_field_error_proc to use ensure for restoring default field_error_proc and to store it in a local variable instead of in a class variable (nested calls were problematic due to the globalness of class variables)
+
+1.0.0.beta2
+
+* Added default escaping of html entities in labels and hints (#292, #299)
+* Added/Fixed that :value_method and :label_method were not being used for simple collections (like Arrays)
+* Added some more compatibility for Mongooid and other ORMs by checking for reflection information before calling it
+* Fixed deprecation warnings in Rails 2.3.6 and newer
+* Fixed a bug where :check_boxes and :radio were using method instead of :label option
+* Fixed a conflict where i18n lookups were failing when an attribute and model have the same name
+* Fixed some html that was not marked as safe
+
+1.0.0.beta
+
+* Fixed :radio and :check_boxes inputs so that the legend no longer includes a <label> with a `for` attribute pointing to an input that doesn't exist (#253)
+* Fixed that some inputs had invalid 'find_options' attribute (#262)
+* Fixed that we were calling html_safe! when it was not always available
+* Added the ability for :input_html to now accept an option of :size => nil, to exclude the :size attribute altogether (#267)
+
+0.9.10
+
+* Fixed i18n incompatibility with Rails 2.3.8 by reverting two i18n patches pulled in from the rails3 branch
+
+0.9.9
+
+* Changed date/time inputs to default to nil instead of Time.now when the object has no value (due to deprecation warning, #240)
+* Changed the behaviour of associations with a :class_name option to be more consistent with what Rails expects
+* Fixed issues relating to Rails 2.3.6 automatically escaping ERB
+* Fixed issues with Ruby 1.9.1 and Haml
+* Fixed use of deprecated {{key}} syntax in i18n interpolation (thanks to Hans Petter Wilhelmsen)
+* Added the :disabled option to check_boxes input
+* Added translation support for nested models (thanks to Toni Tuominen)
+
+0.9.8
+
+* Deprecated :selected/:checked options, see http://wiki.github.com/justinfrench/formtastic/deprecation-of-selected-option
+* Changed CSS rules for fieldset lists to be more specific
+* Changed that radio and checkbox inputs used to associate the legend label with the first choice's input (#101)
+* Changed the generators to use |f| rather than |form| (#151)
+* Changed the behaviour of :selected/:checked options to address several bugs and inconsistencies (#152)
+* Changed CSS for input width property to max-width, allowing a size attribute to still be set
+* Fixed an issue where label_str_method not honoured if the object is an ActiveRecord object
+* Fixed incorrect html class for namespaced objects ("/" replaced with "_")
+* Fixed compatibility issue with SearchLogic (#155)
+* Fixed an issue where label_str_method was not being overridden with i18n
+* Fixed a button text issue with Rails 2.x in which human_name on multi-word models returned one word (eg Ticketrequest) (#153)
+* Fixed the behaviour of select inputs when the belongs_to or has_many association has a special :class_name option
+* Fixed line numbers from eval'd code, to help when debugging
+* Fixed CSS issue that hidden fields were not always hidden (Chrome for example) (#209)
+* Fixed and improved CSS with nested fieldsets and legends
+* Fixed date/time inputs where :include_seconds => true
+* Fixed that inline hints were still being rendered on hidden inputs
+* Fixed broken CSS declaration missing a colon
+* Added configuration preferences for row and column attributes on textareas
+* Added semantic_errors helper and CSS (for all errors on an object)
+* Added :filename to the list of @@file_methods, to support carrierwave plugin (#156)
+* Added a Formtastic::LayoutHelper with formtastic_stylesheets helper method for linking to all Formtastic CSS files
+* Added labels option to date/time/datetime fields to customise the label of each part of the set (year, month, etc)
+* Added many improvements to the README and docs

data/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gemspec

data/README.textile

@@ -4,14 +4,23 @@ Formtastic is a Rails FormBuilder DSL (with some other goodies) to make it far e
 
 <a href='http://www.pledgie.com/campaigns/2178'><img alt='Click here to lend your support to: formtastic and make a donation at www.pledgie.com !' src='http://pledgie.com/campaigns/2178.png?skin_name=chrome' border='0' /></a>
 
+
+h2. Compatibility
+
+* Formtastic 1.x is compatible with both Rails 2 and 3, and is being maintained for bug fixes in the the "1.2-stable branch":https://github.com/justinfrench/formtastic/tree/1.2-stable.
+* Formtastic 2.0 will be Rails 3.x compatible only
+* If you're bundling Formtastic from edge/master, get ready for a bumpy ride. Try the "1.2-stable branch":https://github.com/justinfrench/formtastic/tree/1.2-stable.
+* Formtastic, much like Rails, is very ActiveRecord-centric. Many are successfully using other ActiveModel-like ORMs and objects (DataMapper, MongoMapper, Mongoid, Authlogic, Devise...) but we're not guaranteeing full compatibility at this stage. Patches are welcome!
+ 
+
 h2. The Story
 
 One day, I finally had enough, so I opened up my text editor, and wrote a DSL for how I'd like to author forms:
 
 <pre>
-  <% semantic_form_for @article do |form| %>
+  <%= semantic_form_for @article do |form| %>
 
-    <% form.inputs :name => "Basic" do %>
+    <%= form.inputs :name => "Basic" do %>
       <%= form.input :title %>
       <%= form.input :body %>
       <%= form.input :section %>
@@ -20,19 +29,19 @@ One day, I finally had enough, so I opened up my text editor, and wrote a DSL fo
       <%= form.input :allow_comments, :label => "Allow commenting on this article" %>
     <% end %>
 
-    <% form.inputs :name => "Advanced" do %>
+    <%= form.inputs :name => "Advanced" do %>
       <%= form.input :keywords, :required => false, :hint => "Example: ruby, rails, forms" %>
       <%= form.input :extract, :required => false %>
       <%= form.input :description, :required => false %>
       <%= form.input :url_title, :required => false %>
     <% end %>
 
-    <% form.inputs :name => "Author", :for => :author do |author_form| %>
+    <%= form.inputs :name => "Author", :for => :author do |author_form| %>
       <%= author_form.input :first_name %>
       <%= author_form.input :last_name %>
     <% end %>
 
-    <% form.buttons do %>
+    <%= form.buttons do %>
       <%= form.commit_button %>
     <% end %>
 
@@ -46,7 +55,7 @@ h2. It's better than _SomeOtherFormBuilder_ because...
 
 * it can handle @belongs_to@ associations (like Post belongs_to :author), rendering a select or set of radio inputs with choices from the parent model.
 * it can handle @has_many@ and @has_and_belongs_to_many@ associations (like: Post has_many :tags), rendering a multi-select with choices from the child models.
-* it's Rails 2.x and 3.x compatible (including nested forms).
+* it's Rails 3 compatible (including nested forms).
 * it has internationalization (I18n)!
 * it's _really_ quick to get started with a basic form in place (4 lines), then go back to add in more detail if you need it.
 * there's heaps of elements, id and class attributes for you to hook in your CSS and JS.
@@ -54,6 +63,7 @@ h2. It's better than _SomeOtherFormBuilder_ because...
 * it doesn't hijack or change any of the standard Rails form inputs, so you can still use them as expected (even mix and match).
 * it's got absolutely awesome spec coverage.
 * there's a bunch of people using and working on it (it's not just one developer building half a solution).
+* it has growing HTML5 support (new inputs like email/phone/search, new attributes like required/min/max/step/placeholder)
 
 
 h2. Why?
@@ -81,63 +91,65 @@ RDoc documentation _should_ be automatically generated after each commit and mad
 
 h2. Installation
 
-Formtastic is now compatible with both Rails 2 and Rails 3, and the gem is "hosted":http://rubygems.org/gems/formtastic on RubyGems.org.
+Simply add Formtastic to your Gemfile and bundle it up:
 
-*You'll need to use Bundler (yes, even under Rails 2, due to the many ways gem dependencies suck). Follow "this tutorial":http://gembundler.com/rails23.html.*
+<pre>
+  gem 'formtastic', '~> 1.2.3'
+</pre>
 
-Simply add Formtastic to your Gemfile and bundle it up:
+If you want to try out our work towards Formtastic 2.0 (Rails >= 3 only), bundle in Formtastic directly from Github with the @:git@ option instead:
 
 <pre>
-  gem 'formtastic', '~> 1.2.5'
+  gem 'formtastic', :git => 'http://github.com/justinfrench/formtastic', :branch => 'master'
 </pre>
 
-Optionally, run the generator to copy some stylesheets and a configuration initializer into your application:
+Optionally, run the generator to copy a stylesheet (Rails 3.0.x only) and a configuration initializer into your application:
 
 <pre>
-  # Rails 3:
   $ rails generate formtastic:install 
-  
-  # Or Rails 2:
-  $ ./script/generate formtastic 
 </pre>
 
 
 h2. Stylesheets
 
-A proof-of-concept stylesheet is provided which you can include in your layout. Customization is best achieved by overriding these styles in an additional stylesheet so that the Formtastic styles can be updated without clobbering your changes. If you want to use these stylesheets, add both to your layout with this helper:
+A proof-of-concept set of stylesheets are provided which you can include in your layout. Customization is best achieved by overriding these styles in an additional stylesheet.
+
+h3. Stylesheet usage in Rails < 3.1:
 
 <pre>
-  <head>
-    ...
-    <%= formtastic_stylesheet_link_tag %>
-    ...
-  </head>
+  $ rails generate formtastic:install 
 </pre>
 
+<pre>
+  # app/views/layouts/application.html.erb
+  <%= stylesheet_link_tag 'formtastic', 'my_formtastic_changes' %>
+  <!--[if IE 6]><%= stylesheet_link_tag 'formtastic_ie6' %><![endif]-->
+  <!--[if IE 7]><%= stylesheet_link_tag 'formtastic_ie7' %><![endif]-->
+</pre>
 
-h2. Syntax
-
-*Please note:* Formtastic makes use of a lot of ERB blocks and currently supports both Rails 2 and Rails 3, which means the syntax in these examples will differ depending on which version of Rails you're using.
+h3. Stylesheet usage in Rails >= 3.1:
 
-The difference is subtle, with most blocks in Rails 3 requiring the addition of an equals sign:
+Rails 3.1 introduces an asset pipeline that allows plugins like Formtastic to serve their own Stylesheets, Javascripts, etc without having to run generators that copy them accross to the host application. Formtastic makes three stylesheets available as an Engine, you just need to require them in your global stylesheets.
 
 <pre>
-  <!-- Rails 2 -->
-  <% semantic_form_for @user do |form| %>
-    <% form.inputs do %>
-      ...
-    <% end %>
-  <% end %>
+  # app/assets/stylesheets/application.css
+  *= require formtastic
+  *= require my_formtastic_changes
   
-  <!-- Rails 3 -->
-  <%= semantic_form_for @user do |form| %>
-    <%= form.inputs do %>
-      ...
-    <% end %>
-  <% end %>
-</pre>
+  # app/assets/stylesheets/ie6.css
+  *= require formtastic_ie6
   
-This README is currently documenting the Rails 2 way only. If you're using Rails 3 and your forms aren't rendering everything as expected, try changing @<%@ to @<%=@.
+  # app/assets/stylesheets/ie7.css
+  *= require formtastic_ie7
+</pre>
+
+<pre>
+  # app/views/layouts/application.html.erb
+  <%= stylesheet_link_tag 'application' %>
+  <!--[if IE 6]><%= stylesheet_link_tag 'ie6' %><![endif]-->
+  <!--[if IE 7]><%= stylesheet_link_tag 'ie7' %><![endif]-->
+</pre>
+
 
 
 h2. Usage
@@ -147,7 +159,7 @@ Forms are really boring to code... you want to get onto the good stuff as fast a
 This renders a set of inputs (one for _most_ columns in the database table, and one for each ActiveRecord @belongs_to@-association), followed by a submit button:
 
 <pre>
-  <% semantic_form_for @user do |form| %>
+  <%= semantic_form_for @user do |form| %>
     <%= form.inputs %>
     <%= form.buttons %>
   <% end %>
@@ -158,7 +170,7 @@ This is a great way to get something up fast, but like scaffolding, it's not rec
 You probably want to specify the order of the fields, skip some of the fields or even add in fields that Formtastic couldn't detect, you can pass in a list of field names to @inputs@ and list of button names to @buttons@:
 
 <pre>
-  <% semantic_form_for @user do |form| %>
+  <%= semantic_form_for @user do |form| %>
     <%= form.inputs :title, :body, :section, :categories, :created_at %>
     <%= form.buttons :commit %>
   <% end %>
@@ -167,15 +179,15 @@ You probably want to specify the order of the fields, skip some of the fields or
 You probably want control over the input type Formtastic uses for each field, you can expand the @inputs@ and @buttons@ blocks. This specifies the @:section@ input should be a set of radio buttons (rather than the default select box), and that the @:created_at@ field should be a string (rather than the default datetime selects):
 
 <pre>
-  <% semantic_form_for @post do |form| %>
-    <% form.inputs do %>
+  <%= semantic_form_for @post do |form| %>
+    <%= form.inputs do %>
       <%= form.input :title %>
       <%= form.input :body %>
       <%= form.input :section, :as => :radio %>
       <%= form.input :categories %>
       <%= form.input :created_at, :as => :string %>
     <% end %>
-    <% form.buttons do %>
+    <%= form.buttons do %>
       <%= form.commit_button %>
     <% end %>
   <% end %>
@@ -184,19 +196,19 @@ You probably want control over the input type Formtastic uses for each field, yo
 If you want to customize the label text, or render some hint text below the field, specify which fields are required/optional, or break the form into two fieldsets, the DSL is pretty comprehensive:
 
 <pre>
-  <% semantic_form_for @post do |form| %>
-    <% form.inputs "Basic", :id => "basic" do %>
+  <%= semantic_form_for @post do |form| %>
+    <%= form.inputs "Basic", :id => "basic" do %>
       <%= form.input :title %>
       <%= form.input :body %>
     <% end %>
-    <% form.inputs :name => "Advanced Options", :id => "advanced" do %>
+    <%= form.inputs :name => "Advanced Options", :id => "advanced" do %>
       <%= form.input :slug, :label => "URL Title", :hint => "Created automatically if left blank", :required => false %>
       <%= form.input :section, :as => :radio %>
-      <%= form.input :user, :label => "Author", :label_method => :full_name %>
+      <%= form.input :user, :label => "Author", :member_label => :full_name %>
       <%= form.input :categories, :required => false %>
       <%= form.input :created_at, :as => :string, :label => "Publication Date", :required => false %>
     <% end %>
-    <% form.buttons do %>
+    <%= form.buttons do %>
       <%= form.commit_button %>
     <% end %>
   <% end %>
@@ -205,15 +217,15 @@ If you want to customize the label text, or render some hint text below the fiel
 You can create forms for nested resources:
 
 <pre>
-	<% semantic_form_for [@author, @post] do |form| %>
+	<%= semantic_form_for [@author, @post] do |form| %>
 </pre>
 
 Nested forms are also supported (don't forget your models need to be setup correctly with @accepts_nested_attributes_for@). You can do it in the Rails way:
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     <%= form.inputs :title, :body, :created_at %>
-    <% form.semantic_fields_for :author do |author| %>
+    <%= form.semantic_fields_for :author do |author| %>
       <%= author.inputs :first_name, :last_name, :name => "Author" %>
     <% end %>
     <%= form.buttons %>
@@ -223,7 +235,7 @@ Nested forms are also supported (don't forget your models need to be setup corre
 Or the Formtastic way with the @:for@ option:
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     <%= form.inputs :title, :body, :created_at %>
     <%= form.inputs :first_name, :last_name, :for => :author, :name => "Author" %>
     <%= form.buttons %>
@@ -233,7 +245,7 @@ Or the Formtastic way with the @:for@ option:
 When working in has many association, you can even supply @"%i"@ in your fieldset name that it will be properly interpolated with the child index. For example:
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     <%= form.inputs %>
     <%= form.inputs :name => 'Category #%i', :for => :categories %>
     <%= form.buttons %>
@@ -244,18 +256,18 @@ If you have more than one form on the same page, it may lead to HTML invalidatio
 a namespace for your form to ensure uniqueness of id attributes on form elements. The namespace attribute will be prefixed with underscore on the generate html id. For example:
 
 <pre>
-  <% semantic_form_for(@post, :namespace => 'cat_form') do |form| %>
-  <%= form.input :title %>        # id="cat_form_post_title"
-  <%= form.input :body %>         # id="cat_form_post_body"
-  <%= form.input :created_at %>   # id="cat_form_post_created_at"
-  <%= form.buttons %>
+  <%= semantic_form_for(@post, :namespace => 'cat_form') do |form| %>
+    <%= form.input :title %>        # id="cat_form_post_title"
+    <%= form.input :body %>         # id="cat_form_post_body"
+    <%= form.input :created_at %>   # id="cat_form_post_created_at"
+    <%= form.buttons %>
   <% end %>
 </pre>
 
 Customize HTML attributes for any input using the @:input_html@ option. Typically this is used to disable the input, change the size of a text field, change the rows in a textarea, or even to add a special class to an input to attach special behavior like "autogrow":http://plugins.jquery.com/project/autogrow textareas:
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     <%= form.input :title,      :input_html => {  :cols => 10 } %>
     <%= form.input :body,       :input_html => { :class => 'autogrow', :rows => 10, :cols => 20, :maxlength => 10  } %>
     <%= form.input :created_at, :input_html => { :disabled => true } %>
@@ -266,10 +278,10 @@ Customize HTML attributes for any input using the @:input_html@ option. Typicall
 The same can be done for buttons with the @:button_html@ option:
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     ...
-    <% form.buttons do %>
-      <%= form.commit_button :button_html => { :class => "primary" } %>
+    <%= form.buttons do %>
+      <%= form.commit_button :button_html => { :class => "primary", :disable_with => 'Wait...' } %>
     <% end %>
   <% end %>
 </pre>
@@ -277,7 +289,7 @@ The same can be done for buttons with the @:button_html@ option:
 Customize the HTML attributes for the @<li>@ wrapper around every input with the @:wrapper_html@ option hash. There's one special key in the hash (@:class@), which will actually _append_ your string of classes to the existing classes provided by Formtastic (like @"required string error"@).
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     <%= form.input :title, :wrapper_html => { :class => "important" } %>
     <%= form.input :body %>
     <%= form.input :description, :wrapper_html => { :style => "display:none;" } %>
@@ -288,7 +300,7 @@ Customize the HTML attributes for the @<li>@ wrapper around every input with the
 Customize the default class used for hints on each attribute or globally in the @config/formtastic.rb@ file. Similarly you can customize the error classes on an attribute level or globally.
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     <%= form.input :title, :hint_class => 'custom-html-class', :error_class => 'custom-error-class' %>
   <% end %>
 </pre>
@@ -326,7 +338,7 @@ The Formtastic input types:
 * @:time@ - a time select. Default for column types: @:time@.
 * @:boolean@ - a checkbox. Default for column types: @:boolean@.
 * @:string@ - a text field. Default for column types: @:string@.
-* @:numeric@ - a text field (just like string). Default for  column types: @:integer@, @:float@, and @:decimal@.
+* @:number@ - a text field (just like string). Default for  column types: @:integer@, @:float@, and @:decimal@.
 * @:file@ - a file field. Default for file-attachment attributes matching: "paperclip":http://github.com/thoughtbot/paperclip or "attachment_fu":http://github.com/technoweenie/attachment_fu.
 * @:country@ - a select menu of country names. Default for column types: :string with name @"country"@ - requires a *country_select* plugin to be installed.
 * @:email@ - a text field (just like string). Default for columns with name matching @"email"@. New in HTML5. Works on some mobile browsers already.
@@ -334,6 +346,7 @@ The Formtastic input types:
 * @:phone@ - a text field (just like string). Default for columns with name matching @"phone"@ or @"fax"@. New in HTML5.
 * @:search@ - a text field (just like string). Default for columns with name matching @"search"@. New in HTML5. Works on Safari.
 * @:hidden@ - a hidden field. Creates a hidden field (added for compatibility).
+* @:range@ - a slider field.
 
 The comments in the code are pretty good for each of these (what it does, what the output is, what the options are, etc.) so go check it out.
 
@@ -358,7 +371,7 @@ Formtastic got some neat I18n-features. ActiveRecord object names and attributes
 Basic localization (labels only, with ActiveRecord):
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     <%= form.input :title %>        # => :label => I18n.t('activerecord.attributes.user.title')    or 'Title'
     <%= form.input :body %>         # => :label => I18n.t('activerecord.attributes.user.body')     or 'Body'
     <%= form.input :section %>      # => :label => I18n.t('activerecord.attributes.user.section')  or 'Section'
@@ -374,7 +387,7 @@ Formtastic supports localized *labels*, *hints*, *legends*, *actions* using the
 *1. Enable I18n lookups by default (@config/initializers/formtastic.rb@):*
 
 <pre>
-  Formtastic::SemanticFormBuilder.i18n_lookups_by_default = true
+  Formtastic::FormBuilder.i18n_lookups_by_default = true
 </pre>
 
 *2. Add some cool label-translations/variants (@config/locale/en.yml@):*
@@ -386,7 +399,7 @@ Formtastic supports localized *labels*, *hints*, *legends*, *actions* using the
         post_details: "Post details"
       labels:
         post:
-          title: "Choose a title..."
+          title: "Your Title"
           body: "Write something..."
           edit:
             title: "Edit title"
@@ -394,6 +407,12 @@ Formtastic supports localized *labels*, *hints*, *legends*, *actions* using the
         post:
           title: "Choose a good title for you post."
           body: "Write something inspiring here."
+      placeholders:
+        post:
+          title: "Title your post"
+          slug: "Leave blank for an automatically generated slug"
+        user:
+          email: "you@yours.com"
       actions:
         create: "Create my %{model}"
         update: "Save changes"
@@ -405,13 +424,13 @@ Formtastic supports localized *labels*, *hints*, *legends*, *actions* using the
 *3. ...and now you'll get:*
 
 <pre>
-  <% semantic_form_for Post.new do |form| %>
-    <% form.inputs do %>
+  <%= semantic_form_for Post.new do |form| %>
+    <%= form.inputs do %>
       <%= form.input :title %>      # => :label => "Choose a title...", :hint => "Choose a good title for you post."
       <%= form.input :body %>       # => :label => "Write something...", :hint => "Write something inspiring here."
       <%= form.input :section %>    # => :label => I18n.t('activerecord.attributes.user.section')  or 'Section'
     <% end %>
-    <% form.buttons do %>
+    <%= form.buttons do %>
       <%= form.commit_button %>     # => "Create my %{model}"
     <% end %>
   <% end %>
@@ -422,8 +441,8 @@ Formtastic supports localized *labels*, *hints*, *legends*, *actions* using the
 _Note: Slightly different because Formtastic can't guess how you group fields in a form. Legend text can be set with first (as in the sample below) specified value, or :name/:title options - depending on what flavor is preferred._
 
 <pre>
-  <% semantic_form_for @post do |form| %>
-    <% form.inputs :post_details do %>   # => :title => "Post details"
+  <%= semantic_form_for @post do |form| %>
+    <%= form.inputs :post_details do %>   # => :title => "Post details"
       # ...
     <% end %>
     # ...
@@ -433,13 +452,13 @@ _Note: Slightly different because Formtastic can't guess how you group fields in
 *5. Override I18n settings:*
 
 <pre>
-  <% semantic_form_for @post do |form| %>
-    <% form.inputs do %>
+  <%= semantic_form_for @post do |form| %>
+    <%= form.inputs do %>
       <%= form.input :title %>      # => :label => "Choose a title...", :hint => "Choose a good title for you post."
       <%= form.input :body, :hint => false %>                 # => :label => "Write something..."
       <%= form.input :section, :label => 'Some section' %>    # => :label => 'Some section'
     <% end %>
-    <% form.buttons do %>
+    <%= form.buttons do %>
       <%= form.commit_button :dummie %>     # => "Launch!"
     <% end %>
   <% end %>
@@ -448,19 +467,19 @@ _Note: Slightly different because Formtastic can't guess how you group fields in
 If I18n-lookups is disabled, i.e.:
 
 <pre>
-  Formtastic::SemanticFormBuilder.i18n_lookups_by_default = false
+  Formtastic::FormBuilder.i18n_lookups_by_default = false
 </pre>
 
 ...then you can enable I18n within the forms instead:
 
 <pre>
-  <% semantic_form_for @post do |form| %>
-    <% form.inputs do %>
+  <%= semantic_form_for @post do |form| %>
+    <%= form.inputs do %>
       <%= form.input :title, :label => true %>      # => :label => "Choose a title..."
       <%= form.input :body, :label => true %>       # => :label => "Write something..."
       <%= form.input :section, :label => true %>    # => :label => I18n.t('activerecord.attributes.user.section')  or 'Section'
     <% end %>
-    <% form.buttons do %>
+    <%= form.buttons do %>
       <%= form.commit_button true %>                # => "Update %{model}" (if we are in edit that is...)
     <% end %>
   <% end %>
@@ -506,116 +525,107 @@ h2. Semantic errors
 You can show errors on base (by default) and any other attribute just passing it name to semantic_errors method:
 
 <pre>
-  <% semantic_form_for @post do |form| %>
+  <%= semantic_form_for @post do |form| %>
     <%= form.semantic_errors :state %>
   <% end %>
 </pre>
 
 
-h2. ValidationReflection plugin
-
-If you have the "ValidationReflection":http://github.com/redinger/validation_reflection plugin installed, you won't have to specify the @:required@ option (it checks the validations on the model instead).
-
-
 h2. Configuration
 
-Run @rails generate formtastic:install@ (Rails 3) or @./script/generate formtastic@ (Rails 2) to copy a commented out config file into @config/initializers/formtastic.rb@. You can "view the configuration file on GitHub":http://github.com/justinfrench/formtastic/blob/master/generators/formtastic/templates/formtastic.rb
+Run @rails generate formtastic:install@ to copy a commented out config file into @config/initializers/formtastic.rb@. You can "view the configuration file on GitHub":http://github.com/justinfrench/formtastic/blob/master/lib/generators/templates/formtastic.rb
 
 
 h2. Form Generator
 
-There's a Formtastic form code generator to make your transition to Formtastic easier. All you have to do is to *specify an existing model name*, and optionally specify view template framework (ERB/HAML), and you are good to go. *Note:* This won't overwrite any of your stuff.
+There's a Formtastic form code generator to make your transition to Formtastic easier. All you have to do is to *specify an existing model name*, and optionally specify view template framework (ERB/HAML), and you are good to go. *Note:* This won't overwrite any of your exsting files without confirmation.
 
 h3. Basic usage
 
-Rails 3:
-
 <pre>
   $ rails generate formtastic:form ModelName
+      exists  app/views/posts
+      create  app/views/posts/_form.html.erb
 </pre>
 
-Rails 2:
+The ERB code is saved to a partial file, but it will not overwrite existing files without a prompt.
+
+h3. Copying the ERB code to the clipboard instead with @--copy@
 
 <pre>
-  $ ./script/generate form ModelName
+  $ rails generate formtastic:form Post --copy
 </pre>
 
-The results are something like this, with the ERB code printed out to the terminal 
+h3. Specifying HAML instead of ERB with @--haml@
 
 <pre>
-  $ rails generate formtastic:form Post
-  # ---------------------------------------------------------
-  #  GENERATED FORMTASTIC CODE
-  # ---------------------------------------------------------
+  $ rails generate formtastic:form Post --haml
+      exists  app/views/posts
+      create  app/views/posts/_form.html.haml
+</pre>
 
-  <% f.inputs do %>
-    <%= f.input :title, :label => 'Title' %>
-    <%= f.input :body, :label => 'Body' %>
-    <%= f.input :published, :label => 'Published' %>
-  <% end %>
+h3. Specifying controller namespace with @--controller@
 
-  # ---------------------------------------------------------
-   Copied to clipboard - just paste it!
+<pre>
+  $ rails generate formtastic:form Post --controller admin/posts
+      exists  app/views/admin/posts
+      create  app/views/admin/posts/_form.html.erb
 </pre>
 
-h3. Generating a partial with @--partial@
-
-You can also ask Formtastic to *generate a partial* with the @--partial@ option, placing it in the correct location inside your @app/views@ directory:
+h3. Specifying which attributes need an input
 
 <pre>
-  $ rails generate formtastic:form Post --partial
+  $ rails generate formtastic:form Post title:string body:text publication_state:select
       exists  app/views/posts
       create  app/views/posts/_form.html.erb
 </pre>
 
-h3. Specifying HAML instead of ERB with @--haml@
 
-<pre>
-  $ rails generate formtastic:form Post --haml
-      exists  app/views/admin/posts
-      create  app/views/admin/posts/_form.html.haml
-</pre>
 
-h3. Specifying controller namespace with @--controller@
+h2. Modified & Custom Inputs
+
+If you want to change the behaviour of an input, you can subclass it in your app. For example, to tweak @StringInput@, create a new file @app/inputs/string_input.rb@:
 
 <pre>
-  $ rails generate formtastic:form Post --partial --controller admin/posts
-      exists  app/views/admin/posts
-      create  app/views/admin/posts/_form.html.erb
+  class StringInput < Formtastic::Inputs::StringInput
+    def to_html
+      puts "this is my modified version of StringInput"
+      super
+    end
+  end
 </pre>
 
+To create your own new types of inputs based on existing inputs, the process is similar:
 
-h2. Custom Inputs
-
-If you want to add your own input types to encapsulate your own logic or interface patterns, you can do so by subclassing SemanticFormBuilder and configuring Formtastic to use your custom builder class.
-
-@Formtastic::SemanticFormHelper.builder = MyCustomBuilder@
+<pre>
+  # f.input(:body, :as => :flexible_text)
+  class FlexibleTextInput < Formtastic::Inputs::StringInput
+    def input_html_options
+      super.merge(:class => "flexible-text-area")
+    end
+  end
+</pre>
 
-Be aware that you should either set the options on custom builder or require it after setting options on formtastic default builder.
+To create your own new types of inputs from scratch:
 
 <pre>
-  # OK
-  Formtastic::SemanticFormBuilder.i18n_lookups_by_default = true
-  require 'formtastic/my_custom_builder'
-  Formtastic::SemanticFormHelper.builder = Formtastic::MyCustomBuilder
-  
-  # OK
-  require 'formtastic/my_custom_builder'
-  Formtastic::SemanticFormHelper.builder = Formtastic::MyCustomBuilder
-  Formtastic::MyCustomBuilder.i18n_lookups_by_default = true
-  
-  # WRONG!
-  require 'formtastic/my_custom_builder'
-  Formtastic::SemanticFormBuilder.i18n_lookups_by_default = true
-  Formtastic::SemanticFormHelper.builder = Formtastic::MyCustomBuilder
+  # f.input(:created_at, :as => :date_picker)
+  class DatePickerInput
+    include Formtastic::Inputs::Base
+    def to_html
+      # ...
+    end
+  end
 </pre>
 
+It was previously advised to subclass Formtastic::FormBuilder to add your own inputs. This is no longer advised, and may not work as expected.
+
 
 h2. Security
 
 By default formtastic escapes html entities in both labels and hints unless a string is marked as html_safe. If you are using an older rails version which doesn't know html_safe, or you want to globally turn this feature off, you can set the following in your initializer:
 
-Formtastic::SemanticFormBuilder.escape_html_entities_in_hints_and_labels = false
+Formtastic::FormBuilder.escape_html_entities_in_hints_and_labels = false
 
 
 h2. Dependencies
@@ -623,16 +633,10 @@ h2. Dependencies
 There are none, but...
 
 * if you have the "ValidationReflection":http://github.com/redinger/validation_reflection plugin is installed, you won't have to specify the @:required@ option (it checks the validations on the model instead).
-* if you want to use the @:country@ input, you'll need to install the "iso-3166-country-select plugin":http://github.com/rails/iso-3166-country-select (or any other country_select plugin with the same API).
+* if you want to use the @:country@ input, you'll need to install the "country-select plugin":https://github.com/chrislerum/country_select (or any other country_select plugin with the same API).
 * "rspec":http://github.com/dchelimsky/rspec/, "rspec_hpricot_matchers":http://rubyforge.org/projects/rspec-hpricot/ and "rcov":http://github.com/relevance/rcov gems (plus any of their own dependencies) are required for the test suite.
 
 
-h2. Compatibility
-
-* We're only testing Formtastic with the latest Rails 2.x and 3.x stable releases. Patches are welcome to allow backwards compatibility with older versions of Rails, of course.
-* Formtastic, much like Rails 2, is very ActiveRecord-centric. Many people are using Formtastic (especially the rails3 branch) successfully with other ActiveModel-like ORMs and classes (DataMapper, MongoMapper, Mongoid, Authlogic, Devise...) but we're not guaranteeing anything at this stage. Patches are welcome, but it's not our core focus right now.
- 
-
 h2. How to contribute
 
 Please ensure that you provide appropriate spec/test coverage and ensure the documentation is up-to-date.  Bonus points if you perform your changes in a clean topic branch rather than master, and if you create a pull request for your changes to be discussed and reviewed.
@@ -644,39 +648,18 @@ For significant changes, you may wish to discuss your idea on the Formtastic Goo
 See below for installation of a development environment.
 
 
-h2. Development Environment
-
-We currently support both Rails 2 and Rails 3, under Ruby 1.8.7-ish (and 1.9.2-ish). That means, at a bare minimum, you'll want to set-up two rvm gemsets to run your specs against. So, fork the project on Github, clone it, make some gemsets, run bundler, run your specs and then finally set-up an .rvmrc file that specifies Rails 3 as your default gemset and cd back into that directory to load in the .rvmrc file. Something like this:
-
-<pre>
-  $ cd ~/code/formtastic
-  $ rvm gemset create formtastic      # If that's your thing
-  $ rvm gemset use formtastic         # Add that to your .rvmrc too
-  $ bundle install                    # Initial bundle command to build Gemfile.lock
-  $ RAILS_2=true bundle update rails  # Updates gemfile to run agains rails 2
-  $ RAILS_2=true rake                 # Run tests against rails 2
-  $ bundle update rails               # Updates gemfile to run agains rails 3
-  $ rake                              # Run tests against rails 3
-</pre>
-
-
-h2. Maintainers & Contributors
-
-Formtastic is maintained by "Justin French":http://github.com/justinfrench, "Morton Jonuschat":http://github.com/yabawock and "Gabriel Sobrinho":http://github.com/sobrinho. "Denis Major":http://github.com/denismajor1 is doing some amazing documentation work in the wiki, and we very much appreciate the past efforts of "José Valim":http://github.com/josevalim and "Jonas Grimfelt":http://github.com/grimen and over 40 other contributors.
-
-@git shortlog -n -s --no-merges@
-
-
 h2. Google Group, Twitter, etc
 
 Please join the "Formtastic Google Group":http://groups.google.com.au/group/formtastic, especially if you'd like to talk about a new feature, or report a bug.
 
 You can also "follow @formtastic on Twitter":http://twitter.com/formtastic for announcements, tutorials and awesome Formtastic links.
 
-
 h2. Project Info
 
-Formtastic is hosted on Github: "http://github.com/justinfrench/formtastic":http://github.com/justinfrench/formtastic, where your contributions, forkings, comments and feedback are greatly welcomed.
+Formtastic was created by "Justin French":http://www.justinfrench.com with contributions from over 100 awesome developers.
+
+Run @git shortlog -n -s@ to see the awesome.
 
+The project is hosted on Github: "http://github.com/justinfrench/formtastic":http://github.com/justinfrench/formtastic, where your contributions, forkings, comments, issues and feedback are greatly welcomed.
 
 Copyright (c) 2007-2010 Justin French, released under the MIT license.