changes.xml

        <para>The API documentation for the <classname>FXImage</classname>
        class mistakenly listed <constant>IMAGE_ALPHA</constant> as a valid
        image rendering hint, but this flag is no longer needed since FOX
        images now always contain an alpha channel (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1715&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1715</ulink>). The documentation has been corrected. Thanks to
        Meinrad Recheis for reporting this mistake.</para>
      </listitem>

      <listitem>
        <para>Due to an error in the SWIG interface files, the
        <methodname>data</methodname> method for the
        <classname>FXSettings</classname> class was not being wrapped
        properly. As a result, this method was unavailable and in turn led to
        other dependent methods (like <methodname>each_section</methodname>)
        to be unavailable as well (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1771&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1771</ulink>). This error has been corrected. Thanks to Jannis
        Pohlmann for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The binary gem for Windows was built with FOX version 1.2.16 and
        FXScintilla version 1.62.</para>
      </listitem>
    </itemizedlist>
  </simplesect>

  <simplesect>
    <title>Changes For Version 1.2.5 (March 1, 2005)</title>

    <itemizedlist mark="bullet">
      <listitem>
        <para>The change made for FXRuby version 1.2.4 regarding garbage
        collection for table items corrected only one of the problems
        described in <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1445&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1445</ulink>; There was still a problem related to the
        "destructive" effects of the <methodname>setTableSize</methodname>
        method for the <classname>FXTable</classname> class. This problem has
        now been corrected as well. Thanks to David Peoples, Jamey Cribbs and
        Joel VanderWerf for their assistance in helping me to track down this
        problem.</para>
      </listitem>

      <listitem>
        <para>The <methodname>extractText</methodname> and
        <methodname>overlayText</methodname> methods for the
        <classname>FXTable</classname> class were implemented incorrectly and
        weren't listed in the API documentation. These problems have been
        corrected.</para>
      </listitem>

      <listitem>
        <para>The checks for out-of-bounds indices in the
        <methodname>getColumnX</methodname>,
        <methodname>setColumnX</methodname>, <methodname>getRowY</methodname>,
        <methodname>setRowY</methodname> and
        <methodname>updateRange</methodname> methods for the
        <classname>FXTable</classname> class were incorrect. These have been
        fixed.</para>
      </listitem>

      <listitem>
        <para>The <methodname>setTableSize</methodname> method for the
        <classname>FXTable</classname> class now raises
        <classname>ArgError</classname> if either the number of rows or
        columns passed in as arguments is less than zero.</para>
      </listitem>

      <listitem>
        <para>A typo in one of the source files was causing the build to fail
        when compiled against Ruby versions 1.8.1 or earlier (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1551&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1551</ulink>). This error has been corrected. Thanks to Alex
        McGuire for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The <methodname>selectItem</methodname> method for the
        <classname>FXTable</classname> class was removed in FOX 1.2, so we've
        added a convenience method for this that just calls the
        <methodname>selectRange</methodname> method under the hood (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1562&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1562</ulink>). Thanks to Joel VanderWerf for this
        suggestion.</para>
      </listitem>

      <listitem>
        <para>The binary gem for Windows was built with FOX version 1.2.13 and
        FXScintilla version 1.62.</para>
      </listitem>
    </itemizedlist>
  </simplesect>

  <simplesect>
    <title>Changes For Version 1.2.4 (February 23, 2005)</title>

    <itemizedlist mark="bullet">
      <listitem>
        <para>Due to a change in some of the internal Ruby C APIs, a
        compile-time error for FXRuby was introduced in some of the Ruby 1.8.2
        preview releases (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1039&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1039</ulink>). One should not see any compile-time errors when
        compiling FXRuby (versions 1.2.3 or later) against the Ruby 1.8.2
        final release, but I've neverthless made a change to how those
        internal APIs are used, to avoid any potential problems. Thanks to the
        many users who pointed out this problem.</para>
      </listitem>

      <listitem>
        <para>Joel VanderWerf suggested some enhancements to the
        <filename>image.rb</filename> example program in order to improve its
        startup time (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1281&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1281</ulink>). Those changes have been incorporated. Thanks to
        Joel for this suggestion.</para>
      </listitem>

      <listitem>
        <para>One change for the <classname>FXImage</classname> class between
        FOX versions 1.0 and 1.2 is the nature of the pixel buffer that's
        passed to the <classname>FXImage</classname> constructor. Previously,
        this pixel buffer was expected to be a string of bytes; now it's
        expected to be an array of <type>FXColor</type> values. This
        modification was not implemented correctly for FXRuby versions 1.2.3
        and earlier (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1427&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1427</ulink>). This bug has been corrected, and the example
        program (<filename>image.rb</filename>) and test cases have been
        updated as well. Thanks to Oliver Smith and others for reporting this
        problem.</para>
      </listitem>

      <listitem>
        <para>A couple of different problems, reported by Patrick Fernie and
        David Peoples, exposed a flaw in how FXRuby manages the links between
        FOX objects and their Ruby peers when the FOX objects are destroyed
        (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1445&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1445</ulink>). Without going into all the gory details, let's
        just say that since we have no explicit control over when Ruby's
        garbage collector decides to "collect" those Ruby peers that point to
        C++ objects that have been destroyed, we need to take steps to
        neutralize those Ruby peer objects so that they can't cause your
        application to crash in the meantime; I've implemented a fix to take
        care of this situation. Thanks to Patrick and David for reporting
        these problems.</para>
      </listitem>

      <listitem>
        <para>The API documentation for FXRuby 1.2 still contained references
        to the old "spellings" of the <methodname>fxparseAccel</methodname>
        and <methodname>fxparseHotKey</methodname> method names, which were
        all lowercase (i.e. <methodname>fxparseaccel</methodname> and
        <methodname>fxparsehotkey</methodname>). (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1470&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1470</ulink>). These errors have been corrected.</para>
      </listitem>

      <listitem>
        <para>Added the <methodname>FXScrollArea#scrollCorner</methodname>
        method, which returns a reference to the scroll corner for any window
        derived from <classname>FXScrollArea</classname> (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=843&amp;group_id=300&amp;atid=1226">RubyForge
        Feature Request #1226</ulink>). Thanks to Brian Sheehan for this
        suggestion.</para>
      </listitem>

      <listitem>
        <para>Added the <methodname>FXMemoryBuffer#to_a</methodname> method,
        which is just an alias for the <methodname>data</methodname> accessor
        method that returns a copy of the data buffer as an array (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1295&amp;group_id=300&amp;atid=1226">RubyForge
        Feature Request #1295</ulink>). Thanks to Meinrad Recheis for this
        suggestion.</para>
      </listitem>

      <listitem>
        <para>Added the <methodname>appendRows</methodname> and
        <methodname>appendColumns</methodname> methods to the
        <classname>FXTable</classname> class (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1426&amp;group_id=300&amp;atid=1226">RubyForge
        Feature Request #1295</ulink>). Thanks to Brett Hallett for this
        suggestion.</para>
      </listitem>

      <listitem>
        <para>The binary gem for Windows was built with FOX version 1.2.13 and
        FXScintilla version 1.62.</para>
      </listitem>
    </itemizedlist>
  </simplesect>

  <simplesect>
    <title>Changes For Version 1.2.3 (January 22, 2005)</title>

    <itemizedlist mark="bullet">
      <listitem>
        <para>Since group boxes containing radio buttons no longer enforce the
        radio behavior of radio buttons (i.e. keeping only one radio button
        selected at a time), some of the example programs were no longer
        working as desired (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=751&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #751</ulink> and <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1280&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1280</ulink>). This problem has been corrected. Thanks to Yuri
        Leikind and Barry DeZonia for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>Bob Sidebotham reported a little typo in the
        <filename>table.rb</filename> example program (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=990&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #990</ulink>). This has been corrected.</para>
      </listitem>

      <listitem>
        <para>The API documentation for <classname>FXList</classname> did not
        reflect the changes for FOX 1.2; the
        <methodname>retrieveItem()</methodname> has been renamed to
        <methodname>getItem()</methodname> and
        <methodname>insertItem()</methodname> has been renamed to
        <methodname>setItem()</methodname> (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1037&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1037</ulink> and <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1257&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1257</ulink>). This has been corrected. Thanks to Remy Drouilhet
        and Stephan Kamper for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The Windows installer was missing some of the documentation
        files (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1139&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1139</ulink>). This has been corrected. Thanks to Curt Hibbs and
        Mark Smith for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The <filename>browser.rb</filename> example program was broken
        (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1146&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1146</ulink>). This has been corrected. Thanks to Stefan Lang for
        reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The attribute setter for
        <methodname>FXHeaderItem#justification</methodname> was defined
        incorrectly (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1276&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1276</ulink>). This has been corrected. Thanks to Joel VanderWerf
        for reporting this problem (and providing a patch to fix it).</para>
      </listitem>

      <listitem>
        <para>The <methodname>filenames</methodname> alias for the
        <methodname>FXFileDialog#getFilenames()</methodname> instance method
        was missing (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1277&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1277</ulink>). This error has been corrected. Thanks to Barry
        DeZonia for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The API documentation for the
        <classname>FXFileDialog</classname> class methods
        <methodname>getOpenFilenames()</methodname>,
        <methodname>getOpenDirectory()</methodname>,
        <methodname>getOpenFilename()</methodname> and
        <methodname>getSaveFilename()</methodname> was extremely inadequate
        (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1279&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1279</ulink>). This documentation has been improved. Thanks to
        Barry DeZonia for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>Brett Hallett contributed a Ruby port of the "ratio" example
        program from the regular FOX distribution, for demonstrating the use
        of the new <classname>FXSpring</classname> layout manager (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1282&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1282</ulink>). Many thanks to Brett for this addition!</para>
      </listitem>

      <listitem>
        <para>Joel VanderWerf contributed code to simplify how programs
        interact with modal and non-modal dialog boxes (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1283&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1283</ulink>). See the API documentation for the new
        <methodname>FXDialogBox#execute_modal</methodname> and
        <methodname>FXDialogBox#execute_nonmodal</methodname> methods for
        examples of their use.</para>
      </listitem>

      <listitem>
        <para>The attribute setters for
        <methodname>FXRealSpinner#selBackColor</methodname> and
        <methodname>FXSpinner#selBackColor</methodname> were defined
        incorrectly (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1297&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1297</ulink>). These have been corrected. Thanks to Meinrad
        Recheis for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The <methodname>tooltipPause</methodname> attribute reader for
        the <classname>FXApp</classname> class was missing (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1306&amp;group_id=300&amp;atid=1225">RubyForge
        Patch #1306</ulink>). Thanks to Joel VanderWerf for reporting this
        omission and providing a patch to fix it.</para>
      </listitem>

      <listitem>
        <para>The API documentation for the
        <classname>FXToolBarTab</classname> class was missing (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1322&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1322</ulink>). Thanks to Joel VanderWerf for reporting this
        omission.</para>
      </listitem>

      <listitem>
        <para>The attribute accessors for
        <methodname>FXText#visibleRows</methodname> and
        <methodname>FXText#visibleColumns</methodname> were defined and
        documented incorrectly (see <ulink
        url="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1325&amp;group_id=300&amp;atid=1223">RubyForge
        Bug #1325</ulink>). These have been corrected. Thanks to Karl El-Koura
        for reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The binary gem for Windows was built with FOX version 1.2.13 and
        FXScintilla version 1.62.</para>
      </listitem>
    </itemizedlist>
  </simplesect>

  <simplesect>
    <title>Changes For Version 1.2.2 (October 1, 2004)</title>

    <itemizedlist mark="bullet">
      <listitem>
        <para>In order to avoid versioning problems when dealing with a mix of
        applications based on either FXRuby 1.0 or 1.2, the feature name for
        FXRuby has been changed from "fox" to "fox12". For most application
        developers, this means that you will need to modify the source code
        for applications targeted at FXRuby 1.2 to begin with the line</para>

        <para><programlisting>require 'fox12'</programlisting>Note that no
        changes should be required for legacy applications targeted at FXRuby
        1.0.</para>
      </listitem>

      <listitem>
        <para>Made a number of updates to the documentation, to reflect API
        changes for FXRuby 1.2.</para>
      </listitem>

      <listitem>
        <para>The binary gem for Windows was built with FOX version 1.2.9 and
        FXScintilla version 1.61.</para>
      </listitem>
    </itemizedlist>
  </simplesect>

  <simplesect>
    <title>Changes For Version 1.2a2 (July 10, 2004)</title>

    <itemizedlist mark="bullet">
      <listitem>
        <para>This is the second "alpha" release of FXRuby 1.2. This release
        should be compatible with any FOX library version 1.2; it is not
        compatible with any previous FOX library versions. As this is an alpha
        release, users should expect a certain amount of instability, bugs,
        etc.</para>
      </listitem>

      <listitem>
        <para>For this release, all of the FOX 1.2 classes are available with
        the exception of the <classname>FXBitmapView</classname> class. There
        is a small problem with how the <classname>FXBitmapView</classname>
        class is declared in the FOX 1.2 header files, and I'm trying to
        decide how best to resolve that problem. The goal is to have this
        problem resolved by the next alpha release of FXRuby.</para>
      </listitem>

      <listitem>
        <para>For this release, all of the RDoc-based online documentation has
        been brought up to date with the new APIs.</para>
      </listitem>

      <listitem>
        <para>Portions of the FXRuby User's Guide were still out of date with
        respect to the new APIs (see <ulink
        url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=988623&amp;group_id=20243&amp;atid=120243">SourceForge
        Bug #988623</ulink>). This has been fixed.</para>
      </listitem>

      <listitem>
        <para>The <filename>mditest.rb</filename> example program was not up
        to date with the new APIs. This has been fixed.</para>
      </listitem>

      <listitem>
        <para>The <filename>glviewer.rb</filename> example program was not up
        to date with the new APIs (see <ulink
        url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=986479&amp;group_id=20243&amp;atid=120243">SourceForge
        Bug #986479</ulink>). This has been fixed. Thanks to Remy Drouilhet
        for reporting this problem and suggesting the fixes.</para>
      </listitem>

      <listitem>
        <para>The <methodname>FXGLGroup#bounds</methodname> method was defined
        incorrectly (see <ulink
        url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=986476&amp;group_id=20243&amp;atid=120243">SourceForge
        Bug #986476</ulink>). This has been fixed. Thanks to Remy Drouilhet
        for reporting this problem and suggesting the fix.</para>
      </listitem>

      <listitem>
        <para>The <filename>scintilla-test.rb</filename> example program was
        not up to date with the new APIs (see <ulink
        url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=986172&amp;group_id=20243&amp;atid=120243">SourceForge
        Bug #986172</ulink>). This has been fixed. Thanks to Peter Watkins for
        reporting this problem and submitting a corrected version of the
        program.</para>
      </listitem>

      <listitem>
        <para>There was a small typo in the table.rb example program (see
        <ulink
        url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=988152&amp;group_id=20243&amp;atid=120243">SourceForge
        Bug #988152</ulink>). This has been fixed. Thanks to Jamey Cribbs for
        reporting this problem and suggesting the fix.</para>
      </listitem>

      <listitem>
        <para>Due to an oversight on my part, one of the overloaded
        constructors for the <classname>FXRegion</classname> class wasn't
        wrapped properly (see <ulink
        url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=986181&amp;group_id=20243&amp;atid=120243">SourceForge
        Bug #986181</ulink>). This has been fixed. Thanks to Bil Bas for
        reporting this problem.</para>
      </listitem>

      <listitem>
        <para>Removed some obsolete aliases for the old leading and trailing
        rows and columns for the <classname>FXTable</classname> class (see
        <ulink
        url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=986181&amp;group_id=20243&amp;atid=120243">SourceForge
        Bug #988038</ulink>). Thanks to Yuri Leikind for reporting this
        problem.</para>
      </listitem>

      <listitem>
        <para>Added <classname>FXTable</classname> instance methods
        <methodname>horizontalGridShown=()</methodname> and
        <methodname>verticalGridShown=()</methodname> to complement the
        already available <methodname>horizontalGridShown?</methodname> and
        <methodname>verticalGridShown?</methodname> methods.</para>
      </listitem>

      <listitem>
        <para>The binary gem for the 1.2a1 release on Windows didn't have PNG
        or JPEG image support built-in (see <ulink
        url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=986180&amp;group_id=20243&amp;atid=120243">SourceForge
        Bug #986180</ulink>). This has been fixed. Thanks to Bil Bas for
        reporting this problem.</para>
      </listitem>

      <listitem>
        <para>The binary gem for Windows was built with FOX version 1.2.7 and
        FXScintilla version 1.61.</para>
      </listitem>
    </itemizedlist>
  </simplesect>

  <simplesect>
    <title>Changes For Version 1.2a1 (June 28, 2004)</title>

    <itemizedlist mark="bullet">
      <listitem>
        <para>This is the first "alpha" release of FXRuby 1.2. This release
        should be compatible with any FOX library version 1.2; it is not
        compatible with any previous FOX library versions. As this is an alpha
        release, users should expect a certain amount of instability, bugs,
        etc.</para>

        <para>The intent of this first alpha release is twofold. The primary
        intent is allow application developers who have current projects based
        on FXRuby 1.0 to begin the process of updating their applications for
        compatibility with FXRuby 1.2. For this release, all of the classes
        that existed in FXRuby 1.0 have been updated for compatibility with
        FOX 1.2, and so developers should at least be able to begin to "port"
        their applications forward now. Note that there have been a number of
        changes for FOX 1.2 and FXRuby 1.2, both in terms of API changes and
        less obvious "behavioral" changes. For a detailed summary of these
        changes, please see <ulink
        url="http://www.knology.net/~lyle/fox/1.2/WhatsNew.html">"What's New
        in FOX 1.2"</ulink> (also available as a <ulink
        url="http://www.knology.net/~lyle/fox/1.2/WhatsNew.pdf">PDF</ulink>).
        Note that few, if any, of the new classes introduced in FOX 1.2 are
        available in this first alpha release of FXRuby 1.2. Support for those
        new classes should come along quickly in subsequent alpha releases of
        FXRuby 1.2.</para>

        <para>The secondary intent of this first alpha release is to introduce
        the new <ulink
        url="http://rubygems.rubyforge.org">RubyGems</ulink>-based packaging
        of FXRuby and to begin to work out the inevitable kinks in that
        system.</para>
      </listitem>

      <listitem>
        <para>The binary gem for Windows was built with FOX version 1.2.4 and
        FXScintilla version 1.57.</para>
      </listitem>
    </itemizedlist>
  </simplesect>
</chapter>