README.md in rails-timeago-1.1.1 vs README.md in rails-timeago-1.2.0.rc1

@@ -1,15 +1,17 @@
 # rails-timeago
 
-*rails-timeago* provides a timeago_tag helper to create time tags usable for 
+**rails-timeago** provides a timeago_tag helper to create time tags usable for
 [jQuery Timeago](https://github.com/rmm5t/jquery-timeago) plugin.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'rails-timeago'
+```ruby
+gem 'rails-timeago'
+```
 
 And then execute:
 
     $ bundle
 
@@ -17,61 +19,91 @@
 
     $ gem install rails-timeago
 
 To use bundled jQuery Timeago plugin add this require statement to your application.js file:
 
-    //=require rails-timeago
+    //= require rails-timeago
 
-This will also convert all matching time tags on page load. 
+This will also convert all matching time tags on page load.
 
 ## Usage
 
 Use the timeago_tag helper like any other regular tag helper:
 
-    <%= timeago_tag Time.zone.now, :nojs => true, :limit => 10.days.ago %>
+```erb
+<%= timeago_tag Time.zone.now, :nojs => true, :limit => 10.days.ago %>
+```
 
 
 ### Available options:
 
-* nojs
+**nojs**
+Add time ago in words as time tag content instead of absolute time.
+(default: false)
 
-  Add time ago in words as time tag content instead of absolute time. 
-  (default: false)
+**date_only**
+Only print date as tag content instead of full time.
+(default: true)
 
-* date_only
+**format**
+A time format for localize method used to format static time.
+(default: default)
 
-  Only print date as tag content instead of full time. 
-  (default: true)
+**limit**
+Set a limit for time ago tags. All dates before given limit will not be converted.
+(default: 4.days.ago)
 
-* format
+**force**
+Force time ago tag ignoring limit option.
+(default: false)
 
-  A time format for localize method used to format static time. 
-  (default: default)
- 
-* limit
+**default**
+String that will be returned if time is nil.
+(default: '-')
 
-  Set a limit for time ago tags. All dates before given limit will not be converted. 
-  (default: 4.days.ago) 
 
-* force
-
-  Force time ago tag ignoring limit option. 
-  (default: false)
-
-* default
-
-  String that will be returned if time is nil.
-  (default: '-')
-
 All other options will be given as options to the time tag helper.
-
 The above options can be assigned globally as defaults using
 
-    Rails::Timeago.default_options :limit => proc { 20.days.ago }, :nojs => true
+```ruby
+Rails::Timeago.default_options :limit => proc { 20.days.ago }, :nojs => true
+```
 
 A global limit should always be given as a block that will be evaluated each time
 the rails timeago_tag helper is called. That avoids the limit becoming smaller the
 longer the application runs.
+
+## I18n
+
+**Note:** Available since version *1.2.0.rc1*. I18n features are still untested.
+
+**rails-timeago** provides additional localization features and includes locale
+files for the following locales taken from [jQuery Timeago](https://github.com/rmm5t/jquery-timeago).
+
+> ar, bg, bs, ca, cy, cz, da, de, el, en, es, fa, fi, fr,
+> he, hr, hu, hy, id, it, ja, ko, nl, no, pl, pt, ro, ru,
+> sv, tr, uk, zh-CN, zh-TW
+
+**rails-timeago** will automatically include the locale file for your current
+locale if it is available. You only have to include the following method into
+your html head tag:
+
+```ruby
+<%= timeago_script_tag %>
+```
+
+That will add a script include tag to include the needed locale file.
+**rails-timeago** will also add all locale files to Rails precompiled assets
+list to allow precompilation. By default all locale files will be included but
+you can specify a list by adding a initializer similar to:
+
+```ruby
+Rails::Timeago.locales = [:en, :de]
+```
+
+This will only add English and German locale files to precompiled assets.
+To add your own locales add a file in JavaScript assets directory named
+`locales/jquery.timeago.<locale>.js` and add your locale to `Rails::Timeago.locales`.
 
 ## License
 
 [MIT License](http://www.opensource.org/licenses/mit-license.php)