slim 2.1.0 → 3.0.0.beta.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c3e6e5e0191a26434040102229ea08970f481344
-  data.tar.gz: 4b8485efd9294318590d5472336ed7f6aef1f319
+  metadata.gz: 30e108dd9c5cf0ddce9202cbf6dc2a0e70e55713
+  data.tar.gz: 1eb064293baadcf534af30e0a822dd3eab1bd16a
 SHA512:
-  metadata.gz: 4dc486456eb27e9a02ce53ea211490222e9cc04f8c13ee4204688dcaceed5a3618c06815ba409863437138e30e73d0c6dcd53838998026b37fa314fad7c52362
-  data.tar.gz: 4768df1dd287abaf00154fb0346fba824602642956dd4116084069398a7a584ee6b352dc906f82c1f0ab825c8678c1579afd490b076248c119044e79ad31cfd6
+  metadata.gz: 46d607c3b55f54dca6f5770577f0a92ec5ede81efc8fbf43ca8bdf26ec2ac7753080e27c0601899d64e15aa85574576269a1e6f034a8144c09fa76be49977840
+  data.tar.gz: 6a84ff0d56e26954af4360dd54b76faf21173ad5250005bfcd3207316b57e35afe96ad3329196d56522c6c8db911ba3d3a42e69641a352a87df07b615dd38de3

data/.travis.yml

@@ -1,52 +1,38 @@
 language: ruby
+
 rvm:
-  - 1.8.7
   - 1.9.3
   - 2.0.0
   - 2.1.0
   - ruby-head
   - jruby-19mode
   - rbx-2
+
+sudo: false
+
+script: "bundle exec rake $TASK"
+
 env:
   - "TASK=test:core_and_plugins TILT=master"
   - "TASK=test:core_and_plugins TILT=1.3.7"
   - "TASK=test:core_and_plugins TILT=1.4.1"
   - "TASK=test:core_and_plugins TILT=2.0.1"
   - "TASK=test:rails RAILS=master"
-  - "TASK=test:rails RAILS=3.0.20"
   - "TASK=test:rails RAILS=3.1.12 TILT=1.3.4"
-  - "TASK=test:rails RAILS=3.2.19 TILT=1.3.4"
-  - "TASK=test:rails RAILS=4.0.9"
-  - "TASK=test:rails RAILS=4.1.5"
+  - "TASK=test:rails RAILS=3.2.21 TILT=1.3.4"
+  - "TASK=test:rails RAILS=4.0.12"
+  - "TASK=test:rails RAILS=4.1.8"
   - "TASK=test:sinatra SINATRA=master"
   - "TASK=test:sinatra SINATRA=1.3.6"
   - "TASK=test:sinatra SINATRA=1.4.5"
   - "TASK=bench iterations=10000"
   - "TASK=bench slow=1 iterations=1000"
+
 matrix:
   exclude:
-    # Test Rails master only on 1.9.3+ Rubies
-    - rvm: 1.8.7
-      env: "TASK=test:rails RAILS=master"
-    - rvm: jruby-18mode
-      env: "TASK=test:rails RAILS=master"
     - rvm: rbx-2
       env: "TASK=test:rails RAILS=master"
-    - rvm: 1.8.7
-      env: "TASK=test:rails RAILS=4.0.9"
-    - rvm: 1.8.7
-      env: "TASK=test:rails RAILS=4.1.5"
-    - rvm: jruby-18mode
-      env: "TASK=test:rails RAILS=4.0.9"
-    - rvm: jruby-18mode
-      env: "TASK=test:rails RAILS=4.1.5"
   allow_failures:
     - env: "TASK=test:core_and_plugins TILT=master"
     - env: "TASK=test:rails RAILS=master"
-    - env: "TASK=test:sinatra SINATRA=master"
-      rvm: 2.0.0
     - rvm: ruby-head
-# Rails master needs newest bundler
-before_install:
-  - gem update bundler
-script: "bundle exec rake $TASK"

data/CHANGES

@@ -1,3 +1,11 @@
+3.0.0
+
+  * Drop 1.8.7 support
+  * Deprecate default_options in favor of options
+  * Support xml pretty printing with format: :xml
+  * Deprecate `='`, `=='` and `tag'` syntax for trailing whitespace. Use `=<` etc. instead.
+  * slimrb: Remove deprecated plugin options -l and -t
+
 2.1.0
 
   * Parser: Require pairwise braces in quoted attributes

data/Gemfile

@@ -3,15 +3,13 @@ source 'https://rubygems.org/'
 gemspec
 
 if ENV['TRAVIS'] || ENV['TEMPLE'] == 'master'
-  gem 'temple', :github => 'judofyr/temple'
-elsif ENV['TEMPLE_PATH']
-  gem 'temple', :path => ENV['TEMPLE_PATH']
+  gem 'temple', github: 'judofyr/temple'
 end
 
 if ENV['TILT']
   if ENV['TILT'] == 'master'
-    gem 'opal', :github => 'opal/opal' if RUBY_VERSION > '1.9'
-    gem 'tilt', :github => 'rtomayko/tilt'
+    gem 'opal', github: 'opal/opal' if RUBY_VERSION > '1.9'
+    gem 'tilt', github: 'rtomayko/tilt'
   else
     gem 'tilt', "= #{ENV['TILT']}"
   end
@@ -19,7 +17,7 @@ end
 
 if ENV['RAILS']
   if ENV['RAILS'] == 'master'
-    gem 'rails', :github => 'rails/rails'
+    gem 'rails', github: 'rails/rails'
   else
     gem 'rails', "= #{ENV['RAILS']}"
   end
@@ -35,7 +33,7 @@ end
 if ENV['SINATRA']
   gem 'rack-test'
   if ENV['SINATRA'] == 'master'
-    gem 'sinatra', :github => 'sinatra/sinatra'
+    gem 'sinatra', github: 'sinatra/sinatra'
   else
     gem 'sinatra', "= #{ENV['SINATRA']}"
   end

data/README.jp.md

@@ -23,7 +23,7 @@ Slim は 不可解にならないように view の構文を本質的な部品
     * ERB/Erubis に匹敵するスピード
     * Rails のストリーミングに対応
 * 全てのメジャーフレームワークが対応 (Rails, Sinatra, ...)
-* Ruby 1.9 では タグや属性の Unicode に完全対応
+* タグや属性の Unicode に完全対応
 * Markdown や Textile のような埋め込みエンジン
 
 ## リンク
@@ -134,7 +134,7 @@ body
 <body><p>これはテキストブロックのテストです。</p></body>
 ~~~
 
-  ブロックの左端はパイプ +1 スペースのインデントに設定されています。 
+  ブロックの左端はパイプ +1 スペースのインデントに設定されています。
   追加のスペースはコピーされます。
 
 ~~~ slim
@@ -470,7 +470,7 @@ a data-title="help" data-content="極めて長い長い長いヘルプテキス
 #### Ruby コードを用いた属性
 
 `=` の後に直接 Ruby コードを書きます。コードにスペースが含まれる場合,
-`(...)` の括弧でコードを囲まなければなりません。ハッシュを `{...}` に, 配列を `[...]` に書くこともできます。 
+`(...)` の括弧でコードを囲まなければなりません。ハッシュを `{...}` に, 配列を `[...]` に書くこともできます。
 
 ~~~ slim
 body
@@ -550,7 +550,7 @@ a class=:menu,:highlight
 属性の結合 (Slim オプション `:merge_attrs` 参照) に対応するハッシュ属性には `Array` を与えることもできます。
 
 ~~~ slim
-.first *{:class => [:second, :third]} テキスト
+.first *{class: [:second, :third]} テキスト
 ~~~
 
 レンダリング結果
@@ -567,7 +567,7 @@ div class="first second third"
 ~~~ slim
 ruby:
   def a_unless_current
-    @page_current ? {:tag => 'span'} : {:tag => 'a', :href => 'http://slim-lang.com/'}
+    @page_current ? {tag: 'span'} : {tag: 'a', href: 'http://slim-lang.com/'}
   end
 - @page_current = true
 *a_unless_current リンク
@@ -588,7 +588,7 @@ ruby:
 `:shortcut` オプションを設定することで独自のタグショートカットを定義できます。
 
 ~~~ ruby
-Slim::Engine.set_default_options :shortcut => {'c' => {:tag => 'container'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'} }
+Slim::Engine.set_options shortcut: {'c' => {tag: 'container'}, '#' => {attr: 'id'}, '.' => {attr: 'class'} }
 ~~~
 
 Slim コードの中でこの様に使用できます。
@@ -610,7 +610,7 @@ c.content テキスト
 例として `&` で作った type 属性付きの input 要素のショートカットを作成し追加します。
 
 ~~~ ruby
-Slim::Engine.set_default_options :shortcut => {'&' => {:tag => 'input', :attr => 'type'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'}}
+Slim::Engine.set_options shortcut: {'&' => {tag: 'input', attr: 'type'}, '#' => {attr: 'id'}, '.' => {attr: 'class'}}
 ~~~
 
 Slim コードの中でこの様に使用できます。
@@ -632,7 +632,7 @@ Slim コードの中でこの様に使用できます。
 別の例として `@` で作った role 属性のショートカットを作成し追加します。
 
 ~~~ ruby
-Slim::Engine.set_default_options :shortcut => {'@' => 'role', '#' => 'id', '.' => 'class'}
+Slim::Engine.set_options shortcut: {'@' => 'role', '#' => 'id', '.' => 'class'}
 ~~~
 
 Slim コードの中でこの様に使用できます。
@@ -650,7 +650,7 @@ Slim コードの中でこの様に使用できます。
 1つのショートカットを使って複数の属性を設定することもできます。
 
 ~~~ ruby
-Slim::Engine.set_default_options :shortcut => {'@' => {:attr => %w(data-role role)}}
+Slim::Engine.set_options shortcut: {'@' => {attr: %w(data-role role)}}
 ~~~
 
 Slim の中で次のように使用し
@@ -702,7 +702,7 @@ module Helpers
       # Rails の場合には capture メソッドを使う
       "<h1>#{capture(&block)}</h1>"
     else
-      # フレームワークなしで Slim を使う場合(Tilt の場合), 
+      # フレームワークなしで Slim を使う場合(Tilt の場合),
       # ただ出力する
       "<h1>#{yield}</h1>"
     end
@@ -859,7 +859,7 @@ p: markdown: Tag with **inline** markdown!
 埋め込みエンジンは Slim の `Slim::Embedded` フィルタのオプションで直接設定されます。例:
 
 ~~~ ruby
-Slim::Embedded.default_options[:markdown] = {:auto_ids => false}
+Slim::Embedded.options[:markdown] = {auto_ids: false}
 ~~~
 
 ## Slim の設定
@@ -871,16 +871,16 @@ Slim を設定する方法はコンパイル機構に少し依存します。(Ra
 
 ~~~ ruby
 # デバック用に html をきれいにインデントし属性をソートしない (Ruby 1.8)
-Slim::Engine.set_default_options :pretty => true. :sort_attrs => false
+Slim::Engine.set_options pretty: true. sort_attrs: false
 
 # デバック用に html をきれいにインデントし属性をソートしない (Ruby 1.9)
-Slim::Engine.set_default_options pretty: true, sort_attrs: false
+Slim::Engine.set_options pretty: true, sort_attrs: false
 ~~~
 
 ハッシュで直接オプションにアクセスすることもできます:
 
 ~~~ ruby
-Slim::Engine.default_options[:pretty] = true
+Slim::Engine.options[:pretty] = true
 ~~~
 
 ### 実行時のオプション設定
@@ -898,7 +898,7 @@ Slim::Template.new('template.slim', optional_option_hash).render(scope)
 Slim::Engine.with_options(option_hash) do
    # ここで作成される Slim エンジンは option_hash を使用します
    # Rails での使用例:
-   render :page, :layout => true
+   render :page, layout: true
 end
 ~~~
 
@@ -906,19 +906,19 @@ Rails ではコンパイルされたテンプレートエンジンのコード
 
 ~~~ slim
 # 最初のレンダリング呼び出し
-Slim::Engine.with_options(:pretty => true) do
-   render :page, :layout => true
+Slim::Engine.with_options(pretty: true) do
+   render :page, layout: true
 end
 
 # 2回目のレンダリング呼び出し
-Slim::Engine.with_options(:pretty => false) do
-   render :page, :layout => true # :pretty is still true because it is cached
+Slim::Engine.with_options(pretty: false) do
+   render :page, layout: true # :pretty is still true because it is cached
 end
 ~~~
 
 ### 可能なオプション
 
-次のオプションが `Slim::Engine` によって用意され `Slim::Engine.set_default_options` で設定することができます。
+次のオプションが `Slim::Engine` によって用意され `Slim::Engine.set_options` で設定することができます。
 沢山ありますが良いことに, Slim はもし誤った設定キーを使用しようとした場合キーをチェックしエラーを報告します。
 
 
@@ -928,7 +928,7 @@ end
 | 数値 | :tabsize | 4 | 1 タブあたりのスペース数 (構文解析で利用されます) |
 | 文字列 | :encoding | "utf-8" | テンプレートのエンコーディングを設定 |
 | 文字列 | :default_tag | "div" | タグ名が省略されている場合デフォルトのタグとして使用される |
-| ハッシュ | :shortcut | \{'.' => {:attr => 'class'}, '#' => {:attr => 'id'}} | 属性のショートカット |
+| ハッシュ | :shortcut | \{'.' => {attr: 'class'}, '#' => {attr: 'id'}} | 属性のショートカット |
 | ハッシュ | :code_attr_delims | \{'(' => ')', '[' => ']', '{' => '}'} | Ruby コードの属性区切り文字 |
 | ハッシュ | :attr_list_delims | \{'(' => ')', '[' => ']', '{' => '}'} | 属性リスト区切り文字 |
 | 配列&lt;シンボル,文字列&gt; | :enable_engines | nil <i>(すべて可)</i> | 有効な埋め込みエンジンリスト (ホワイトリスト) |
@@ -936,7 +936,7 @@ end
 | 真偽値 | :disable_capture | false (Rails では true) | ブロック内キャプチャ無効 (ブロックはデフォルトのバッファに書き込む)  |
 | 真偽値 | :disable_escape | false | 文字列の自動エスケープ無効 |
 | 真偽値 | :use_html_safe | false (Rails では true) | ActiveSupport の String# html_safe? を使う (:disable_escape と一緒に機能する) |
-| シンボル | :format | :xhtml | html の出力フォーマット (対応フォーマット :xhtml, :html4, :html5, :html) |
+| シンボル | :format | :xhtml | html の出力フォーマット (対応フォーマット :html, :xhtml, :xml) |
 | 文字列 | :attr_quote |  '"'  | html の属性を囲む文字 (' または " が可能) |
 | ハッシュ | :merge_attrs | \{'class' => ' '} | 複数の html 属性が与えられた場合結合に使われる文字列 (例: class="class1 class2") |
 | 配列&lt;文字列&gt; | :hyphen_attrs | %w(data) | 属性にハッシュが与えられた場合ハイフンつなぎされます。(例: data={a:1, b:2} は data-a="1" data-b="2" のように) |
@@ -944,7 +944,7 @@ end
 | シンボル | :js_wrapper | nil | :comment,  :cdata や :both で JavaScript をラップします。:guess を指定することで :format オプションに基いて設定することもできます |
 | 真偽値 | :pretty | false | 綺麗な html インデント <b>(遅くなります!)</b> |
 | 文字列 | :indent | '  ' | インデントに使用される文字列 |
-| 真偽値 | :streaming | false (Rails > 3.1 では true) | ストリーミング出力の有効化 |
+| 真偽値 | :streaming | false (Rails では true) | ストリーミング出力の有効化 |
 | Class | :generator | Temple::Generators::ArrayBuffer/ RailsOutputBuffer | Temple コードジェネレータ (デフォルトのジェネレータは配列バッファを生成します) |
 | 文字列 | :buffer | '_buf' (Rails では '@output_buffer') | バッファに使用される変数 |
 
@@ -959,9 +959,9 @@ Slim や Temple のアーキテクチャについてよく知っている開発
 継承メカニズムを採用しています。オプションの優先順位は次のとおりです:
 
 1. `Slim::Template` オプションはエンジン初期化時に適用されます
-2. `Slim::Template.default_options`
-3. `Slim::Engine.thread_options`, `Slim::Engine.default_options`
-5. パーサ/フィルタ/ジェネレータ `thread_options`, `default_options` (例: `Slim::Parser`, `Slim::Compiler`)
+2. `Slim::Template.options`
+3. `Slim::Engine.thread_options`, `Slim::Engine.options`
+5. パーサ/フィルタ/ジェネレータ `thread_options`, `options` (例: `Slim::Parser`, `Slim::Compiler`)
 
 `Temple::Engine` のようにスーパークラスのオプションを設定することも可能です。しかしこれはすべての Temple テンプレートエンジンに影響します。
 
@@ -1037,15 +1037,13 @@ Usage: slimrb [options]
     -e, --erb                        Convert to ERB
         --rails                      Generate rails compatible code (Implies --compile)
     -r library                       Load library or plugin with -r slim/plugin
-    -t, --translator                 Enable translator plugin
-    -l, --logic-less                 Enable logic less plugin
     -p, --pretty                     Produce pretty html
     -o, --option name=code           Set slim option
     -h, --help                       Show this message
     -v, --version                    Print version
 </pre>
 
-'slimrb' で起動し, コードをタイプし Ctrl-d で EOF を送ります。Windows のコマンドプロンプトでは Ctrl-z で EOF を送ります。使い方例: 
+'slimrb' で起動し, コードをタイプし Ctrl-d で EOF を送ります。Windows のコマンドプロンプトでは Ctrl-z で EOF を送ります。使い方例:
 
 <pre>
 $ slimrb
@@ -1115,7 +1113,7 @@ Travis-CI は継続的インテグレーションテストに利用されてい
 
 Slim はすべての主要な Ruby 実装で動作します:
 
-* Ruby 1.8.7, 1.9.3 および 2.0.0
+* Ruby 1.8.7, 1.9.3, 2.0.0 および 2.1.0
 * Ruby EE
 * JRuby 1.9 mode
 * Rubinius 2.0
@@ -1130,7 +1128,7 @@ $ git clone git://github.com/slim-template/slim
 
 魔法をかけた後 pull request を送ってください。私たちは pull request が大好きです！
 
-Ruby の 2.0.0, 1.9.3 と 1.8.7 でテストをすることを覚えておいてください。
+Ruby の 2.1.0, 2.0.0, 1.9.3 と 1.8.7 でテストをすることを覚えておいてください。
 
 もしドキュメントの不足を見つけたら, README.md をアップデートして私たちを助けて下さい。Slim に割く時間がないが, 私たちが知るべきものを何か見つけた場合には issue を送ってください。
 

data/README.md

@@ -23,7 +23,7 @@ A short list of the features...
     * Comparable speed to ERB/Erubis
     * Streaming support in Rails
 * Supported by all major frameworks (Rails, Sinatra, ...)
-* Full Unicode support for tags and attributes on Ruby 1.9
+* Full Unicode support for tags and attributes
 * Embedded engines like Markdown and Textile
 
 ## Links
@@ -199,14 +199,14 @@ The equal sign tells Slim it's a Ruby call that produces output to add to the bu
 
 If your line ends with comma `,` (e.g because of a method call) you don't need the additional backslash before the linebreak. For trailing or leading whitespace the modifiers `>` and `<` are supported.
 
-* Output with trailing white space `=>`. Same as the single equal sign (`=`), except that it adds a trailing white space. The legacy syntax `='` is also supported.
+* Output with trailing white space `=>`. Same as the single equal sign (`=`), except that it adds a trailing white space.
 * Output with leading white space `=<`. Same as the single equal sign (`=`), except that it adds a leading white space.
 
 ### Output without HTML escaping `==`
 
 Same as the single equal sign (`=`), but does not go through the `escape_html` method. For trailing or leading whitespace the modifiers `>` and `<` are supported.
 
-* Output without HTML escaping and trailing white space `==>`. Same as the double equal sign (`==`), except that it adds a trailing white space. The legacy syntax `=='` is also supported.
+* Output without HTML escaping and trailing white space `==>`. Same as the double equal sign (`==`), except that it adds a trailing white space.
 * Output without HTML escaping and leading white space `==<`. Same as the double equal sign (`==`), except that it adds a leading white space.
 
 ### Code comment `/`
@@ -550,7 +550,7 @@ You can also use methods or instance variables which return a hash as shown here
 The hash attributes which support attribute merging (see Slim option `:merge_attrs`) can be given as an `Array`
 
 ~~~ slim
-.first *{:class => [:second, :third]} Text
+.first *{class: [:second, :third]} Text
 ~~~
 
 renders as
@@ -567,7 +567,7 @@ with the :tag key.
 ~~~ slim
 ruby:
   def a_unless_current
-    @page_current ? {:tag => 'span'} : {:tag => 'a', :href => 'http://slim-lang.com/'}
+    @page_current ? {tag: 'span'} : {tag: 'a', href: 'http://slim-lang.com/'}
   end
 - @page_current = true
 *a_unless_current Link
@@ -588,7 +588,7 @@ renders as
 You can define custom tag shortcuts by setting the option `:shortcut`.
 
 ~~~ ruby
-Slim::Engine.set_default_options :shortcut => {'c' => {:tag => 'container'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'} }
+Slim::Engine.set_options shortcut: {'c' => {tag: 'container'}, '#' => {attr: 'id'}, '.' => {attr: 'class'} }
 ~~~
 
 We can use it in Slim code like this
@@ -610,7 +610,7 @@ You can define custom shortcuts (Similar to `#` for id and `.` for class).
 In this example we add `&` to create a shortcut for the input elements with type attribute.
 
 ~~~ ruby
-Slim::Engine.set_default_options :shortcut => {'&' => {:tag => 'input', :attr => 'type'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'}}
+Slim::Engine.set_options shortcut: {'&' => {tag: 'input', attr: 'type'}, '#' => {attr: 'id'}, '.' => {attr: 'class'}}
 ~~~
 
 We can use it in Slim code like this
@@ -632,7 +632,7 @@ which renders to
 In another example we add `@` to create a shortcut for the role attribute.
 
 ~~~ ruby
-Slim::Engine.set_default_options :shortcut => {'@' => {:attr => 'role'}, '#' => {:attr => 'id'}, '.' => {:attr => 'class'}}
+Slim::Engine.set_options shortcut: {'@' => {attr: 'role'}, '#' => {attr: 'id'}, '.' => {attr: 'class'}}
 ~~~
 
 We can use it in Slim code like this
@@ -650,7 +650,7 @@ which renders to
 You can also set multiple attributes at once using one shortcut.
 
 ~~~ ruby
-Slim::Engine.set_default_options :shortcut => {'@' => {:attr => %w(data-role role)}}
+Slim::Engine.set_options shortcut: {'@' => {attr: %w(data-role role)}}
 ~~~
 
 We can use it in Slim code like this
@@ -859,7 +859,7 @@ Supported engines:
 The embedded engines can be configured in Slim by setting the options directly on the `Slim::Embedded` filter. Example:
 
 ~~~ ruby
-Slim::Embedded.default_options[:markdown] = {:auto_ids => false}
+Slim::Embedded.options[:markdown] = {auto_ids: false}
 ~~~
 
 ## Configuring Slim
@@ -870,17 +870,14 @@ The way how you configure Slim depends a bit on the compilation mechanism (Rails
 ### Default options
 
 ~~~ ruby
-# Indent html for pretty debugging and do not sort attributes (Ruby 1.8)
-Slim::Engine.set_default_options :pretty => true, :sort_attrs => false
-
-# Indent html for pretty debugging and do not sort attributes (Ruby 1.9)
-Slim::Engine.set_default_options pretty: true, sort_attrs: false
+# Indent html for pretty debugging and do not sort attributes
+Slim::Engine.set_options pretty: true, sort_attrs: false
 ~~~
 
 You can also access the option hash directly:
 
 ~~~ ruby
-Slim::Engine.default_options[:pretty] = true
+Slim::Engine.options[:pretty] = true
 ~~~
 
 ### Setting options at runtime
@@ -898,7 +895,7 @@ The other possibility is to set the options per thread which is interesting most
 Slim::Engine.with_options(option_hash) do
   # Any Slim engines which are created here use the option_hash
   # For example in Rails:
-  render :page, :layout => true
+  render :page, layout: true
 end
 ~~~
 
@@ -906,19 +903,19 @@ You have to be aware that the compiled engine code and the options are cached pe
 
 ~~~ ruby
 # First render call
-Slim::Engine.with_options(:pretty => true) do
-   render :page, :layout => true
+Slim::Engine.with_options(pretty: true) do
+   render :page, layout: true
 end
 
 # Second render call
-Slim::Engine.with_options(:pretty => false) do
-   render :page, :layout => true # :pretty is still true because it is cached
+Slim::Engine.with_options(pretty: false) do
+   render :page, layout: true # :pretty is still true because it is cached
 end
 ~~~
 
 ### Available options
 
-The following options are exposed by the `Slim::Engine` and can be set with `Slim::Engine.set_default_options`.
+The following options are exposed by the `Slim::Engine` and can be set with `Slim::Engine.set_options`.
 There are a lot of them but the good thing is, that Slim checks the configuration keys and reports an error if you try to use an invalid configuration key.
 
 
@@ -928,7 +925,7 @@ There are a lot of them but the good thing is, that Slim checks the configuratio
 | Integer | :tabsize | 4 | Number of white spaces per tab (used by the parser) |
 | String | :encoding | "utf-8" | Set encoding of template |
 | String | :default_tag | "div" | Default tag to be used if tag name is omitted |
-| Hash | :shortcut | \{'.' => {:attr => 'class'}, '#' => {:attr => 'id'}} | Attribute shortcuts |
+| Hash | :shortcut | \{'.' => {attr: 'class'}, '#' => {attr: 'id'}} | Attribute shortcuts |
 | Hash | :code_attr_delims | \{'(' => ')', '[' => ']', '{' => '}'} | Attribute delimiters for Ruby code attributes |
 | Hash | :attr_list_delims | \{'(' => ')', '[' => ']', '{' => '}'} | Attribute list delimiter |
 | Array&lt;Symbol,String&gt; | :enable_engines | nil <i>(All enabled)</i> | List of enabled embedded engines (whitelist) |
@@ -936,7 +933,7 @@ There are a lot of them but the good thing is, that Slim checks the configuratio
 | Boolean | :disable_capture | false (true in Rails) | Disable capturing in blocks (blocks write to the default buffer  |
 | Boolean | :disable_escape | false | Disable automatic escaping of strings |
 | Boolean | :use_html_safe | false (true in Rails) | Use String#html_safe? from ActiveSupport (Works together with :disable_escape) |
-| Symbol | :format | :xhtml | HTML output format (Possible formats :xhtml, :html4, :html5, :html) |
+| Symbol | :format | :xhtml | HTML output format (Possible formats :html, :xhtml, :xml) |
 | String | :attr_quote | '"' | Character to wrap attributes in html (can be ' or ") |
 | Hash | :merge_attrs | \{'class' => ' '} | Joining character used if multiple html attributes are supplied (e.g. class="class1 class2") |
 | Array&lt;String&gt; | :hyphen_attrs | %w(data) | Attributes which will be hyphenated if a Hash is given (e.g. data={a:1,b:2} will render as data-a="1" data-b="2") |
@@ -944,7 +941,7 @@ There are a lot of them but the good thing is, that Slim checks the configuratio
 | Symbol | :js_wrapper | nil | Wrap javascript by :comment, :cdata or :both. You can also :guess the wrapper based on :format. |
 | Boolean | :pretty | false | Pretty HTML indenting, only block level tags are indented <b>(This is slower!)</b> |
 | String | :indent | '  ' | Indentation string |
-| Boolean | :streaming | false (true in Rails > 3.1) | Enable output streaming |
+| Boolean | :streaming | false (true in Rails, see below how to disable it!) | Enable output streaming, improves the perceived performance |
 | Class | :generator | Temple::Generators::ArrayBuffer/ RailsOutputBuffer | Temple code generator (default generator generates array buffer) |
 | String | :buffer | '_buf' ('@output_buffer' in Rails) | Variable used for buffer |
 
@@ -959,9 +956,9 @@ options at different positions. Temple uses an inheritance mechanism to allow su
 options of the superclass. The option priorities are as follows:
 
 1. `Slim::Template` options passed at engine instatination
-2. `Slim::Template.default_options`
-3. `Slim::Engine.thread_options`, `Slim::Engine.default_options`
-5. Parser/Filter/Generator `thread_options`, `default_options` (e.g `Slim::Parser`, `Slim::Compiler`)
+2. `Slim::Template.options`
+3. `Slim::Engine.thread_options`, `Slim::Engine.options`
+5. Parser/Filter/Generator `thread_options`, `options` (e.g `Slim::Parser`, `Slim::Compiler`)
 
 It is also possible to set options for superclasses like `Temple::Engine`. But this will affect all temple template engines then.
 
@@ -1015,12 +1012,17 @@ html
 ### Rails
 
 Rails generators are provided by [slim-rails](https://github.com/slim-template/slim-rails). slim-rails
-is not necessary to use Slim in Rails though. Just install Slim and add it to your Gemfile with `gem 'slim'`.
+is not necessary to use Slim in Rails though. Just install Slim and add it to your Gemfile with `gem 'slim-rails'`.
 Then just use the .slim extension and you're good to go.
 
 #### Streaming
 
-HTTP streaming is enabled by default if you use a Rails version which supports it.
+HTTP streaming is enabled by default if you use a Rails version which supports it. However you have to be aware that streaming only improves the perceived
+performance. The rendering time in total will increase. If you want to disable it use:
+
+~~~ ruby
+Slim::RailsTemplate.set_options streaming: false
+~~~
 
 ## Tools
 
@@ -1037,8 +1039,6 @@ Usage: slimrb [options]
     -e, --erb                        Convert to ERB
         --rails                      Generate rails compatible code (Implies --compile)
     -r library                       Load library or plugin with -r slim/plugin
-    -t, --translator                 Enable translator plugin
-    -l, --logic-less                 Enable logic less plugin
     -p, --pretty                     Produce pretty html
     -o, --option name=code           Set slim option
     -h, --help                       Show this message
@@ -1115,7 +1115,7 @@ Travis-CI is used for continuous integration testing: <http://travis-ci.org/slim
 
 Slim is working well on all major Ruby implementations:
 
-* Ruby 1.8.7, 1.9.3 and 2.0.0
+* Ruby 1.9.3, 2.0.0 and 2.1.0
 * Ruby EE
 * JRuby 1.9 mode
 * Rubinius 2.0
@@ -1130,7 +1130,7 @@ $ git clone git://github.com/slim-template/slim
 
 Work your magic and then submit a pull request. We love pull requests!
 
-Please remember to keep the compatibility with Ruby versions 1.8.7, 1.9.3 and 2.0.0.
+Please remember to keep the compatibility with Ruby versions 1.9.3, 2.0.0 and 2.1.0.
 
 If you find the documentation lacking, help us out and update this README.md. If you don't have the time to work on Slim, but found something we should know about, please submit an issue.