RubyGems - ember - Versions diffs - 0.3.0 → 0.3.1 - Mend

ember 0.3.0 → 0.3.1

Files changed (8) hide show

metadata CHANGED

@@ -1,48 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: ember
 version: !ruby/object:Gem::Version
-  prerelease: false
-  segments:
-  - 0
-  - 3
-  - 0
-  version: 0.3.0
+  prerelease:
+  version: 0.3.1
 platform: ruby
 authors:
 - Suraj N. Kurapati
-- Kamil Kukura
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2010-04-26 00:00:00 -07:00
-default_executable:
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: inochi
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        segments:
-        - 2
-        version: "2"
-  type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency
-  name: dfect
-  prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        segments:
-        - 2
-        version: "2"
-  type: :development
-  version_requirements: *id002
-description: Ember (EMBEdded Ruby) is an eRuby template processor that allows debugging, reduces markup, and improves composability of eRuby templates.
+date: 2011-04-22 00:00:00 Z
+dependencies: []
+description: Ember (EMBEdded Ruby) is an [eRuby] template processor that allows
 debugging, reduces markup, and improves composability of eRuby templates.
 email:
 executables:
 - ember
@@ -52,15 +23,12 @@ extra_rdoc_files: []
 files:
 - bin/ember
-- lib/ember.rb
-- lib/ember/inochi.rb
-- lib/ember/template.rb
 - lib/ember/helpers/rails_helper.rb
+- lib/ember/template.rb
+- lib/ember/inochi.rb
+- lib/ember.rb
 - LICENSE
-- CREDITS
-- man.html
-- man/man1/ember.1.gz
-has_rdoc: true
+- man/man1/ember.1
 homepage: http://snk.tuxfamily.org/lib/ember/
 licenses: []
@@ -70,23 +38,21 @@ rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      segments:
-      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      segments:
-      - 0
       version: "0"
 requirements: []
 rubyforge_project:
-rubygems_version: 1.3.6
+rubygems_version: 1.7.2
 signing_key:
 specification_version: 3
 summary: eRuby template processor

data/CREDITS DELETED

@@ -1,13 +0,0 @@
-%#----------------------------------------------------------------------------
-## CREDITS
-%#----------------------------------------------------------------------------
-Suraj N. Kurapati,
-Kamil Kukura
-%#----------------------------------------------------------------------------
-## LICENSE
-%#----------------------------------------------------------------------------
-%# See the file named "LICENSE".
-%< "LICENSE"

data/man.html DELETED

@@ -1,1031 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <meta http-equiv='content-type' value='text/html;charset=utf8'>
-  <meta name='generator' value='Ronn/v0.5 (http://github.com/rtomayko/ronn)'>
-  <title>ember(1) - eRuby template processor</title>
-  <style type='text/css'>
-    body {margin:0}
-    #man, #man code, #man pre, #man tt, #man kbd, #man samp {
-      font-family:consolas,monospace;
-      font-size:16px;
-      line-height:1.3;
-      color:#343331;
-      background:#fff; }
-    #man { max-width:87ex; margin:0 3ex 1ex 1ex; text-align:justify; }
-    #man div.man-navigation {
-      position:fixed;
-      top:0;
-      left:91ex;
-      height:100%;
-      width:100%;
-      padding:1ex 0 0 2ex;
-      border-left:0.5ex solid #DCDCDC;
-      background-color: #F5F5F5;
-    }
-    #man div.man-navigation a { display:block; margin-bottom:1.5ex }
-    #man h1, #man h2, #man h3 { color:#232221;clear:left }
-    #man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
-    #man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
-    #man h3 { font-size:16px; margin:0 0 0 4ex; }
-    #man p, #man ul, #man ol, #man dl, #man pre { margin:0 0 18px 0; }
-    #man pre {
-      color:#333231;
-      background:#edeceb;
-      padding:5px 7px;
-      margin:0px 0 20px 0;
-      border-left:2ex solid #ddd}
-    #man pre + h2, #man pre + h3 {
-      margin-top:22px;
-    }
-    #man h2 + pre, #man h3 + pre {
-      margin-top:5px;
-    }
-    #man > p, #man > ul, #man > ol, #man > dl, #man > pre { margin-left:8ex; }
-    #man dt { margin:0; clear:left }
-    #man dt.flush { float:left; width:8ex }
-    #man dd { margin:0 0 0 9ex }
-    #man code, #man strong, #man b { font-weight:bold; color:#131211; }
-    #man pre code { font-weight:normal; color:#232221; background:inherit }
-    #man em, var, u {
-      font-style:normal; color:#333231; border-bottom:1px solid #999; }
-    #man h1.man-title { display:none; }
-    #man ol.man, #man ol.man li { margin:2px 0 10px 0; padding:0;
-      float:left; width:33%; list-style-type:none;
-      text-transform:uppercase; font-size:18px; color:#999;
-      letter-spacing:1px;}
-    #man ol.man { width:100%; }
-    #man ol.man li.tl { text-align:left }
-    #man ol.man li.tc { text-align:center;letter-spacing:4px }
-    #man ol.man li.tr { text-align:right; float: right }
-    #man ol.man a { color:#999 }
-    #man ol.man a:hover { color:#333231 }
-    #man img { display:block; margin:auto }
-  </style>
-  <style type='text/css' media='print'>
-    #man { max-width:none }
-    #man div.man-navigation { display:none }
-    #man a[href]:not([href^="#"]):not([data-bare-link]):after {
-      content:" " attr(href);
-    }
-  </style>
-</head>
-<body>
-<div id='man'>
-<div class='man-navigation'>
-  <a href="#NAME">NAME</a>
-  <a href="#ABOUT">ABOUT</a>
-  <a href="#SYNOPSIS">SYNOPSIS</a>
-  <a href="#DESCRIPTION">DESCRIPTION</a>
-  <a href="#OPTIONS">OPTIONS</a>
-  <a href="#SYNTAX">SYNTAX</a>
-  <a href="#EXAMPLES">EXAMPLES</a>
-  <a href="#HACKING">HACKING</a>
-  <a href="#VERSIONS">VERSIONS</a>
-  <a href="#CREDITS">CREDITS</a>
-  <a href="#LICENSE">LICENSE</a>
-  <a href="#SEE-ALSO">SEE ALSO</a>
-  </div>
-<h1 class='man-title'>ember(1)</h1>
-<ol class='head man'>
-  <li class='tl'>ember(1)</li>
-  <li class='tc'>Version 0.3.0</li>
-  <li class='tr'>ember(1)</li>
-</ol>
-<h2 id='NAME'>NAME</h2>
-<p><code>ember</code> - eRuby template processor</p>
-<h2 id="ABOUT">ABOUT</h2>
-<p>Ember (<em>EMBE</em>dded <em>R</em>uby) is an <a href="http://en.wikipedia.org/wiki/ERuby">eRuby template</a> processor that allows
-debugging, reduces markup, and improves composability of eRuby templates.</p>
-<h3 id="Features">Features</h3>
-<ul>
-<li><p>Reports correct line numbers in error message stack traces.</p></li>
-<li><p>Omits newlines trailing code-only <code>&lt;% ... %&gt;</code> directives.</p></li>
-<li><p>Can infer missing <code>&lt;% end %></code> directives based on indentation.</p></li>
-<li><p>Can unindent eRuby block bodies hierarchically.</p></li>
-<li><p>Written in 361 lines of pure
-Ruby.</p></li>
-</ul>
-<h3 id="Resources">Resources</h3>
-<dl>
-<dt>Issue tracker (report bugs, request features, get help)</dt><dd><p><a href="http://github.com/sunaku/ember/issues" data-bare-link="true">http://github.com/sunaku/ember/issues</a></p></dd>
-<dt>Source code (browse online or obtain with <a href="http://git-scm.com">Git</a>)</dt><dd><p><a href="http://github.com/sunaku/ember" data-bare-link="true">http://github.com/sunaku/ember</a></p></dd>
-<dt>API documentation</dt><dd><p><a href="http://snk.tuxfamily.org/lib/ember/api/" data-bare-link="true">http://snk.tuxfamily.org/lib/ember/api/</a></p></dd>
-<dt>Announcements feed</dt><dd><p><a href="http://snk.tuxfamily.org/lib/ember/ann.xml" data-bare-link="true">http://snk.tuxfamily.org/lib/ember/ann.xml</a></p></dd>
-<dt>Official website</dt><dd><p><a href="http://snk.tuxfamily.org/lib/ember/" data-bare-link="true">http://snk.tuxfamily.org/lib/ember/</a></p></dd>
-</dl>
-<h3 id="Setup">Setup</h3>
-<p>Prerequisites:</p>
-<ul>
-<li><p><a href="http://ruby-lang.org">Ruby</a> 1.8.6 or newer.</p></li>
-<li><p><a href="http://rubygems.org">RubyGems</a> 1.3.6 or newer.</p></li>
-</ul>
-<p>Installing:</p>
-<pre><code>gem install ember
-</code></pre>
-<p>Installing as a <a href="http://rubyonrails.org">Ruby on Rails</a> plugin:</p>
-<pre><code>script/plugin install git://github.com/sunaku/ember.git
-</code></pre>
-<p>Upgrading:</p>
-<pre><code>gem update ember
-</code></pre>
-<p>Removing:</p>
-<pre><code>gem uninstall ember
-</code></pre>
-<h2 id="SYNOPSIS">SYNOPSIS</h2>
-<p><code>ember</code> [<var>OPTIONS</var>] [<var>FILE</var>]</p>
-<h2 id="DESCRIPTION">DESCRIPTION</h2>
-<p>Evaluates eRuby directives (see <strong>SYNTAX</strong> below) in the given <var>FILE</var> and
-writes the result to the standard output stream (STDOUT).  If <var>FILE</var> is not
-given, then the standard input stream (STDIN) is evaluated instead.</p>
-<h2 id="OPTIONS">OPTIONS</h2>
-<dl>
-<dt><code>-s</code>, <code>--shorthand</code></dt><dd><p>Treat lines beginning with zero or more whitespace
-followed by the "%" character as eRuby directives.</p></dd>
-<dt><code>-i</code>, <code>--infer_end</code></dt><dd><p>Add missing <code>&lt;% end %></code> directives based on indentation.</p></dd>
-<dt><code>-u</code>, <code>--unindent</code></dt><dd><p>Unindent the bodies of directives that define a
-Ruby block (do ... end) or scope (begin ... end).</p></dd>
-<dt><code>-c</code>, <code>--compile</code></dt><dd><p>Print underlying Ruby program compiled
-from the input eRuby template and exit.</p></dd>
-<dt><code>-h</code>, <code>--help</code></dt><dd><p>Display this manual and exit.</p></dd>
-<dt><code>-v</code>, <code>--version</code></dt><dd><p>Print version number and exit.</p></dd>
-</dl>
-<h2 id="SYNTAX">SYNTAX</h2>
-<p>This section explains <a href="http://en.wikipedia.org/wiki/ERuby">eRuby template</a> syntax and Ember extensions thereof.</p>
-<p>eRuby templates are plain-text documents that contain special processing
-instructions known as <strong>directives</strong>.  These instructions are evaluated <em>in
-place</em>, meaning that they are replaced by the result of their evaluation.</p>
-<h3 id="Directives">Directives</h3>
-<p>Directives are expressed in either <strong>standard</strong> or <strong>shorthand</strong> notation:</p>
-<pre><code>Notation    Directive   Head   Operation   Body   Tail
---------    ---------   ----   ---------   ----   ----
-Standard    &lt;%XY%>      &lt;%     X           Y      %>
-Shorthand   %XY         %      X           Y
-</code></pre>
-<p>In standard notation, the directive is composed of a <strong>head</strong>, an
-<strong>operation</strong>, a <strong>body</strong>, and a <strong>tail</strong>; and it may appear anywhere in the
-template.</p>
-<p>In shorthand notation, the directive is composed of a <strong>head</strong>, an
-<strong>operation</strong>, and a <strong>body</strong>; and it may only appear in the template if it
-occupies an entire line (leading whitespace is permitted only in Ember;
-trailing whitespace is permitted in both Ember and eRuby).</p>
-<p>Regardless of the notation used, directives are atomic constructs; they cannot
-be nested within one another.</p>
-<h3 id="Operations">Operations</h3>
-<p>The first character following the head of a directive is known as an
-<strong>operation</strong>.  It determines how the directive is processed by Ember.</p>
-<dl>
-<dt class="flush"><code>#</code></dt><dd><p>The entire directive is omitted from the output.</p></dd>
-<dt class="flush"><code>=</code></dt><dd><p>The body of the directive is evaluated as Ruby code, and the result of
-this evaluation is inserted into the output.</p></dd>
-<dt class="flush"><code>~</code></dt><dd><p>(only in Ember) The body of the directive is evaluated as an eRuby
-template, and the result of this evaluation is inserted into the output.</p></dd>
-<dt class="flush"><code>+</code></dt><dd><p>(only in Ember) The body of the directive is evaluated as Ruby code, and
-the result of this evaluation is assumed to be a string that specifies the
-path (either absolute or relative to the eRuby template file in which this
-directive is found) to a file containing an eRuby template.  This file is
-read and its contents are evaluated as an eRuby template, and the result
-of this evaluation is inserted into the output.</p></dd>
-<dt class="flush"><code>&lt;</code></dt><dd><p>(only in Ember) The body of the directive is evaluated as Ruby code, and
-the result of this evaluation is assumed to be a string that specifies the
-path (either absolute or relative to the eRuby template file in which this
-directive is found) to a file.  This file is read and its contents are
-inserted into the output.</p></dd>
-<dt class="flush"><code>|</code></dt><dd><p>(only in Ember) The body of the directive is treated as the beginning of a
-Ruby block.  The <code>do</code> keyword is automatically appended to the body of the
-directive if missing.</p></dd>
-<dt class="flush"><code>%</code></dt><dd><p>One "%" character is omitted from the head of the directive and the entire
-directive is inserted into the output.</p></dd>
-<dt>None of the above</dt><dd><p>The body of the directive is evaluated as Ruby code, but the result of
-this evaluation <em>is not</em> inserted into the output.</p></dd>
-</dl>
-<h2 id="EXAMPLES">EXAMPLES</h2>
-<p>Begin by loading Ember into Ruby:</p>
-<pre><code>require 'rubygems' # might not be necessary; see HACKING
-require 'ember'
-</code></pre>
-<p>Instantiate an Ember template processor:</p>
-<pre><code>source   = "your eRuby template here"
-options  = {} # see API documentation
-template = Ember::Template.new(source, options)
-</code></pre>
-<p>Inspect the Ruby program that was compiled (and is used) by the Ember
-template processor to evaluate the eRuby template given as input:</p>
-<pre><code>puts template.program
-</code></pre>
-<p>View the result of evaluating the eRuby template:</p>
-<pre><code>puts template.render
-</code></pre>
-<p>See the API documentation for more information.</p>
-<h3 id="An-empty-template">An empty template</h3>
-<pre></pre>
-<p>The above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre></pre>
-<h3 id="Comment-directives">Comment directives</h3>
-<pre><code>&lt;%# this is a comment %>
-%# this is also a comment
-&lt;%# this
-is
-    a
-multi-line comment %>
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre>
-</pre>
-<h3 id="Escaped-directives">Escaped directives</h3>
-<pre><code>&lt;%% this is an escaped directive %>
-%% this is an escaped directive
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; "&lt;% this is an escaped directive %>\n"
-_erbout &lt;&lt; "% this is an escaped directive\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>&lt;% this is an escaped directive %>
-% this is an escaped directive
-</code></pre>
-<h3 id="Vocal-directives">Vocal directives</h3>
-<pre><code>&lt;%= "hello" %>
-%= "world"
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; ("hello") &lt;&lt; "\n"
-_erbout &lt;&lt; ("world") &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>hello
-world
-</code></pre>
-<h3 id="Silent-directives">Silent directives</h3>
-<pre><code>&lt;% a = "hello" %>
-% b = "world"
-&lt;%= a %>
-%= b
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  a = "hello"
- b = "world"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; (a) &lt;&lt; "\n"
-_erbout &lt;&lt; (b) &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>hello
-world
-</code></pre>
-<h3 id="Block-directives">Block directives</h3>
-<pre><code>% words = %w[hello world]
-&lt;% words.each do |w| %&gt;
-  &lt;%= w %>
-&lt;% end %>
-% words.each do |w|
-  %= w
-% end
-%|words.each |w|
-  %= w
-% end
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  words = %w[hello world]
-_erbout &lt;&lt; "\n"
- words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
- end
-_erbout &lt;&lt; "\n"
- words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
- end
-_erbout &lt;&lt; "\n"
-words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>  hello
-  world
-  hello
-  world
-  hello
-  world
-</code></pre>
-<h3 id="Unindent-block-content">Unindent block content</h3>
-<pre><code>&lt;% [1].each do |i| %&gt;
-  &lt;%= i %>
-    % [2].each do |j|
-      %= j
-              %|[3].each |k|
-                   %= k
-              % end
-    % end
-&lt;% end %>
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  [1].each do |i|
-_erbout &lt;&lt; (i) &lt;&lt; "\n"
- [2].each do |j|
-_erbout &lt;&lt; (j) &lt;&lt; "\n"
-[3].each do |k|
-_erbout &lt;&lt; (k) &lt;&lt; "\n"
- end
- end
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>1
-2
-3
-</code></pre>
-<h3 id="Wrap-block-content">Wrap block content</h3>
-<p>In this manner, you can create domain specific languages in eRuby.</p>
-<pre><code>&lt;%
-  def introducing(subject, &amp;block)
-    Ember::Template.wrap_content_block(block, rand(10)) do |content|
-      "And now I would like to introduce #{subject}:\n\n#{content.join}"
-    end
-  end
-  def coin_toss(pronoun, &amp;block)
-    Ember::Template.wrap_content_block(block) do |content|
-      "#{pronoun} favorite side of a coin toss is #{content.join}."
-    end
-  end
- %&gt;
-% introducing "Matz" do |number|
-  Father of the Ruby programming language,
-  and also a jolly and well mannered fellow.
-  % coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
-% end
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
-  def introducing(subject, &amp;block)
-    Ember::Template.wrap_content_block(block, rand(10)) do |content|
-      "And now I would like to introduce #{subject}:\n\n#{content.join}"
-    end
-  end
-  def coin_toss(pronoun, &amp;block)
-    Ember::Template.wrap_content_block(block) do |content|
-      "#{pronoun} favorite side of a coin toss is #{content.join}."
-    end
-  end
-_erbout &lt;&lt; "\n"
- introducing "Matz" do |number|
-_erbout &lt;&lt; "Father of the Ruby programming language,\n"
-_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
-_erbout &lt;&lt; "\n"
- coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>And now I would like to introduce Matz:
-Father of the Ruby programming language,
-and also a jolly and well mannered fellow.
-His favorite side of a coin toss is tails.
-</code></pre>
-<h3 id="Capture-block-content">Capture block content</h3>
-<p>In this manner, you can create domain specific languages in eRuby.</p>
-<pre><code>&lt;%
-  def introducing(subject, &amp;block)
-    content = Ember::Template.content_from_block(block, rand(2))
-    buffer = Ember::Template.buffer_from_block(block)
-    buffer &lt;&lt; "introducing(#{subject.inspect}):\n\n#{content.join}"
-  end
-  def coin_toss(pronoun, &amp;block)
-    content = Ember::Template.content_from_block(block)
-    buffer = Ember::Template.buffer_from_block(block)
-    buffer &lt;&lt; "coin_toss(#{pronoun.inspect}): #{content.join}"
-  end
- %&gt;
-% introducing "Matz" do |number|
-  Father of the Ruby programming language,
-  and also a jolly and well mannered fellow.
-  % coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
-% end
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
-  def introducing(subject, &amp;block)
-    content = Ember::Template.content_from_block(block, rand(2))
-    buffer = Ember::Template.buffer_from_block(block)
-    buffer &lt;&lt; "introducing(#{subject.inspect}):\n\n#{content.join}"
-  end
-  def coin_toss(pronoun, &amp;block)
-    content = Ember::Template.content_from_block(block)
-    buffer = Ember::Template.buffer_from_block(block)
-    buffer &lt;&lt; "coin_toss(#{pronoun.inspect}): #{content.join}"
-  end
-_erbout &lt;&lt; "\n"
- introducing "Matz" do |number|
-_erbout &lt;&lt; "Father of the Ruby programming language,\n"
-_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
-_erbout &lt;&lt; "\n"
- coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>introducing("Matz"):
-Father of the Ruby programming language,
-and also a jolly and well mannered fellow.
-coin_toss("His"): heads
-</code></pre>
-<h3 id="Template-evaluation-result-buffer">Template evaluation result buffer</h3>
-<p>In this manner, you can create domain specific languages in eRuby.</p>
-<pre><code>&lt;%
-  def introducing(subject, &amp;block)
-    buffer = Ember::Template.buffer_from_block(block)
-    #
-    # you can do whatever you want with buffer,
-    # now that you have a reference to it! &gt;:-)
-    #
-    buffer &lt;&lt; "introducing(#{subject.inspect})"
-  end
- %&gt;
-% introducing "Matz" do |number|
-  Father of the Ruby programming language,
-  and also a jolly and well mannered fellow.
-% end
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :unindent=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
-  def introducing(subject, &amp;block)
-    buffer = Ember::Template.buffer_from_block(block)
-    #
-    # you can do whatever you want with buffer,
-    # now that you have a reference to it! &gt;:-)
-    #
-    buffer &lt;&lt; "introducing(#{subject.inspect})"
-  end
-_erbout &lt;&lt; "\n"
- introducing "Matz" do |number|
-_erbout &lt;&lt; "Father of the Ruby programming language,\n"
-_erbout &lt;&lt; "and also a jolly and well mannered fellow.\n"
- end
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>introducing("Matz")
-</code></pre>
-<h3 id="Infer-block-endings">Infer block endings</h3>
-<p>Omit <code>&lt;% end %></code> directives from the template:</p>
-<pre><code>% words = %w[hello world]
-&lt;% words.each do |w| %&gt;
-  &lt;%= w %>
-% words.each do |w|
-  %= w
-%|words.each |w|
-  %= w
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :infer_end=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  words = %w[hello world]
-_erbout &lt;&lt; "\n"
- words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
-end; _erbout &lt;&lt; "\n"
- words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
-end; _erbout &lt;&lt; "\n"
-words.each do |w|
-_erbout &lt;&lt; "  " &lt;&lt; (w) &lt;&lt; "\n"
-end; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>  hello
-  world
-  hello
-  world
-  hello
-  world
-</code></pre>
-<h3 id="Raw-file-inclusion">Raw file inclusion</h3>
-<p>When <code>doc/example.txt</code> contains:</p>
-<pre><code>This is a plain-text file.  Notice that &lt;%=
-"eRuby directives" %> have no effect here!
-</code></pre>
-<p>And the eRuby template is:</p>
-<pre><code>&lt;%&lt; "doc/example.txt" %&gt;
-%&lt; "doc/example.txt"
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-_erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>This is a plain-text file.  Notice that &lt;%=
-"eRuby directives" %> have no effect here!
-This is a plain-text file.  Notice that &lt;%=
-"eRuby directives" %> have no effect here!
-</code></pre>
-<h3 id="Template-file-inclusion">Template file inclusion</h3>
-<p>When <code>doc/example.erb</code> contains:</p>
-<pre><code>This is an eRuby template.  Notice that &lt;%=
-"eRuby directives" %> do take effect here!
-</code></pre>
-<p>And the eRuby template is:</p>
-<pre><code>&lt;%+ "doc/example.erb" %&gt;
-%+ "doc/example.erb"
-</code></pre>
-<p>With <code>{:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>This is an eRuby template.  Notice that eRuby directives do take effect here!
-This is an eRuby template.  Notice that eRuby directives do take effect here!
-</code></pre>
-<h3 id="Dynamic-template-evaluation">Dynamic template evaluation</h3>
-<pre><code>&lt;%~ "%= 2 + 2" %>
-%~ "%= 2 + 2"
-</code></pre>
-<p>With <code>{:shorthand=&gt;true}</code> options, the above template compiles into:</p>
-<pre><code>(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; "\n"
-::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(::Kernel.binding); _erbout &lt;&lt; "\n"
-; _erbout.join)
-</code></pre>
-<p>And renders as:</p>
-<pre><code>4
-4
-</code></pre>
-<h2 id="HACKING">HACKING</h2>
-<p>This section is meant for people who want to develop Ember's source code.</p>
-<h3 id="Prerequisites">Prerequisites</h3>
-<p>Install Ruby libraries necessary for development:</p>
-<pre><code>gem install ember --development
-</code></pre>
-<h3 id="Infrastructure">Infrastructure</h3>
-<p><a href="http://snk.tuxfamily.org/lib/inochi/">Inochi</a> serves as the project infrastructure for Ember.  It handles tasks
-such as building this help manual and API documentation, and packaging,
-announcing, and publishing new releases.  See its help manual and list of
-tasks to get started:</p>
-<pre><code>inochi --help     # display help manual
-inochi --tasks    # list available tasks
-</code></pre>
-<h3 id="-LOAD_PATH-setup">$LOAD_PATH setup</h3>
-<p>Ensure that the <code>lib/</code> directory is listed in Ruby's <code>$LOAD_PATH</code> before you
-use any libraries therein or run any executables in the <code>bin/</code> directory.</p>
-<p>This can be achieved by passing an option to Ruby:</p>
-<pre><code>ruby -Ilib bin/ember
-irb -Ilib -r ember
-</code></pre>
-<p>Or by setting the <code>$RUBYLIB</code> environment variable:</p>
-<pre><code>export RUBYLIB=lib   # bash, ksh, zsh
-setenv RUBYLIB lib   # csh
-set -x RUBYLIB lib   # fish
-ruby bin/ember
-irb -r ember
-</code></pre>
-<p>Or by installing the <a href="http://github.com/chneukirchen/rup">ruby-wrapper</a> tool.</p>
-<h3 id="RubyGems-setup">RubyGems setup</h3>
-<p>If you use Ruby 1.8 or older, then ensure that RubyGems is activated before
-you use any libraries in the <code>lib/</code> directory or run any executables in the
-<code>bin/</code> directory.</p>
-<p>This can be achieved by passing an option to Ruby:</p>
-<pre><code>ruby -rubygems bin/ember
-irb -rubygems -r ember
-</code></pre>
-<p>Or by setting the <code>$RUBYOPT</code> environment variable:</p>
-<pre><code>export RUBYOPT=-rubygems   # bash, ksh, zsh
-setenv RUBYOPT -rubygems   # csh
-set -x RUBYOPT -rubygems   # fish
-</code></pre>
-<h3 id="Running-tests">Running tests</h3>
-<p>Simply execute the included test runner, which sets up Ruby's <code>$LOAD_PATH</code> for
-testing, loads the included <code>test/test_helper.rb</code> file, and then evaluates all
-<code>test/**/*_test.rb</code> files:</p>
-<pre><code>test/runner
-</code></pre>
-<p>Its exit status will indicate whether all tests have passed.  It may also
-print additional pass/fail information depending on the testing library used
-in the <code>test/test_helper.rb</code> file.</p>
-<h3 id="Contributing">Contributing</h3>
-<p>Fork this project on GitHub (see <strong>Resources</strong> above) and send a pull request.</p>
-<h2 id="VERSIONS">VERSIONS</h2>
-<p>This section contains release notes of current and past releases.</p>
-<h3 id="Version-0-3-0-2010-04-26-">Version 0.3.0 (2010-04-26)</h3>
-<p>This release adds <em>class methods</em> that let you (portably and more easily)
-create your own domain specific languages in eRuby; adds more usage
-<strong>EXAMPLES</strong> in the help manual; and removes a binding inheritance hack.</p>
-<p>New features:</p>
-<dl>
-<dt><code>Ember::Template::wrap_content_block()</code></dt><dd><p>Wraps eRuby block content appending.</p></dd>
-<dt><code>Ember::Template::content_from_block()</code></dt><dd><p>Extracts content from eRuby blocks.</p></dd>
-<dt><code>Ember::Template::buffer_from_block()</code></dt><dd><p>Gives access to template evalutaion result buffer.</p></dd>
-</dl>
-<p>Bug fixes:</p>
-<ul>
-<li>Remove hack for inheriting parent template binding.</li>
-</ul>
-<p>Housekeeping:</p>
-<ul>
-<li><p>Add example on unindenting node content and eRuby DSL examples that use
-the new content block methods.</p></li>
-<li><p>Simplify code examples using the new wrap_content_block() method.</p></li>
-</ul>
-<h3 id="Version-0-2-0-2010-04-25-">Version 0.2.0 (2010-04-25)</h3>
-<p>This release adds <a href="http://rubyonrails.org">Ruby on Rails</a> integration.</p>
-<p>New features:</p>
-<ul>
-<li><p>Ember can now be used directly as a <a href="http://rubyonrails.org">Ruby on Rails</a> (2.3 or newer) plugin.
-The plugin registers Ember as the default Rails template handler for "erb"
-and "rhtml" file types.  Ember processing options can be set in the Rails
-environment file:</p>
-<pre><code>ActionView::TemplateHandlers::Ember.options = {
-  :unindent =&gt; true,
-  :shorthand =&gt; true,
-  :infer_end =&gt; true
-}
-</code></pre>
-<p>This feature was contributed by Kamil Kukura.</p></li>
-</ul>
-<h3 id="Version-0-1-1-2010-04-20-">Version 0.1.1 (2010-04-20)</h3>
-<p>This release fixes a nested rendering bug, updates the manual, and further
-beautifies the Ruby code that results from eRuby template compilation.</p>
-<p>Bug fixes:</p>
-<ul>
-<li><p><code>Ember::Template#render()</code> now creates isolated contexts by default to
-prevent nested calls from clobbering each other's output!</p>
-<p>For example, if template A calls method X which renders template B
-(thinking that template B's rendering is isolated and will not affect the
-rendering of template A) then you're in for a wild bug chase!  >8-(</p></li>
-</ul>
-<p>Housekeeping:</p>
-<ul>
-<li><p>Upgrade to Inochi 2.0.0rc5.  Convert manual from ERBook to Ember + Ronn.</p></li>
-<li><p>Remove spaces around value insertions in template compilation output.</p></li>
-<li><p>Remove logo images from source repository because they're no longer used.</p></li>
-</ul>
-<h3 id="Version-0-1-0-2010-04-03-">Version 0.1.0 (2010-04-03)</h3>
-<p>This release improves the handling of eRuby comment directives, fixes a bug
-in the <code>&lt;% end %></code> inference logic, and performs some minor housekeeping.</p>
-<p>New features:</p>
-<ul>
-<li><p>Single-line comment directives are now ignored (treated like no-ops)
-in input templates.  This allows us to surround eRuby block directives
-with section separators made from single-line comment directives:</p>
-<pre><code>%|some_block_directive
-  Inside some_block_directive.
-%#-------------------------------------------------------------------
-  Still inside some_block_directive!
-  %#-----------------------------------------------------------------
-  %| nested_block_directive
-  %#-----------------------------------------------------------------
-    Inside nested_block_directive.
-</code></pre></li>
-</ul>
-<p>Bug fixes:</p>
-<ul>
-<li><code>&lt;% end %></code> inference did not work for blocks
-beginning with <code>def</code>, <code>class</code>, and <code>module</code> keywords.</li>
-</ul>
-<p>Housekeeping:</p>
-<ul>
-<li>Upgrade to Inochi 2.0.0-rc3.  This project no longer
-depends on the "inochi" or "trollop" gems at runtime.</li>
-</ul>
-<h3 id="Version-0-0-1-2009-10-03-">Version 0.0.1 (2009-10-03)</h3>
-<p>This release improves Ruby 1.9 support and revises the user manual.</p>
-<p>Bug fixes:</p>
-<ul>
-<li>Nested templates could not access parent's binding in Ruby 1.9</li>
-</ul>
-<p>Housekeeping:</p>
-<ul>
-<li><p>Use simpler Copyright reminder at the top of every file.</p></li>
-<li><p>Rename internal <code>Program</code> class' methods to be self-documenting.</p></li>
-<li><p>Open source is for fun, so <a href="http://loiclemeur.com/english/2009/03/never-criticize-your-competitors.html">be nice</a> and speak of "related works" instead of "competitors".</p></li>
-</ul>
-<h3 id="Version-0-0-0-2009-02-13-">Version 0.0.0 (2009-02-13)</h3>
-<p>This is the first public release of Ember.  Enjoy!</p>
-<h2 id="CREDITS">CREDITS</h2>
-<p>Suraj N. Kurapati,
-Kamil Kukura</p>
-<h2 id="LICENSE">LICENSE</h2>
-<p>(the ISC license)</p>
-<p>Copyright 2009 Suraj N. Kurapati <a href="&#x6d;&#97;&#x69;&#108;&#116;&#x6f;&#x3a;&#115;&#117;&#x6e;&#x61;&#107;&#x75;&#64;&#103;&#109;&#x61;&#x69;&#x6c;&#x2e;&#99;&#111;&#109;" data-bare-link="true">&#x73;&#117;&#110;&#97;&#x6b;&#x75;&#64;&#x67;&#109;&#97;&#105;&#108;&#x2e;&#x63;&#x6f;&#x6d;</a></p>
-<p>Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.</p>
-<p>THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.</p>
-<h2 id="SEE-ALSO">SEE ALSO</h2>
-<p>erb(1)</p>
-<ol class='foot man'>
-  <li class='tl'></li>
-  <li class='tc'>April 2010</li>
-  <li class='tr'>ember(1)</li>
-</ol>
-</div>
-</body>
-</html>