%#--
%# Copyright protects this work.
%# See LICENSE file for details.
%#++

%|chapter "History"


  %|history


    %|section "Version 9.0.0 (2009-10-18)"

      This release adds new nodes to the XHTML format, reduces the size of generated XHTML documents and also improves their usability and validity.


      %|paragraph "Incompatible changes"

        * The `String#to_inline_xhtml` method has been removed.  Use the `String#to_xhtml` method, which now returns inline XHTML, instead.


      %|paragraph "New features"

        * Add "text" and "code" nodes for `<pre>` and `<code>`.

        * Add "chain" parameter to <%= xref "xhtml.nodes", "XHTML node definitions" %>.

        * Add <%= xref "xhtml.nodes.command!", "command! floats" %> for listing shell commands and their output.

        * Reduce XHTML output size by activating image data URIs at runtime using JavaScript.  Previously, data URIs were emitted into XHTML at compile time.

        * Upgrade from XHTML 1.0 Transitional to Strict.


      %|paragraph "Bug fixes"

        * Add support for [multiple tab rows in jQuery UI tab bars](http://dev.jqueryui.com/ticket/4882).

        * Auto-detected mime types were inserted incorrectly in base64 embeds.

        * Prevent block-level children of `<ins>` from appearing underlined on screen (Opera browsers) and in print (Microsoft browsers).

        * `<blockquote/>` icon did not appear in print style.

        * Prevent mini navigation menus from colliding.


      %|paragraph "Housekeeping"

        * Remove the need for highlighting scroll target by setting body height so that any element can be brought to the top of the screen via scrolling.

        * Place mini navigation menus on jQuery UI tab bars when possible.

        * Show logo image in full and centered above document header.

        * Completely remove `<p>` around block-level child (added by Markdown).

        * Fix XHTML validation errors on `<table>`, `<tfoot>`, `<img>` in RDoc strings, and output of syntax coloring library.

        * DRY up XHTML node definitions using YAML hash merging operator.


    %|section "Version 8.0.0 (2009-10-10)"

      This release simplifies <%= xref "SpecFile.nodes", "node definitions" %>, adds <%= xref "Table nodes" %> for building tables the HTML way, and introduces <%= xref "Arbitrary floats" %> to combat the [explosion of special-purpose document nodes](http://www.docbook.org/tdg/en/html/part2.html).


      %|paragraph "Incompatible changes"

        * Reduce and rename <%= xref "SpecFile.nodes", "node definitions" %> attributes:

          * `toc: true   ` &rarr; `index: tree    `
          * `lof: true   ` &rarr; `index: list    `
          * `index: true ` &rarr; `number: section`
          * `number: true` &rarr; `number: ordinal`
          * `depth: true ` &rarr; (removed)
          * `bypass: true` &rarr; (removed)

        * Rename <%= xref "Node.class" %> properties to be more self-documenting:

          * args   &rarr; arguments
          * defn   &rarr; definition
          * trace  &rarr; backtrace
          * index  &rarr; section_number
          * number &rarr; ordinal_number

        * Replace formal blocks (figure, table, example, equation, procedure) with <%= xref "Arbitrary floats" %>.

        * Append an exclamation mark (!) to the names of <%= xref "Admonition nodes" %>, thereby making them a special case of <%= xref "Arbitrary floats" %>.


      %|paragraph "New features"

        * Add "params" attribute to <%= xref "SpecFile.nodes", "node definitions" %>.

        * Add <%= xref "Table nodes" %> for building tables the HTML way.


      %|paragraph "Housekeeping"

        * Use YAML hash merging to DRY node definitions in XHTML format.

        * Use <%= xref "Table nodes" %> instead of PHP Markdown Extra table syntax in the user manual.

        * Remove the "digest" <%= xref "SpecFile.nodes" %> attribute from the user manual.  Its use was discontinued a few major versions ago.


    %|section "Version 7.3.0 (2009-10-09)"

      This release improves the printer friendliness of the XHTML format.


      %|paragraph "New features"

        * Do not omit ERBook internals from node stack traces.

        * Hide "printer friendly" toggle checkbox when printing (but not when viewing the "printer friendly" mode on the computer screen).

        * Hide the "About" section in "printer friendly" mode.


      %|paragraph "Bug fixes"

        * Page scrolled to wrong location when links in the table of contents in the "printer friendly" mode were clicked.

        * Print style was not used when printing from "printer friendly" mode.

        * Sans-serif font was not used in headings in print style.


      %|paragraph "Housekeeping"

        * Use Ember syntax in <%= xref "HelloWorld.input" %> example.


    %|section "Version 7.2.0 (2009-10-07)"

      This release improves support for Ruby 1.9 and Webkit-based web browsers, reduces gem dependencies, and fixes some bugs.


      %|paragraph "New features"

        * Add `String#thru_ember` method for direct template rendering.


      %|paragraph "Bug fixes"

        XHTML

        * Fix "printer friendly" toggle checkbox for Webkit browsers.
        * Disable interactive TOC tree location coloring in print style.
        * Use normal line height for preformatted text in print style.
        * Use serif for normal and sans-serif for emphasis in print style.

        Ruby 1.9

        * `Array#to_s` is same as `Array#inspect` in Ruby 1.9.
        * RDoc 2.4.3 no longer provides `RDoc::Generators::MarkUp`.

        Markdown

        * Allow "code spans" annotated with Maruku's IAL (Inline Attribute List) Markdown extension to be syntax colored.


      %|paragraph "Housekeeping"

        * Remove CSS and JavaScript minification in favor of manual gzip compression and fewer gem dependencies.
        * Fix forgotten Textile 'bq.' to Markdown '>' conversion.
        * Omit navigation menu from Abstract; it is standalone.
        * Mark all code spans with `{:lang=ruby}` instead of HTML `<code/>` tags


    %|section "Version 7.1.1 (2009-09-06)"

      This release improves support for Microsoft, Opera, and Webkit web browsers in the XHTML format, revises the code and documentation, and fixes some bugs.


      %|paragraph "Bug fixes"

        * Restore support for Microsoft web browsers by removing the optimization of storing image data URIs in XML entities.  See <%= xref "Serve XHTML as HTML for Microsoft web browsers" %> for the consequences of this change.

        * The screen did not scroll during `reveal_hash()` in Webkit browsers.

        * The prevent_jump option of `set_hash()` did not work for Opera and Microsoft browsers.

        * Use text descriptions instead of graphical symbols in the ALT fields of navigation menu images.

        * The Abstract was not in the prev/next navigation chain.


      %|paragraph "Housekeeping"

        * Open source is for fun, so [be nice](http://loiclemeur.com/english/2009/03/never-criticize-your-competitors.html): speak of "related works" instead of "competitors".

        * Fix warning about `$logo` and `$feeds` being used when not defined.

        * Include project website URL in "generator" HTML meta field.

        * Emit project license above JavaScript code in XHTML output.

        * Lots of other clean up in the documentation and the XHTML format.


    %|section "Version 7.1.0 (2009-08-30)"

      This release improves the appearance and usability of <%= xref "xhtml" %> documents through [jQuery UI](http://jqueryui.com), and fixes some bugs.


      %|paragraph "New features"

        * [jQuery UI tabs](http://jqueryui.com/demos/tabs/) now organize the content of <%= xref "xhtml" %> documents in a breadth-first manner for easier skimming and browsing.  Note that the print stylesheet still continues to organize content in the traditional depth-first manner.

        * Add checkbox for toggling printer friendly stylesheet.  This makes it more obvious to readers that a specially-designed print stylesheet exists for their convenience.

        * Show both `$title` and `$subtitle` in XHTML document's title.


      %|paragraph "Bug fixes"

        * Reference nodes were included in next/prev navigation chain.


      %|paragraph "Housekeeping"

        * Convert CSS into SASS.

        * Use simpler Copyright reminder at the top of every file:

              Copyright protects this work.
              See LICENSE file for details.

        * Remove localScroll and scrollTo jQuery plugins; we do our own logic (based on their source code) for smoothly scrolling to elements.

        * Rename XHTML resource directories into subdirectories.

        * "Logistics" section was under project description and was therefore put into the release announcement.  Ack!


    %|section "Version 7.0.0 (2009-05-03)"

      This release improves the appearance, usability, and validity of <%= xref "xhtml" %> output, upgrades to a new eRuby templating system, adds new processing options to node definitions, and fixes some bugs.


      %|paragraph "Incompatible changes"

        * If you add methods to the `ERBook::Template` class, in order to provide them to eRuby templates, you must now add those methods to the `ERBook::Template::Sandbox` class instead.

        * The [<%= Ember::PROJECT %>](<%= Ember::WEBSITE %>) template processor is now used to render eRuby templates instead of the ERB library that is shipped with Ruby.

          * The file inclusion directive has been removed:

                <%%# include YOUR_FILE #%>

            <%= Ember::PROJECT %> provides equivalent functionality:

                %%< "YOUR_FILE"

        * The <tt>erbook/to_xhtml</tt> library now annotates &lt;code&gt; elements with a "line" or "para" class indicating whether they span a single or mulitple lines respectively.

          The "pre.code" CSS class is no longer emitted.

        * The <tt>erbook/rdoc</tt> library has been updated to work with RDoc 2.4.3.  It no longer supports the old RDoc that is shipped with Ruby 1.8.

        * Just a reminder from the <%= xref "Version 5.0.0 (2008-11-22)" %> release notes:

          > Internet Explorer 6 and 7 [*do not* support](http://www.w3.org/MarkUp/2004/xhtml-faq#ie) the application/xhtml+xml mime type, so the output generated by the <%= xref "xhtml" %> format cannot be viewed in those browsers.


      %|paragraph "New features"

        * Replace dark background theme with a "wide open spaces" theme.

          * Use icons instead of unicode glyphs for mini navigation menus.

          * Put mini navigation menus on right-hand side of headings

          * Use [scrolling animation](http://demos.flesler.com/jquery/scrollTo/) when local links (URI fragments) are visited, instead of instantly teleporting to the destination.  This gives a sense of spatial existence to the web page, making it feel almost tangible!

        * XHTML output is now valid XHTML 1.0 Transitional!
          And the embedded CSS it contains is now valid CSS 3!

          * Minify CSS in XHTML output using the [Rainpress library](http://github.com/sprsquish/rainpress/tree/master).

          * Add CSS style for HTML definition lists.

        * Omit target type and index ("Section X.Y.Z") in output of `xref()` nodes in the screen-version (CSS stylesheet) of the generated output document.

          This information is still present in the print-version (CSS stylesheet) of the generated output document, where it is truly helpful to the reader.

        * Add "bypass" option to node definitions to properly support the generic "node" node.  Invalid XHTML was being generated because the 'node' node was marked as simply "inline", so it was not pulled out of the &lt;p&gt; tag created by Maruku.


      %|paragraph "Bug fixes"

        * The "silent" property in node definitions was not being honored.

        * Fix error when inserting reference nodes (they are not inline!).

        * Add workaround for Maruku treating first line of input as parameter definition, and thereby omitting it from the output!

        * `Array#to_s` is equivalent to `Array#inspect` in Ruby 1.9.

        * <%= xref "HelloWorld.spec" %> added methods to the nonexistent `ERBook::Node` class instead of adding them to the `ERBook::Document::Node` class.


      %|paragraph "Housekeeping"

        * Simplify language phrases used in mini navigation menus.

        * Remove CSS hacks for supporting IE6; it cannot render XHTML anyway.

        * Render italics and boldface equally in serif font. Bold is truly **bold** now and italic is *distinctive*.

        * Adjust spacing between document title, author, and date headings.

        * Add copyright notice at the top of every file.


    %|section "Version 6.1.0 (2009-02-14)"


      %|paragraph "New features"

        * Added translations for English phrases used in the XHTML format (see the <tt>lang/</tt> directory).

          You can choose which language to translate into by setting your LANG environment variable or by supplying the <tt>--locale</tt> option to the **<%= $program %>** executable.

        * Reduced brightness of links in local navigation menus; it was distracting from the main text of the document.

        * Draw the HTML &lt;hr/&gt; element as a dashed black line, instead of a *glaring* red line.


      %|paragraph "Bug fixes"

        * LaTeX-style index numbers were calculated incorrectly for descendants of the "node" node.


      %|paragraph "Housekeeping"

        * Add release notes for past releases... two years have already passed since I started this project!  Where did the time go?

        * List all contributors in the <%= xref "Credits", "Credits section" %> and make project logo a hyperlink to that section so interested people can quickly learn the source of the logo.

        * Mention that project license is ISC for reader's convenience.


    %|section "Version 6.0.1 (2009-01-19)"

      This release reattempts to fix the [circular dependency problem](http://www.ruby-forum.com/topic/176173#771281) that occurred when installing either **<%= Inochi::PROJECT %>** or <%= $project %>.


    %|section "Version 6.0.0 (2009-01-19)"

      This release improves the appearance & usability of the XHTML format, refactors the core logic into reusable libraries, fixes some bugs and improves variable names.


      %|paragraph "Incompatible changes"

        * Renamed `@types` to `@nodes_by_type` and `@spec` to `@format` in XHTML format.

        * Moved the core logic of the **erbook** executable into the `ERBook::Document` and `ERBook::Document::Template` classes.


      %|paragraph "New features"

        * Addded navigation menus beside every segment in the user manual.  These menus allow you to jump to the next/previous segment, whereas previously you always had to go back to the table of contents and select a new segment.

        * A star is drawn beside a reverse jump target in the table of contents, so the user can continue where they left off.

        * Added "inline" node definition parameter (see <%= xref "SpecFile.nodes" %>).

        * Added `$subtitle` parameter to XHTML format.

        * Document parameters for the XHTML format, such as `$title`, can now be disabled by setting them to `nil`.

        * Relative file paths can now be specified in <%%#include#%> directives.

        * Added a "node" node (see <%= xref "xhtml.nodes.node" %>), which serves as a pass-through container, in the XHTML format.

        * Allow user to type `<pre>` blocks on single lines without affecting the display of their content.

        * Initial newline in the body of `<code>` is now stripped.  This allows users to write their code blocks normally:

            &lt;code&gt;<br/>
            foo<br/>
            bar<br/>
            &lt;/code&gt;<br/>

            Instead of abnormally to avoid an extra leading newline:

            &lt;code&gt;foo<br/>
            bar<br/>
            &lt;/code&gt;<br/>

        * Paragraph nodes are now included in the table of contents.


      %|paragraph "Bug fixes"

        * Input to unindentation algorithm was being partially unindented beforehand by the logic that silences code-only eRuby directives.  This corrupted the unindentation algorithm's output in some cases.

        * `<pre>` blocks now expand to fit their content in the XHTML format.  No more scrollbars!

        * `<a/>` without href was treated as external hyperlink.


      %|paragraph "Housekeeping"

        * Revised the project logo to emphasize the owl mascot.

        * Replaced dull MediaWiki hyperlink colors with more lively colors in XHTML format.

        * Wrote more API documentation and use [<%= Inochi::PROJECT %>](<%= Inochi::WEBSITE %>) to simplify project maintenance.


    %|section "Version 5.0.0 (2008-11-22)"

      This release renames the "html" format to "xhtml", moves previously global stuff into the `ERBook` namespace, improves error reporting and usability, reduces the file size of XHTML output, and fixes some bugs.


      %|paragraph "Incompatible changes"

        * Renamed the "html" format to "xhtml" (and all similarly named methods and files) in order to [support custom DTD extensions](http://www.quirksmode.org/bugreports/archives/2005/02/custom_dtds_int_1.html) which reduce the overall file size of the output. See [this note in the user manual](#Save-XHTML-output-as-.xhtml) for the consequences of this change.

          * Internet Explorer 6 and 7 [*do not* support](http://www.w3.org/MarkUp/2004/xhtml-faq#ie) the application/xhtml+xml mime type, so the output generated by the <%= xref "xhtml" %> format cannot be viewed in those browsers.

        * Removed the `$use_icons` parameter from the XHTML format.  Now, icons are always used, whether you like it or not! ;-)

        * Replaced the implicit `ERB::Util#h` method with a `verbatim()` method in the XHTML format.

        * The [Trollop library](http://trollop.rubyforge.org) (used for command-line options parsing) is now required to run erbook.  See the "Setup" section in the user manual for details.


      %|paragraph "New features"

        * Added support for single-line eRuby directives (lines which begin with "%"), both in general and in the <tt>--unindent</tt> option.  See [this section of the user manual](http://snk.tuxfamily.org/lib/erbook/#xhtml.nodes) for examples.

        * Enhanced stack traces with information about the input file and also <tt><%%#include#%></tt>-ed files.  This was done at the cost of increasing the number of source lines of code to more than 200 (it is 207 right now).  Oh well, tradeoffs. ;-)

        * Omitted erbook internals from stack traces (unless in $DEBUG mode).  This helps users concentrate on problems in their input document.

        * Used colors for hyperlinks and suffix icon for external hyperlinks from [the MediaWiki software](http://www.mediawiki.org), which powers the famous Wikipedia.


      %|paragraph "Bug fixes"

        * Could not jump to examples and admonitions from the list of figures.

        * Reorganized icons for the XHTML format to better reflect their origin (the directory layout of the source code of the open-source projects they came from) so that others can easily find them in their original sources.


      %|paragraph "Housekeeping"

        * Added API documentation for all methods listed in the user manual, while also omitting many irrelevant methods from the list.


    %|section "Version 4.0.0 (2008-11-15)"

      This release renames the project, changes the project license, the source repository, and the default text-to-HTML formatting system, refactors the HTML format, and revises the documentation.


      %|paragraph "Contributor kudos"

        * Jens Vierbuchen contributed the the [cartoon owl sitting on a book](http://openclipart.org/media/files/lemmling/9065) drawing that is used in the new project logo:

          %= $logo

        * Maunika Gosike provided usability feedback to help improve the HTML format.


      %|paragraph "Incompatible changes"

        * The "Gerbil" project has been renamed to "erbook" to better reflect its purpose: it allows you to write books and documents using eRuby.

        * The project license has been changed from a [custom MIT/copyleft license](http://snk.tuxfamily.org/web/2007-05-02-copyleft-variation-of-mit-license.html) to the more permissive [ISC license](https://www.isc.org/software/license) to make the world a better place! :-)

        * The project source code repository is now [hosted on GitHub](http://github.com/sunaku/erbook/tree) (and therefore we now use Git instead of Darcs) to ease collaboration.

        * [Markdown](http://daringfireball.net/projects/markdown/syntax) is now the default text-to-HTML formatting system for the HTML format.


      %|paragraph "New features"

        * Added admonition icon for HTML `<blockquote>` element.

        * A visual marker is shown on outgoing (external) hyperlinks.

        * Tooltips are shown upon mouse hover for section index and title links which instruct new users how to navigate the web page more efficiently.


      %|paragraph "Housekeeping"

        * Renamed `Node#url` to `Node#here_frag`.  Also, speak of "frags" rather than "anchors" or "urls" from now on.

        * Refactored common logic from node output templates into Node class.


    %|section "Version 3.1.0 (2008-06-22)"

      This release improves the HTML format by reducing the output file size, improving on-line usability and document printability (please try the "print preview" function in your browser; the output is simply beautiful!), and repairing some defects.


      %|paragraph "New features"

        * The file size of the HTML format's output has been significantly reduced by reusing the data for embedded admonition icons through CSS.  So use admonitions generously; they will not bloat the output file size!


        Usability

        * All headings are now hyperlinks to themselves.  This allows readers to obtain a "permanent link" to any section in your HTML document.

        * A meta navigation menu is now emitted at the top of the HTML document.  This menu contains hyperlinks to the various structural elements of a document, such as the abstract, table of contents, list of figures, and references.

        * The color of visited hyperlinks has been darkened to improve readability.

        * The style of **blockquote** now provides better focus on its content.

        * Cross-reference (xref) hyperlinks now have a mouse-hover title when you override the default link text.


        Printing

        * Page breaks are now inserted before major sections in the document.  This allows for easier printing (you can print a subset of pages without fear of discontinuity) and improves readability through better organization.

        * In browsers that support [CSS3 pseudo-class selectors](http://www.w3.org/TR/css3-selectors/#selectors), cross-reference hyperlinks now show the name and index of their destination node.

        * Internal hyperlinks (which point to internal URI fragments) that are not cross-references are now shown as normal text to reduce distraction.


      %|paragraph "Bug fixes"

        * Cross-reference (xref) hyperlinks to paragraphs were broken due to a missing **id** attribute.


      %|paragraph "Housekeeping"

        * Removed useless CSS styles and fixed some XHTML validation issues.


    %|section "Version 3.0.2 (2008-06-08)"

      This release implements a shorter, faster, better unindentation algorithm which:
      * Allows block beginnings <code lang="rhtml"><%% do %></code> and endings <code lang="rhtml"><%% end %></code> to span multiple lines.
      * Ignores blank lines (which may contain whitespace) after block beginnings.
      * Processes multiple lines per iteration, instead of one line at a time.


    %|section "Version 3.0.1 (2008-06-03)"

      This release repairs the *unindent* feature (it did not consider block beginnings that had block parameters) and adds an error message when block beginnings and endings are unbalanced.


    %|section "Version 3.0.0 (2008-06-01)"

      This release improves the **unindent** feature and changes the **include** directive's syntax.  In related news, the project mailing list has been dismantled in favor of simply contacting the author directly (see e-mail address in LICENSE) to get help or provide feedback.


      %|paragraph "Incompatible changes"

        * The `$unindent` parameter has been replaced by the <tt>--unindent</tt> command-line option, which automatically unindents each line of input by the inner margin of its containing node.

        * The **include** directive now has a symmetric # at the closing end:

              <%%# include ... #%>


      %|paragraph "Bug fixes"

        * The CSS for the horizontal rule (hr) element should now be consistent in all browsers.

        * In the HTML format, whitespace has been added (in CSS) around the following nodes to make them conform more easily with the style of the rest of the document:
          * `header_outside_above` - above the entire header block
          * `header_inside_above ` - above the default header content
          * `header_inside_below ` - below the default header content
          * `header_outside_below` - below the entire header block
          * `footer_outside_above` - above the entire footer block
          * `footer_inside_above ` - above the default footer content
          * `footer_inside_below ` - below the default footer content
          * `footer_outside_below` - below the entire footer block


    %|section "Version 2.1.0 (2008-05-29)"

      This release adds image embedding methods for the HTML format and no longer appends (through CSS) an asterisk on outgoing hyperlinks.


    %|section "Version 2.0.0 (2008-02-03)"

      This release fixes some bugs, improves the RDoc library, and adds nodes for customization of the default header and footer.


      %|paragraph "Incompatible changes"

        * The <tt>lib/gerbil/rdoc.rb</tt> library has changed!  Read it for details.


      %|paragraph "New features"

        * In the **html** format, added the following nodes which allow you customize the default header and footer whilst preserving the default content:
          * `header_outside_above` - above the entire header block
          * `header_inside_above ` - above the default header content
          * `header_inside_below ` - below the default header content
          * `header_outside_below` - below the entire header block
          * `footer_outside_above` - above the entire footer block
          * `footer_inside_above ` - above the default footer content
          * `footer_inside_below ` - below the default footer content
          * `footer_outside_below` - below the entire footer block


      %|paragraph "Bug fixes"

        * [Regexp substitution placeholders were being interpreted](http://pluskid.lifegoo.com/?p=263) in node content. In particular, any occurrences of "\0" in a node's content was replaced by a strange SHA1 digest! (Zhang Chiyuan)

        * The <tt>lib/gerbil/rdoc.rb</tt> library did not extract method information recursively.


      %|paragraph "Housekeeping"

        * In the **html** format, added a CSS margin above HTML tables because they were visually colliding with other elements above them.

        * Fixed some Ruby code warnings in the **html** format.


    %|section "Version 1.1.0 (2008-01-22)"

      This release improves usability and fixes some bugs.


      %|paragraph "New features"

        * External links are now marked with a &lowast; symbol to help the user distinguish between internal and external links. This is helpful because a user may not wish to follow a link that takes them outside a document, say, when they are reading the document offline, without an Internet connection.


      %|paragraph "Bug fixes"

        * Forgot to update some code when I renamed the `RDoc.gen_parse_tree` method in <tt>format/rdoc.rb</tt> during the last release.

        * Module methods were omitted by the `RDoc.gen_method_infos` method in <tt>format/rdoc.rb</tt>.


    %|section "Version 1.0.0 (2008-01-12)"

      This release makes Gerbil available as a [RubyGem](http://rubygems.org), fixes some bugs, and updates the user guide.


      %|paragraph "Incompatible changes"

        * The <tt>gerbil</tt> file has been moved to <tt>bin/gerbil</tt>.

        * The <tt>format/</tt> directory has been renamed to <tt>fmt</tt>.

        * The <tt>format/html.rb</tt> file has been moved to <tt>lib/gerbil/html.rb</tt>.

        * The <tt>format/rdoc.rb</tt> file has been moved to <tt>lib/gerbil/rdoc.rb</tt>.

        * In <tt>format/rdoc.rb</tt>, the name of the `RDoc.gen_parse_tree` method has been pluralized (tree &rarr; trees) because it really returns an _array_ of trees rather than a single tree.

        * The <tt>CHANGES.yaml</tt> file has been removed, in favor of [this RSS feed](http://gerbil.rubyforge.org/news.xml).

        * The `GENERATOR` object has been renamed to `Gerbil`.


      %|paragraph "Bug fixes"

        * User guide now says "gem install RedCloth" instead of "gem install redcloth". I don't see why RubyGems requires the correct capitalization, so I [filed a bug report](http://rubyforge.org/tracker/?func=detail&aid=16937&group_id=126&atid=575) about it.

        * In the HTML format, images inside descendant nodes of a *figure* node were not properly centered.

        * In the HTML format, the `$title` parameter was not converted into HTML.


    %|section "Version 0.0.1 (2007-12-13)"

      * Fixed the generation of unique node URI fragments in the HTML format.
      * Added a `$feeds` parameter to the HTML format.
      * Added the <tt>format/rdoc.rb</tt> library for accessing RDoc's parse tree.
      * Updated the user guide:
        * added documentation for methods provided by the HTML format
        * added RSS feed for project release announcements
        * improved the ghastly HelloWorld example
      * Added a simple change-log (<tt>CHANGES.yaml</tt>) for the project.


    %|section "Version 0.0.0 (2007-12-09)"

      Dear developers, technical writers, and documentation gurus,

      I am proud to announce a new project of mine named "Gerbil"
      which is beautifully short (176 lines of code) and powerful!

      Personally, I am baffled at the amount of documentation I wrote
      (and felt was necessary) to explain the plethora of things this
      tiny little utility does.  About 70% of the development time
      was consumed by documentation alone!  I'm glad that's over. :-)

      The release notes are shown at the bottom of this message.

      Cheers!

      *  *  *

      This is the _first_ release of [the Gerbil project](http://gerbil.rubyforge.org.) Happy birthday!

      Please note that although the [user guide](http://gerbil.rubyforge.org/guide.html) says you can install Gerbil via RubyGems, currently there is [a bug in RubyGems version 0.9.5](http://rubyforge.org/tracker/index.php?func=detail&aid=16202&group_id=126&atid=575) that prevents me from creating an installable gem without strictly adhering to RubyGems convention of putting executable programs inside a <tt>bin/</tt> directory.

      Until this issue is resolved, please download the tarball/zip packages instead.