MANUAL

<%
  ##
  # Creates an example listing from the code in the given block.
  #
  def example_test_run &block
    Ember::Template.wrap_content_block(block) do |content|
      code = "require 'detest/auto'\n\n#{content.join}"
      [
        '===================================================================',

        'When the following test is run:', nil,

        '[source,ruby]',
        '-------------------------------------------------------------------',
        code,
        '-------------------------------------------------------------------',
        nil,

        'Detest will output the following:', nil,

        '-------------------------------------------------------------------',
        IO.popen('ruby -Ilib 2>&1', 'w+') do |ruby|
          ruby.write code
          ruby.close_write
          ruby.read
        end,
        '-------------------------------------------------------------------',
        nil,

        '===================================================================',
      ].join("\n")
    end
  end

  ##
  # Returns a link to the given core method on the Dfect module.
  #
  def method_api_docs name, text = 'API documentation'
    require 'cgi'
    "#{@api_docs_url}/Detest.html##{CGI.escape name}-class_method[#{text}]"
  end
%>
%+ 'SYNOPSIS'
%+ 'README'
%+ 'INSTALL'
%+ 'USAGE'
%+ 'ASSERTIONS'
%+ 'TESTS'
%+ 'EMULATION'
%+ 'HACKING'
%+ 'HISTORY'
%+ 'CREDITS'
%+ 'BEYOND'