ember 0.3.0 → 0.3.1

data/bin/ember

@@ -3,16 +3,8 @@
 require 'ember'
 
 if ARGV.delete('-h') or ARGV.delete('--help')
-  # try to display UNIX version of help manual
-  man_path = File.join(Ember::INSTDIR, 'man')
-  unless system 'man', '-M', man_path, '-a', 'ember'
-    # try to display HTML version of help manual
-    man_html = man_path + '.html'
-    unless %w[$BROWSER open start].any? {|b| system "#{b} #{man_html}" }
-      # no luck; direct user to project website
-      puts "See #{Ember::WEBSITE}"
-    end
-  end
+  system 'man', '-M', File.join(Ember::INSTDIR, 'man'), 'ember' or
+  warn "Could not display the help manual.\nSee #{Ember::WEBSITE} instead."
   exit
 elsif ARGV.delete('-v') or ARGV.delete('--version')
   puts Ember::VERSION

data/lib/ember/inochi.rb

@@ -3,27 +3,27 @@ module Ember
   ##
   # Official name of this project.
   #
-  PROJECT = "Ember"
+  PROJECT = 'Ember'
 
   ##
   # Short single-line description of this project.
   #
-  TAGLINE = "eRuby template processor"
+  TAGLINE = 'eRuby template processor'
 
   ##
   # Address of this project's official home page.
   #
-  WEBSITE = "http://snk.tuxfamily.org/lib/ember/"
+  WEBSITE = 'http://snk.tuxfamily.org/lib/ember/'
 
   ##
   # Number of this release of this project.
   #
-  VERSION = "0.3.0"
+  VERSION = '0.3.1'
 
   ##
   # Date of this release of this project.
   #
-  RELDATE = "2010-04-26"
+  RELDATE = '2011-04-22'
 
   ##
   # Description of this release of this project.
@@ -42,62 +42,18 @@ module Ember
   #
   # @example
   #
-  #   RUNTIME = {
+  #   GEMDEPS = {
   #     # this project needs exactly version 1.2.3 of the "an_example" gem
-  #     "an_example" => [ "1.2.3" ],
+  #     'an_example' => [ '1.2.3' ],
   #
   #     # this project needs at least version 1.2 (but not
   #     # version 1.2.4 or newer) of the "another_example" gem
-  #     "another_example" => [ ">= 1.2" , "< 1.2.4" ],
+  #     'another_example' => [ '>= 1.2' , '< 1.2.4' ],
   #
   #     # this project needs any version of the "yet_another_example" gem
-  #     "yet_another_example" => [],
+  #     'yet_another_example' => [],
   #   }
   #
-  RUNTIME = {}
-
-  ##
-  # RubyGems required by this project during development.
-  #
-  # @example
-  #
-  #   DEVTIME = {
-  #     # this project needs exactly version 1.2.3 of the "an_example" gem
-  #     "an_example" => [ "1.2.3" ],
-  #
-  #     # this project needs at least version 1.2 (but not
-  #     # version 1.2.4 or newer) of the "another_example" gem
-  #     "another_example" => [ ">= 1.2" , "< 1.2.4" ],
-  #
-  #     # this project needs any version of the "yet_another_example" gem
-  #     "yet_another_example" => [],
-  #   }
-  #
-  DEVTIME = {
-    "inochi" => [ "~> 2" ], # for managing this project
-    "dfect"  => [ "~> 2" ], # for unit testing
-  }
-
-  ##
-  # Loads the correct version (as defined by the {RUNTIME} or {DEVTIME}
-  # constant in this module) of the given gem or the gem that contains
-  # the given library.
-  #
-  def self.require gem_name_or_library
-    # prepare the correct version of the gem for loading
-    if respond_to? :gem
-      gem_name = gem_name_or_library.to_s.sub(%r{/.*$}, '')
-      if gem_version = RUNTIME[gem_name] || DEVTIME[gem_name]
-        begin
-          gem gem_name, *gem_version
-        rescue LoadError => error
-          warn "#{self.inspect}: #{error}"
-        end
-      end
-    end
-
-    # do the loading
-    super
-  end
+  GEMDEPS = {}
 
 end

data/lib/ember/template.rb

@@ -161,7 +161,7 @@ module Ember
 
       def resolve_path path, options = {}
         unless Pathname.new(path).absolute?
-          if base = options[:source_file] and File.exist? base
+          if base = options[:source_file] and File.exist? base.to_s
             # target is relative to the file in
             # which the include directive exists
             path = File.join(File.dirname(base), path)

data/man/man1/ember.1

@@ -0,0 +1,1742 @@
+'\" t
+.\"     Title: ember
+.\"    Author: [see the "AUTHORS" section]
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\"      Date: 2011-04-22
+.\"    Manual: \ \&
+.\"    Source: \ \& 0.3.1
+.\"  Language: English
+.\"
+.TH "EMBER" "1" "2011\-04\-22" "\ \& 0\&.3\&.1" "\ \&"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+ember \- eRuby template processor
+.SH "SYNOPSIS"
+.sp
+\fBember\fR [\fIOPTIONS\fR] [\fIFILE\fR]
+.SS "Command"
+.sp
+Evaluates eRuby directives (see [SYNTAX] below) in the given \fIFILE\fR and writes the result to the standard output stream\&. If \fIFILE\fR is not given, then the standard input stream is read and evaluated instead\&.
+.SS "Options"
+.PP
+\fB\-s\fR, \fB\-\-shorthand\fR
+.RS 4
+Treat lines beginning with zero or more whitespace followed by the "%" character as eRuby directives\&.
+.RE
+.PP
+\fB\-i\fR, \fB\-\-infer_end\fR
+.RS 4
+Add missing "<% end %>" directives based on indentation\&.
+.RE
+.PP
+\fB\-u\fR, \fB\-\-unindent\fR
+.RS 4
+Unindent the bodies of directives that define a Ruby block (do \&... end) or scope (begin \&... end)\&.
+.RE
+.PP
+\fB\-c\fR, \fB\-\-compile\fR
+.RS 4
+Print underlying Ruby program compiled from the input eRuby template and exit\&.
+.RE
+.PP
+\fB\-h\fR, \fB\-\-help\fR
+.RS 4
+Display this manual and exit\&.
+.RE
+.PP
+\fB\-v\fR, \fB\-\-version\fR
+.RS 4
+Print version number and exit\&.
+.RE
+.SH "DESCRIPTION"
+.sp
+Ember (\fBEMBE\fRdded \fBR\fRuby) is an [eRuby] template processor that allows debugging, reduces markup, and improves composability of eRuby templates\&.
+.SS "Features"
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Reports correct line numbers in error message stack traces\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Omits newlines trailing code\-only
+<% \&.\&.\&. %>
+directives\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Can infer missing
+<% end %>
+directives based on indentation\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Can unindent eRuby block bodies hierarchically\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Implemented in 361 lines of pure Ruby\&.
+.RE
+.SS "Resources"
+.PP
+Project website
+.RS 4
+
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/ember/\fR\m[]
+.RE
+.PP
+Announcements feed
+.RS 4
+
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/ember/ann\&.xml\fR\m[]
+.RE
+.PP
+API documentation
+.RS 4
+
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/ember/api/\fR\m[]
+.RE
+.PP
+Source code (browse online, download, or checkout)
+.RS 4
+
+\m[blue]\fBhttp://github\&.com/sunaku/ember\fR\m[]
+.RE
+.PP
+Issue tracker (report bugs, request features, get help)
+.RS 4
+
+\m[blue]\fBhttp://github\&.com/sunaku/ember/issues\fR\m[]
+.RE
+.SH "INSTALL"
+.SS "Prerequisites"
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+[Ruby]
+1\&.8\&.6 or newer\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+[RubyGems]
+1\&.3\&.6 or newer\&.
+.RE
+.SS "Installing"
+.sp
+Installing as a [Ruby] library:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+gem install ember
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Installing as a [Rails] plugin:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+script/plugin install git://github\&.com/sunaku/ember\&.git
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Upgrading"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+gem update ember
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Removing"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+gem uninstall ember
+.fi
+.if n \{\
+.RE
+.\}
+.SH "SYNTAX"
+.sp
+This section explains [eRuby] template syntax and Ember extensions thereof\&.
+.sp
+eRuby templates are plain\-text documents that contain special processing instructions known as \fBdirectives\fR\&. These instructions are evaluated \fIin place\fR, meaning that they are replaced by the result of their evaluation\&.
+.SS "Directives"
+.sp
+Directives are expressed in either \fBstandard\fR or \fBshorthand\fR notation:
+.TS
+allbox tab(:);
+ltB ltB ltB ltB ltB ltB.
+T{
+Notation
+T}:T{
+Directive
+T}:T{
+Head
+T}:T{
+Operation
+T}:T{
+Body
+T}:T{
+Tail
+T}
+.T&
+lt lt lt lt lt lt
+lt lt lt lt lt lt.
+T{
+.sp
+Standard
+T}:T{
+.sp
+<%xy%>
+T}:T{
+.sp
+<%
+T}:T{
+.sp
+x
+T}:T{
+.sp
+y
+T}:T{
+.sp
+%>
+T}
+T{
+.sp
+Shorthand
+T}:T{
+.sp
+%xy
+T}:T{
+.sp
+%
+T}:T{
+.sp
+x
+T}:T{
+.sp
+y
+T}:T{
+.sp
+T}
+.TE
+.sp 1
+.sp
+In standard notation, the directive is composed of a \fBhead\fR, an \fBoperation\fR, a \fBbody\fR, and a \fBtail\fR; and it may appear anywhere in the template\&.
+.sp
+In shorthand notation, the directive is composed of a \fBhead\fR, an \fBoperation\fR, and a \fBbody\fR; 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)\&.
+.sp
+Regardless of the notation used, directives are atomic constructs; they cannot be nested within one another\&.
+.SS "Operations"
+.sp
+An \fBoperation\fR is the first character following the head of a directive\&. It specifies how the directive will be processed\&.
+.sp
+Ember supports the following operations, and here is what they do:
+.TS
+tab(:);
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt.
+T{
+.sp
+%
+T}:T{
+.sp
+One "%" character is omitted from the head of the directive and the entire directive is inserted into the output\&.
+T}
+T{
+.sp
+#
+T}:T{
+.sp
+The entire directive is omitted from the output\&.
+T}
+T{
+.sp
+=
+T}:T{
+.sp
+The body of the directive is evaluated as Ruby code, and the result of this evaluation is inserted into the output\&.
+T}
+T{
+.sp
+~
+T}:T{
+.sp
+(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\&.
+T}
+T{
+.sp
++
+T}:T{
+.sp
+(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\&.
+T}
+T{
+.sp
+<
+T}:T{
+.sp
+(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\&.
+T}
+T{
+.sp
+|
+T}:T{
+.sp
+(only in Ember) The body of the directive is treated as the beginning of a Ruby block\&. The \fBdo\fR keyword is automatically appended to the body of the directive if missing\&.
+T}
+T{
+.sp
+None of the above
+T}:T{
+.sp
+The body of the directive is evaluated as Ruby code, but the result of this evaluation \fIis not\fR inserted into the output\&.
+T}
+.TE
+.sp 1
+.SH "USAGE"
+.sp
+Begin by loading the Ember library into your program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+require \*(Aqrubygems\*(Aq # might not be necessary; see HACKING
+require \*(Aqember\*(Aq
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Instantiate an Ember template processor:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+source   = "your eRuby template here"
+options  = {} # see API documentation
+template = Ember::Template\&.new(source, options)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Inspect the Ruby program that was compiled (and is used) by the Ember template processor to evaluate the eRuby template given as input:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+puts template\&.program
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+View the result of evaluating the eRuby template:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+puts template\&.render
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+See the \m[blue]\fBAPI documentation\fR\m[] for more information\&.
+.SS "An empty template"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+The above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Comment directives"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%# this is a comment %>
+%# this is also a comment
+<%# this
+is
+        a
+multi\-line comment %>
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout << "\en"
+_erbout << "\en"
+
+
+
+
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Escaped directives"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%% this is an escaped directive %>
+%% this is an escaped directive
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout << "<% this is an escaped directive %>\en"
+_erbout << "% this is an escaped directive\en"
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<% this is an escaped directive %>
+% this is an escaped directive
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Vocal directives"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%= "hello" %>
+%= "world"
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout << ("hello") << "\en"
+_erbout << ("world") << "\en"
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+hello
+world
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Silent directives"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<% a = "hello" %>
+% b = "world"
+
+<%= a %>
+%= b
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  a = "hello"
+ b = "world"
+_erbout << "\en"
+_erbout << (a) << "\en"
+_erbout << (b) << "\en"
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+hello
+world
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Block directives"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+% words = %w[hello world]
+
+<% words\&.each do |w| %>
+  <%= w %>
+<% end %>
+
+% words\&.each do |w|
+  %= w
+% end
+
+%|words\&.each |w|
+  %= w
+% end
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  words = %w[hello world]
+_erbout << "\en"
+ words\&.each do |w|
+_erbout << "  " << (w) << "\en"
+ end
+_erbout << "\en"
+ words\&.each do |w|
+_erbout << "  " << (w) << "\en"
+ end
+_erbout << "\en"
+words\&.each do |w|
+_erbout << "  " << (w) << "\en"
+ end
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+  hello
+  world
+
+  hello
+  world
+
+  hello
+  world
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Unindent block content"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<% [1]\&.each do |i| %>
+  <%= i %>
+    % [2]\&.each do |j|
+      %= j
+              %|[3]\&.each |k|
+                   %= k
+              % end
+    % end
+<% end %>
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true, :unindent=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  [1]\&.each do |i|
+_erbout << (i) << "\en"
+ [2]\&.each do |j|
+_erbout << (j) << "\en"
+[3]\&.each do |k|
+_erbout << (k) << "\en"
+ end
+ end
+ end
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+1
+2
+3
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Wrap block content"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%
+  def introducing(subject, &block)
+    Ember::Template\&.wrap_content_block(block, rand(10)) do |content|
+      "And now I would like to introduce #{subject}:\en\en#{content\&.join}"
+    end
+  end
+
+  def coin_toss(pronoun, &block)
+    Ember::Template\&.wrap_content_block(block) do |content|
+      "#{pronoun} favorite side of a coin toss is #{content\&.join}\&."
+    end
+  end
+ %>
+
+% 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
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true, :unindent=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
+  def introducing(subject, &block)
+    Ember::Template\&.wrap_content_block(block, rand(10)) do |content|
+      "And now I would like to introduce #{subject}:\en\en#{content\&.join}"
+    end
+  end
+
+  def coin_toss(pronoun, &block)
+    Ember::Template\&.wrap_content_block(block) do |content|
+      "#{pronoun} favorite side of a coin toss is #{content\&.join}\&."
+    end
+  end
+
+_erbout << "\en"
+ introducing "Matz" do |number|
+_erbout << "Father of the Ruby programming language,\en"
+_erbout << "and also a jolly and well mannered fellow\&.\en"
+_erbout << "\en"
+ coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
+ end
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+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 heads\&.
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Capture block content"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%
+  def introducing(subject, &block)
+    content = Ember::Template\&.content_from_block(block, rand(2))
+
+    buffer = Ember::Template\&.buffer_from_block(block)
+    buffer << "introducing(#{subject\&.inspect}):\en\en#{content\&.join}"
+  end
+
+  def coin_toss(pronoun, &block)
+    content = Ember::Template\&.content_from_block(block)
+
+    buffer = Ember::Template\&.buffer_from_block(block)
+    buffer << "coin_toss(#{pronoun\&.inspect}): #{content\&.join}"
+  end
+ %>
+
+% 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
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true, :unindent=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
+  def introducing(subject, &block)
+    content = Ember::Template\&.content_from_block(block, rand(2))
+
+    buffer = Ember::Template\&.buffer_from_block(block)
+    buffer << "introducing(#{subject\&.inspect}):\en\en#{content\&.join}"
+  end
+
+  def coin_toss(pronoun, &block)
+    content = Ember::Template\&.content_from_block(block)
+
+    buffer = Ember::Template\&.buffer_from_block(block)
+    buffer << "coin_toss(#{pronoun\&.inspect}): #{content\&.join}"
+  end
+
+_erbout << "\en"
+ introducing "Matz" do |number|
+_erbout << "Father of the Ruby programming language,\en"
+_erbout << "and also a jolly and well mannered fellow\&.\en"
+_erbout << "\en"
+ coin_toss("His") { number % 2 == 0 ? "heads" : "tails" }
+ end
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+introducing("Matz"):
+
+Father of the Ruby programming language,
+and also a jolly and well mannered fellow\&.
+
+coin_toss("His"): heads
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Template evaluation result buffer"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%
+  def introducing(subject, &block)
+    buffer = Ember::Template\&.buffer_from_block(block)
+    #
+    # you can do whatever you want with buffer,
+    # now that you have a reference to it! >:\-)
+    #
+    buffer << "introducing(#{subject\&.inspect})"
+  end
+ %>
+
+% introducing "Matz" do |number|
+  Father of the Ruby programming language,
+  and also a jolly and well mannered fellow\&.
+% end
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true, :unindent=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];
+  def introducing(subject, &block)
+    buffer = Ember::Template\&.buffer_from_block(block)
+    #
+    # you can do whatever you want with buffer,
+    # now that you have a reference to it! >:\-)
+    #
+    buffer << "introducing(#{subject\&.inspect})"
+  end
+
+_erbout << "\en"
+ introducing "Matz" do |number|
+_erbout << "Father of the Ruby programming language,\en"
+_erbout << "and also a jolly and well mannered fellow\&.\en"
+ end
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+introducing("Matz")
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Infer block endings"
+.sp
+Omit <% end %> directives from the template:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+% words = %w[hello world]
+
+<% words\&.each do |w| %>
+  <%= w %>
+
+% words\&.each do |w|
+  %= w
+
+%|words\&.each |w|
+  %= w
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true, :infer_end=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = [];  words = %w[hello world]
+_erbout << "\en"
+ words\&.each do |w|
+_erbout << "  " << (w) << "\en"
+end; _erbout << "\en"
+ words\&.each do |w|
+_erbout << "  " << (w) << "\en"
+end; _erbout << "\en"
+words\&.each do |w|
+_erbout << "  " << (w) << "\en"
+end; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+  hello
+  world
+
+  hello
+  world
+
+  hello
+  world
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Raw file inclusion"
+.sp
+When doc/example\&.txt contains:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+This is a plain\-text file\&.  Notice that <%=
+"eRuby directives" %> have no effect here!
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+And the eRuby template is:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%< "doc/example\&.txt" %>
+
+%< "doc/example\&.txt"
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true, :source_file=>"\&./USAGE"} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; _erbout << (::Ember::Template\&.read_file(("doc/example\&.txt"), {:shorthand=>true, :source_file=>"\&./USAGE"})) << "\en"
+_erbout << "\en"
+_erbout << (::Ember::Template\&.read_file(("doc/example\&.txt"), {:shorthand=>true, :source_file=>"\&./USAGE"})) << "\en"
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+This is a plain\-text file\&.  Notice that <%=
+"eRuby directives" %> have no effect here!
+
+This is a plain\-text file\&.  Notice that <%=
+"eRuby directives" %> have no effect here!
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Template file inclusion"
+.sp
+When doc/example\&.erb contains:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+This is an eRuby template\&.  Notice that <%=
+"eRuby directives" %> do take effect here!
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+And the eRuby template is:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%+ "doc/example\&.erb" %>
+
+%+ "doc/example\&.erb"
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true, :source_file=>"\&./USAGE"} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ::Ember::Template\&.load_file(("doc/example\&.erb"), {:shorthand=>true, :source_file=>"\&./USAGE"}\&.merge!(:continue_result => true))\&.render(::Kernel\&.binding); _erbout << "\en"
+_erbout << "\en"
+::Ember::Template\&.load_file(("doc/example\&.erb"), {:shorthand=>true, :source_file=>"\&./USAGE"}\&.merge!(:continue_result => true))\&.render(::Kernel\&.binding); _erbout << "\en"
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+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!
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Dynamic template evaluation"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+<%~ "%= 2 + 2" %>
+
+%~ "%= 2 + 2"
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+With {:shorthand=>true} options, the above template compiles into the following Ruby program:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(e08afdfb_62c7_485f_87a0_80914e1b4703 = :_erbout; _erbout = []; ::Ember::Template\&.new(("%= 2 + 2"), {:shorthand=>true}\&.merge!(:continue_result => true))\&.render(::Kernel\&.binding); _erbout << "\en"
+_erbout << "\en"
+::Ember::Template\&.new(("%= 2 + 2"), {:shorthand=>true}\&.merge!(:continue_result => true))\&.render(::Kernel\&.binding); _erbout << "\en"
+; _erbout\&.join)
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Which then produces the following output when rendered:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+4
+
+4
+.fi
+.if n \{\
+.RE
+.\}
+.SH "HACKING"
+.SS "Prerequisites"
+.sp
+Install Ruby libraries necessary for development using [Bundler]:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+bundle install
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Infrastructure"
+.sp
+[Inochi] 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:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+inochi \-\-help     # display help manual
+inochi \-\-tasks    # list available tasks
+.fi
+.if n \{\
+.RE
+.\}
+.SS "$LOAD_PATH setup"
+.sp
+Ensure that the lib/ directory is listed in Ruby\(cqs $LOAD_PATH before you use any libraries therein or run any executables in the bin/ directory\&.
+.sp
+This can be achieved by passing an option to Ruby:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby \-Ilib bin/ember
+irb \-Ilib \-r ember
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Or by setting the $RUBYLIB environment variable:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+export RUBYLIB=lib   # bash, ksh, zsh
+setenv RUBYLIB lib   # csh
+set \-x RUBYLIB lib   # fish
+
+ruby bin/ember
+irb \-r ember
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Or by running Ruby through the \m[blue]\fBruby\-wrapper\fR\m[]\&\s-2\u[1]\d\s+2 tool\&.
+.SS "RubyGems setup"
+.sp
+If you use Ruby 1\&.8 or older, then ensure that RubyGems is activated before you use any libraries in the lib/ directory or run any executables in the bin/ directory\&.
+.sp
+This can be achieved by passing an option to Ruby:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby \-rubygems bin/ember
+irb \-rubygems \-r ember
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Or by setting the $RUBYOPT environment variable:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+export RUBYOPT=\-rubygems   # bash, ksh, zsh
+setenv RUBYOPT \-rubygems   # csh
+set \-x RUBYOPT \-rubygems   # fish
+.fi
+.if n \{\
+.RE
+.\}
+.SS "Running tests"
+.sp
+Simply execute the included test runner, which sets up Ruby\(cqs $LOAD_PATH for testing, loads the included test/test_helper\&.rb file, and then evaluates all test/**/*_test\&.rb files:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ruby test/runner
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+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 test/test_helper\&.rb file\&.
+.SS "Contributing"
+.sp
+\m[blue]\fBFork this project on GitHub\fR\m[] and send a pull request\&.
+.SH "HISTORY"
+.SS "Version 0\&.3\&.1 (2011\-04\-22)"
+.sp
+This release fixes a compatibility issue with Ruby 1\&.9\&.2\-rc2\&.
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Compatibility fixes for Ruby 1\&.9\&.2\-rc2\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Upgrade to Inochi 6\&.0\&.2\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Upgrade from Dfect 2 to Detest 3\&.1\&.0\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Move SYNTAX section into separate source file\&.
+.RE
+.SS "Version 0\&.3\&.0 (2010\-04\-26)"
+.sp
+This release adds class methods that let you (portably and more easily) create your own domain specific languages in eRuby; adds more usage examples in the help manual; and removes a binding inheritance hack\&.
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+Ember::Template::wrap_content_block()
+wraps eRuby block content appending\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+Ember::Template::content_from_block()
+extracts content from eRuby blocks\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+Ember::Template::buffer_from_block()
+gives access to template evalutaion result buffer\&.
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Remove hack for inheriting parent template binding\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Add example on unindenting node content and eRuby DSL examples that use the new content block methods\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Simplify code examples using the new wrap_content_block() method\&.
+.RE
+.SS "Version 0\&.2\&.0 (2010\-04\-25)"
+.sp
+This release adds Ruby on Rails integration\&.
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Ember can now be used directly as a Ruby on Rails (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:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ActionView::TemplateHandlers::Ember\&.options = {
+  :unindent => true,
+  :shorthand => true,
+  :infer_end => true
+}
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Thanks to Kamil Kukura for contributing this feature\&.
+.RE
+.SS "Version 0\&.1\&.1 (2010\-04\-20)"
+.sp
+This release fixes a nested rendering bug, updates the manual, and further beautifies the Ruby code that results from eRuby template compilation\&.
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+Ember::Template#render()
+now creates isolated contexts by default to prevent nested calls from clobbering each other\(cqs output!
+.sp
+For example, if template A calls method X which renders template B (thinking that template B\(cqs rendering is isolated and will not affect the rendering of template A) then you\(cqre in for a wild bug chase! >8\-(
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Upgrade to Inochi 2\&.0\&.0rc5\&. Convert manual from ERBook to Ember + Ronn\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Remove spaces around value insertions in template compilation output\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Remove logo images from source repository because they\(cqre no longer used\&.
+.RE
+.SS "Version 0\&.1\&.0 (2010\-04\-03)"
+.sp
+This release improves the handling of eRuby comment directives, fixes a bug in the <% end %> inference logic, and performs some minor housekeeping\&.
+.PP
+\fBNew features\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+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:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+%|some_block_directive
+
+  Inside some_block_directive\&.
+
+%#\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+
+  Still inside some_block_directive!
+
+  %#\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+  %| nested_block_directive
+  %#\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+
+    Inside nested_block_directive\&.
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+<% end %>
+inference did not work for blocks beginning with
+def,
+class, and
+module
+keywords\&.
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Upgrade to Inochi 2\&.0\&.0\-rc3\&. This project no longer depends on the "inochi" or "trollop" gems at runtime\&.
+.RE
+.SS "Version 0\&.0\&.1 (2009\-10\-03)"
+.sp
+This release improves Ruby 1\&.9 support and revises the user manual\&.
+.PP
+\fBBug fixes\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Nested templates could not access parent\(cqs binding in Ruby 1\&.9
+.RE
+.PP
+\fBHousekeeping\fR
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Use simpler Copyright reminder at the top of every file\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Rename internal \(oqProgram` class\(cq methods to be self\-documenting\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Open source is for fun, so speak of "related works", not "competitors"\&.
+.RE
+.SS "Version 0\&.0\&.0 (2009\-02\-13)"
+.sp
+This is the first public release of Ember\&. Enjoy!
+.SH "AUTHORS"
+.sp
+Suraj N\&. Kurapati
+.SS "Credits"
+.sp
+Kamil Kukura
+.SS "License"
+.sp
+(the ISC license)
+.sp
+Copyright 2009 Suraj N\&. Kurapati <\m[blue]\fBsunaku@gmail\&.com\fR\m[]\&\s-2\u[2]\d\s+2>
+.sp
+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\&.
+.sp
+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\&.
+.SH "SEE ALSO"
+.sp
+erb(1)
+.SS "References"
+.TS
+tab(:);
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt
+lt lt.
+T{
+.sp
+[Bundler]
+T}:T{
+.sp
+\m[blue]\fBhttp://gembundler\&.com\fR\m[]
+T}
+T{
+.sp
+[eRuby]
+T}:T{
+.sp
+\m[blue]\fBhttp://ruby\-doc\&.org/docs/ProgrammingRuby/html/web\&.html#S2\fR\m[]
+T}
+T{
+.sp
+[Inochi]
+T}:T{
+.sp
+\m[blue]\fBhttp://snk\&.tuxfamily\&.org/lib/inochi/\fR\m[]
+T}
+T{
+.sp
+[Rails]
+T}:T{
+.sp
+\m[blue]\fBhttp://rubyonrails\&.org\fR\m[]
+T}
+T{
+.sp
+[RubyGems]
+T}:T{
+.sp
+\m[blue]\fBhttp://rubygems\&.org\fR\m[]
+T}
+T{
+.sp
+[Ruby]
+T}:T{
+.sp
+\m[blue]\fBhttp://ruby\-lang\&.org\fR\m[]
+T}
+.TE
+.sp 1
+.SH "NOTES"
+.IP " 1." 4
+ruby-wrapper
+.RS 4
+\%http://github.com/chneukirchen/rup/blob/master/ruby-wrapper
+.RE
+.IP " 2." 4
+sunaku@gmail.com
+.RS 4
+\%mailto:sunaku@gmail.com
+.RE