fxruby 1.2.5 → 1.2.6

Sign up to get free protection for your applications and to get access to all the features.
data/doc/changes.html CHANGED
@@ -1,115 +1,197 @@
1
1
  <html><head>
2
2
  <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
3
- <title>Chapter&nbsp;10.&nbsp;Change History</title><meta name="generator" content="DocBook XSL Stylesheets V1.61.2"><link rel="home" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="pt01.html" title="Part&nbsp;I.&nbsp;The Basics"><link rel="previous" href="infosources.html" title="Chapter&nbsp;9.&nbsp;Other Sources of Information"><link rel="next" href="pt02.html" title="Part&nbsp;II.&nbsp;Appendices"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;10.&nbsp;Change History</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="infosources.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;I.&nbsp;The Basics</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="pt02.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="changes"></a>Chapter&nbsp;10.&nbsp;Change History</h2></div></div><div></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2403"></a>Changes For Version 1.2.5 (March 1, 2005)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>The change made for FXRuby version 1.2.4 regarding garbage collection
4
- for table items corrected only one of the problems described in
5
- <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1445&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1445</a>;
6
- There was still a problem related to the "destructive" effects of the
7
- <tt class="methodname">setTableSize</tt> method for the <tt class="classname">FXTable</tt> class.
8
- This problem has now been corrected as well. Thanks to David Peoples,
9
- Jamey Cribbs and Joel VanderWerf for their assistance in helping me to
10
- track down this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">extractText</tt> and <tt class="methodname">overlayText</tt>
11
- methods for the <tt class="classname">FXTable</tt> class were implemented incorrectly and
12
- weren't listed in the API documentation. These problems have been corrected.</p></li><li style="list-style-type: disc"><p>The checks for out-of-bounds indices in the <tt class="methodname">getColumnX</tt>,
13
- <tt class="methodname">setColumnX</tt>, <tt class="methodname">getRowY</tt>,
14
- <tt class="methodname">setRowY</tt> and <tt class="methodname">updateRange</tt> methods
15
- for the <tt class="classname">FXTable</tt> class were incorrect. These have been
16
- fixed.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">setTableSize</tt> method for the
17
- <tt class="classname">FXTable</tt> class now raises <tt class="classname">ArgError</tt>
18
- if either the number of rows or columns passed in as arguments is less
19
- than zero.</p></li><li style="list-style-type: disc"><p>A typo in one of the source files was causing the build to fail
20
- when compiled against Ruby versions 1.8.1 or earlier (see
21
- <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1551&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1551</a>).
22
- This error has been corrected. Thanks to Alex McGuire for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">selectItem</tt> method for the <tt class="classname">FXTable</tt> class
23
- was removed in FOX 1.2, so we've added a convenience method for this that just calls the
24
- <tt class="methodname">selectRange</tt> method under the hood (see
25
- <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1562&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1562</a>).
26
- Thanks to Joel VanderWerf for this suggestion.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.13 and FXScintilla version 1.62.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2488"></a>Changes For Version 1.2.4 (February 23, 2005)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>Due to a change in some of the internal Ruby C APIs, a compile-time error for FXRuby
27
- was introduced in some of the Ruby 1.8.2 preview releases
28
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1039&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1039</a>).
29
- One should not see any compile-time errors when compiling FXRuby (versions 1.2.3 or later) against the Ruby 1.8.2
30
- final release, but I've neverthless made a change to how those internal APIs are used, to avoid any potential
31
- problems. Thanks to the many users who pointed out this problem.</p></li><li style="list-style-type: disc"><p>Joel VanderWerf suggested some enhancements to the <tt class="filename">image.rb</tt> example program
32
- in order to improve its startup time
33
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1281&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1281</a>).
34
- Those changes have been incorporated. Thanks to Joel for this suggestion.</p></li><li style="list-style-type: disc"><p>One change for the <tt class="classname">FXImage</tt> class between FOX versions 1.0
35
- and 1.2 is the nature of the pixel buffer that's passed to the <tt class="classname">FXImage</tt>
36
- constructor. Previously, this pixel buffer was expected to be a string of bytes; now it's expected
37
- to be an array of <span class="type">FXColor</span> values.
38
- This modification was not implemented correctly for FXRuby versions 1.2.3 and earlier
39
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1427&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1427</a>).
40
- This bug has been corrected, and the example program (<tt class="filename">image.rb</tt>) and
41
- test cases have been updated as well.
42
- Thanks to Oliver Smith and others for reporting this problem.</p></li><li style="list-style-type: disc"><p>A couple of different problems, reported by Patrick Fernie and David Peoples, exposed
43
- a flaw in how FXRuby manages the links between FOX objects and their Ruby peers when the
44
- FOX objects are destroyed
45
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1445&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1445</a>).
46
- Without going into all the gory details, let's just say that since we
47
- have no explicit control over when Ruby's garbage collector decides to
48
- "collect" those Ruby peers that point to C++ objects that have been
49
- destroyed, we need to take steps to neutralize those Ruby peer objects
50
- so that they can't cause your application to crash in the meantime; I've
51
- implemented a fix to take care of this situation.
52
- Thanks to Patrick and David for reporting these problems.</p></li><li style="list-style-type: disc"><p>The API documentation for FXRuby 1.2 still contained references
53
- to the old "spellings" of the <tt class="methodname">fxparseAccel</tt>
54
- and <tt class="methodname">fxparseHotKey</tt> method names, which were all
55
- lowercase (i.e. <tt class="methodname">fxparseaccel</tt> and
56
- <tt class="methodname">fxparsehotkey</tt>).
57
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1470&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1470</a>).
58
- These errors have been corrected.</p></li><li style="list-style-type: disc"><p>Added the <tt class="methodname">FXScrollArea#scrollCorner</tt> method, which returns a reference to the
59
- scroll corner for any window derived from <tt class="classname">FXScrollArea</tt>
60
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=843&amp;group_id=300&amp;atid=1226" target="_top">RubyForge Feature Request #1226</a>).
61
- Thanks to Brian Sheehan for this suggestion.</p></li><li style="list-style-type: disc"><p>Added the <tt class="methodname">FXMemoryBuffer#to_a</tt> method, which is just an alias for the
62
- <tt class="methodname">data</tt> accessor method that returns a copy of the data buffer as an array
63
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1295&amp;group_id=300&amp;atid=1226" target="_top">RubyForge Feature Request #1295</a>).
64
- Thanks to Meinrad Recheis for this suggestion.</p></li><li style="list-style-type: disc"><p>Added the <tt class="methodname">appendRows</tt> and <tt class="methodname">appendColumns</tt>
65
- methods to the <tt class="classname">FXTable</tt> class
66
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1426&amp;group_id=300&amp;atid=1226" target="_top">RubyForge Feature Request #1295</a>).
67
- Thanks to Brett Hallett for this suggestion.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.13 and FXScintilla version 1.62.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2591"></a>Changes For Version 1.2.3 (January 22, 2005)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>Since group boxes containing radio buttons no longer enforce the radio behavior
68
- of radio buttons (i.e. keeping only one radio button selected at a time), some of the
69
- example programs were no longer working as desired (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=751&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #751</a> and
70
- <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1280&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1280</a>).
71
- This problem has been corrected.
72
- Thanks to Yuri Leikind and Barry DeZonia for reporting this problem.</p></li><li style="list-style-type: disc"><p>Bob Sidebotham reported a little typo in the <tt class="filename">table.rb</tt> example program
73
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=990&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #990</a>).
74
- This has been corrected.</p></li><li style="list-style-type: disc"><p>The API documentation for <tt class="classname">FXList</tt> did not reflect the
75
- changes for FOX 1.2; the <tt class="methodname">retrieveItem()</tt> has been renamed
76
- to <tt class="methodname">getItem()</tt> and <tt class="methodname">insertItem()</tt>
77
- has been renamed to <tt class="methodname">setItem()</tt> (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1037&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1037</a>
78
- and
79
- <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1257&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1257</a>).
80
- This has been corrected.
81
- Thanks to Remy Drouilhet and Stephan Kamper for reporting this problem.</p></li><li style="list-style-type: disc"><p>The Windows installer was missing some of the documentation files (see
82
- <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1139&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1139</a>).
83
- This has been corrected.
84
- Thanks to Curt Hibbs and Mark Smith for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="filename">browser.rb</tt> example program was broken (see
85
- <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1146&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1146</a>).
86
- This has been corrected.
87
- Thanks to Stefan Lang for reporting this problem.</p></li><li style="list-style-type: disc"><p>The attribute setter for <tt class="methodname">FXHeaderItem#justification</tt>
88
- was defined incorrectly (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1276&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1276</a>). This has been corrected.
89
- Thanks to Joel VanderWerf for reporting this problem (and providing a patch to fix it).</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">filenames</tt> alias for the <tt class="methodname">FXFileDialog#getFilenames()</tt>
90
- instance method was missing
91
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1277&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1277</a>).
92
- This error has been corrected.
93
- Thanks to Barry DeZonia for reporting this problem.</p></li><li style="list-style-type: disc"><p>The API documentation for the <tt class="classname">FXFileDialog</tt> class methods <tt class="methodname">getOpenFilenames()</tt>,
94
- <tt class="methodname">getOpenDirectory()</tt>, <tt class="methodname">getOpenFilename()</tt> and <tt class="methodname">getSaveFilename()</tt> was extremely inadequate
95
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1279&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1279</a>).
96
- This documentation has been improved.
97
- Thanks to Barry DeZonia for reporting this problem.</p></li><li style="list-style-type: disc"><p>Brett Hallett contributed a Ruby port of the "ratio" example program from the regular
98
- FOX distribution, for demonstrating the use of the new <tt class="classname">FXSpring</tt> layout manager
99
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1282&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1282</a>).
100
- Many thanks to Brett for this addition!</p></li><li style="list-style-type: disc"><p>Joel VanderWerf contributed code to simplify how programs interact with
101
- modal and non-modal dialog boxes (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1283&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1283</a>).
102
- See the API documentation for the new <tt class="methodname">FXDialogBox#execute_modal</tt>
103
- and <tt class="methodname">FXDialogBox#execute_nonmodal</tt> methods for examples of their use.</p></li><li style="list-style-type: disc"><p>The attribute setters for <tt class="methodname">FXRealSpinner#selBackColor</tt> and
104
- <tt class="methodname">FXSpinner#selBackColor</tt> were defined incorrectly (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1297&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1297</a>). These have been corrected.
105
- Thanks to Meinrad Recheis for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">tooltipPause</tt> attribute reader for the <tt class="classname">FXApp</tt> class was missing
106
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1306&amp;group_id=300&amp;atid=1225" target="_top">RubyForge Patch #1306</a>).
107
- Thanks to Joel VanderWerf for reporting this omission and providing a patch to fix it.</p></li><li style="list-style-type: disc"><p>The API documentation for the <tt class="classname">FXToolBarTab</tt> class was missing
108
- (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1322&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1322</a>).
109
- Thanks to Joel VanderWerf for reporting this omission.</p></li><li style="list-style-type: disc"><p>The attribute accessors for <tt class="methodname">FXText#visibleRows</tt> and
110
- <tt class="methodname">FXText#visibleColumns</tt> were defined and documented incorrectly (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1325&amp;group_id=300&amp;atid=1223" target="_top">RubyForge Bug #1325</a>). These have been corrected.
111
- Thanks to Karl El-Koura for reporting this problem.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.13 and
112
- FXScintilla version 1.62.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2763"></a>Changes For Version 1.2.2 (October 1, 2004)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>In order to avoid versioning problems when dealing with a mix of
3
+ <title>Chapter&nbsp;10.&nbsp;Change History</title><meta name="generator" content="DocBook XSL Stylesheets V1.61.2"><link rel="home" href="book.html" title="Developing Graphical User Interfaces with FXRuby"><link rel="up" href="pt01.html" title="Part&nbsp;I.&nbsp;The Basics"><link rel="previous" href="infosources.html" title="Chapter&nbsp;9.&nbsp;Other Sources of Information"><link rel="next" href="pt02.html" title="Part&nbsp;II.&nbsp;Appendices"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter&nbsp;10.&nbsp;Change History</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="infosources.html">Prev</a>&nbsp;</td><th width="60%" align="center">Part&nbsp;I.&nbsp;The Basics</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="pt02.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="changes"></a>Chapter&nbsp;10.&nbsp;Change History</h2></div></div><div></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2403"></a>Changes For Version 1.2.6 (April 15, 2005)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>Some additional problems related to calling the
4
+ <tt class="methodname">setTableSize</tt> method for an
5
+ <tt class="classname">FXTable</tt> were discovered (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1597&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
6
+ Bug #1597</a>). This problem has been corrected. Thanks to Joel
7
+ VanderWerf for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="filename">iconlist.rb</tt> example program had a
8
+ "Sort" pulldown menu filled with a number of commands that didn't
9
+ really do anything, including sorting the items (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1654&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
10
+ Bug #1654</a>). This pulldown menu has been removed from that
11
+ example.</p></li><li style="list-style-type: disc"><p>The API documentation for the <tt class="classname">FXDC</tt> class
12
+ erroneously referred to the <tt class="methodname">font</tt> attribute as
13
+ <tt class="methodname">textFont</tt> (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1667&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
14
+ Bug #1667</a>). This problem has been corrected. Thanks to Meinrad
15
+ Recheis for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">checked?</tt>,
16
+ <tt class="methodname">unchecked?</tt> and
17
+ <tt class="methodname">maybe?</tt> methods for the
18
+ <tt class="classname">FXMenuCheck</tt> class were missing (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1677&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
19
+ Bug #1677</a>). This problem has been corrected. Thanks to Oliver
20
+ Smith for reporting this problem.</p></li><li style="list-style-type: disc"><p>The API documentation for the
21
+ <tt class="classname">FXScrollArea</tt> class incorrectly spelled the
22
+ names of the <tt class="methodname">horizontalScrollBar</tt> and
23
+ <tt class="methodname">verticalScrollBar</tt> methods as
24
+ <tt class="methodname">horizontalScrollbar</tt> and
25
+ <tt class="methodname">verticalScrollbar</tt> (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1678&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
26
+ Bug #1678</a>). The documentation has been corrected. Thanks to
27
+ Jannis Pohlmann for reporting this mistake.</p></li><li style="list-style-type: disc"><p>Some code in the <tt class="filename">groupbox.rb</tt> example
28
+ program was calling the <tt class="methodname">getRootWindow</tt> method,
29
+ but that method has been renamed to <tt class="methodname">getRoot</tt>
30
+ (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1692&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
31
+ Bug #1692</a>). This problem has been corrected. Thanks to
32
+ Jaroslav Stika for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">hasChar?</tt> method for the
33
+ <tt class="classname">FXFont</tt> class was spelled without a trailing
34
+ question mark, but it seems more Ruby-like that it should, so we've
35
+ added an alias for that (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1714&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
36
+ Bug #1714</a>). This method also now accepts a string of size 1
37
+ (i.e. a single character) as its input, as an alternative to an
38
+ ordinal value. Thanks to Meinrad Recheis for these suggestions.</p></li><li style="list-style-type: disc"><p>The API documentation for the <tt class="classname">FXImage</tt>
39
+ class mistakenly listed <tt class="constant">IMAGE_ALPHA</tt> as a valid
40
+ image rendering hint, but this flag is no longer needed since FOX
41
+ images now always contain an alpha channel (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1715&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
42
+ Bug #1715</a>). The documentation has been corrected. Thanks to
43
+ Meinrad Recheis for reporting this mistake.</p></li><li style="list-style-type: disc"><p>Due to an error in the SWIG interface files, the
44
+ <tt class="methodname">data</tt> method for the
45
+ <tt class="classname">FXSettings</tt> class was not being wrapped
46
+ properly. As a result, this method was unavailable and in turn led to
47
+ other dependent methods (like <tt class="methodname">each_section</tt>)
48
+ to be unavailable as well (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1771&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
49
+ Bug #1771</a>). This error has been corrected. Thanks to Jannis
50
+ Pohlmann for reporting this problem.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.16 and
51
+ FXScintilla version 1.62.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2539"></a>Changes For Version 1.2.5 (March 1, 2005)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>The change made for FXRuby version 1.2.4 regarding garbage
52
+ collection for table items corrected only one of the problems
53
+ described in <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1445&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
54
+ Bug #1445</a>; There was still a problem related to the
55
+ "destructive" effects of the <tt class="methodname">setTableSize</tt>
56
+ method for the <tt class="classname">FXTable</tt> class. This problem has
57
+ now been corrected as well. Thanks to David Peoples, Jamey Cribbs and
58
+ Joel VanderWerf for their assistance in helping me to track down this
59
+ problem.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">extractText</tt> and
60
+ <tt class="methodname">overlayText</tt> methods for the
61
+ <tt class="classname">FXTable</tt> class were implemented incorrectly and
62
+ weren't listed in the API documentation. These problems have been
63
+ corrected.</p></li><li style="list-style-type: disc"><p>The checks for out-of-bounds indices in the
64
+ <tt class="methodname">getColumnX</tt>,
65
+ <tt class="methodname">setColumnX</tt>, <tt class="methodname">getRowY</tt>,
66
+ <tt class="methodname">setRowY</tt> and
67
+ <tt class="methodname">updateRange</tt> methods for the
68
+ <tt class="classname">FXTable</tt> class were incorrect. These have been
69
+ fixed.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">setTableSize</tt> method for the
70
+ <tt class="classname">FXTable</tt> class now raises
71
+ <tt class="classname">ArgError</tt> if either the number of rows or
72
+ columns passed in as arguments is less than zero.</p></li><li style="list-style-type: disc"><p>A typo in one of the source files was causing the build to fail
73
+ when compiled against Ruby versions 1.8.1 or earlier (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1551&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
74
+ Bug #1551</a>). This error has been corrected. Thanks to Alex
75
+ McGuire for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">selectItem</tt> method for the
76
+ <tt class="classname">FXTable</tt> class was removed in FOX 1.2, so we've
77
+ added a convenience method for this that just calls the
78
+ <tt class="methodname">selectRange</tt> method under the hood (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1562&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
79
+ Bug #1562</a>). Thanks to Joel VanderWerf for this
80
+ suggestion.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.13 and
81
+ FXScintilla version 1.62.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2624"></a>Changes For Version 1.2.4 (February 23, 2005)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>Due to a change in some of the internal Ruby C APIs, a
82
+ compile-time error for FXRuby was introduced in some of the Ruby 1.8.2
83
+ preview releases (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1039&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
84
+ Bug #1039</a>). One should not see any compile-time errors when
85
+ compiling FXRuby (versions 1.2.3 or later) against the Ruby 1.8.2
86
+ final release, but I've neverthless made a change to how those
87
+ internal APIs are used, to avoid any potential problems. Thanks to the
88
+ many users who pointed out this problem.</p></li><li style="list-style-type: disc"><p>Joel VanderWerf suggested some enhancements to the
89
+ <tt class="filename">image.rb</tt> example program in order to improve its
90
+ startup time (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1281&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
91
+ Bug #1281</a>). Those changes have been incorporated. Thanks to
92
+ Joel for this suggestion.</p></li><li style="list-style-type: disc"><p>One change for the <tt class="classname">FXImage</tt> class between
93
+ FOX versions 1.0 and 1.2 is the nature of the pixel buffer that's
94
+ passed to the <tt class="classname">FXImage</tt> constructor. Previously,
95
+ this pixel buffer was expected to be a string of bytes; now it's
96
+ expected to be an array of <span class="type">FXColor</span> values. This
97
+ modification was not implemented correctly for FXRuby versions 1.2.3
98
+ and earlier (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1427&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
99
+ Bug #1427</a>). This bug has been corrected, and the example
100
+ program (<tt class="filename">image.rb</tt>) and test cases have been
101
+ updated as well. Thanks to Oliver Smith and others for reporting this
102
+ problem.</p></li><li style="list-style-type: disc"><p>A couple of different problems, reported by Patrick Fernie and
103
+ David Peoples, exposed a flaw in how FXRuby manages the links between
104
+ FOX objects and their Ruby peers when the FOX objects are destroyed
105
+ (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1445&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
106
+ Bug #1445</a>). Without going into all the gory details, let's
107
+ just say that since we have no explicit control over when Ruby's
108
+ garbage collector decides to "collect" those Ruby peers that point to
109
+ C++ objects that have been destroyed, we need to take steps to
110
+ neutralize those Ruby peer objects so that they can't cause your
111
+ application to crash in the meantime; I've implemented a fix to take
112
+ care of this situation. Thanks to Patrick and David for reporting
113
+ these problems.</p></li><li style="list-style-type: disc"><p>The API documentation for FXRuby 1.2 still contained references
114
+ to the old "spellings" of the <tt class="methodname">fxparseAccel</tt>
115
+ and <tt class="methodname">fxparseHotKey</tt> method names, which were
116
+ all lowercase (i.e. <tt class="methodname">fxparseaccel</tt> and
117
+ <tt class="methodname">fxparsehotkey</tt>). (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1470&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
118
+ Bug #1470</a>). These errors have been corrected.</p></li><li style="list-style-type: disc"><p>Added the <tt class="methodname">FXScrollArea#scrollCorner</tt>
119
+ method, which returns a reference to the scroll corner for any window
120
+ derived from <tt class="classname">FXScrollArea</tt> (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=843&amp;group_id=300&amp;atid=1226" target="_top">RubyForge
121
+ Feature Request #1226</a>). Thanks to Brian Sheehan for this
122
+ suggestion.</p></li><li style="list-style-type: disc"><p>Added the <tt class="methodname">FXMemoryBuffer#to_a</tt> method,
123
+ which is just an alias for the <tt class="methodname">data</tt> accessor
124
+ method that returns a copy of the data buffer as an array (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1295&amp;group_id=300&amp;atid=1226" target="_top">RubyForge
125
+ Feature Request #1295</a>). Thanks to Meinrad Recheis for this
126
+ suggestion.</p></li><li style="list-style-type: disc"><p>Added the <tt class="methodname">appendRows</tt> and
127
+ <tt class="methodname">appendColumns</tt> methods to the
128
+ <tt class="classname">FXTable</tt> class (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1426&amp;group_id=300&amp;atid=1226" target="_top">RubyForge
129
+ Feature Request #1295</a>). Thanks to Brett Hallett for this
130
+ suggestion.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.13 and
131
+ FXScintilla version 1.62.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2727"></a>Changes For Version 1.2.3 (January 22, 2005)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>Since group boxes containing radio buttons no longer enforce the
132
+ radio behavior of radio buttons (i.e. keeping only one radio button
133
+ selected at a time), some of the example programs were no longer
134
+ working as desired (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=751&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
135
+ Bug #751</a> and <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1280&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
136
+ Bug #1280</a>). This problem has been corrected. Thanks to Yuri
137
+ Leikind and Barry DeZonia for reporting this problem.</p></li><li style="list-style-type: disc"><p>Bob Sidebotham reported a little typo in the
138
+ <tt class="filename">table.rb</tt> example program (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=990&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
139
+ Bug #990</a>). This has been corrected.</p></li><li style="list-style-type: disc"><p>The API documentation for <tt class="classname">FXList</tt> did not
140
+ reflect the changes for FOX 1.2; the
141
+ <tt class="methodname">retrieveItem()</tt> has been renamed to
142
+ <tt class="methodname">getItem()</tt> and
143
+ <tt class="methodname">insertItem()</tt> has been renamed to
144
+ <tt class="methodname">setItem()</tt> (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1037&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
145
+ Bug #1037</a> and <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1257&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
146
+ Bug #1257</a>). This has been corrected. Thanks to Remy Drouilhet
147
+ and Stephan Kamper for reporting this problem.</p></li><li style="list-style-type: disc"><p>The Windows installer was missing some of the documentation
148
+ files (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1139&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
149
+ Bug #1139</a>). This has been corrected. Thanks to Curt Hibbs and
150
+ Mark Smith for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="filename">browser.rb</tt> example program was broken
151
+ (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1146&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
152
+ Bug #1146</a>). This has been corrected. Thanks to Stefan Lang for
153
+ reporting this problem.</p></li><li style="list-style-type: disc"><p>The attribute setter for
154
+ <tt class="methodname">FXHeaderItem#justification</tt> was defined
155
+ incorrectly (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1276&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
156
+ Bug #1276</a>). This has been corrected. Thanks to Joel VanderWerf
157
+ for reporting this problem (and providing a patch to fix it).</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">filenames</tt> alias for the
158
+ <tt class="methodname">FXFileDialog#getFilenames()</tt> instance method
159
+ was missing (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1277&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
160
+ Bug #1277</a>). This error has been corrected. Thanks to Barry
161
+ DeZonia for reporting this problem.</p></li><li style="list-style-type: disc"><p>The API documentation for the
162
+ <tt class="classname">FXFileDialog</tt> class methods
163
+ <tt class="methodname">getOpenFilenames()</tt>,
164
+ <tt class="methodname">getOpenDirectory()</tt>,
165
+ <tt class="methodname">getOpenFilename()</tt> and
166
+ <tt class="methodname">getSaveFilename()</tt> was extremely inadequate
167
+ (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1279&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
168
+ Bug #1279</a>). This documentation has been improved. Thanks to
169
+ Barry DeZonia for reporting this problem.</p></li><li style="list-style-type: disc"><p>Brett Hallett contributed a Ruby port of the "ratio" example
170
+ program from the regular FOX distribution, for demonstrating the use
171
+ of the new <tt class="classname">FXSpring</tt> layout manager (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1282&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
172
+ Bug #1282</a>). Many thanks to Brett for this addition!</p></li><li style="list-style-type: disc"><p>Joel VanderWerf contributed code to simplify how programs
173
+ interact with modal and non-modal dialog boxes (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1283&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
174
+ Bug #1283</a>). See the API documentation for the new
175
+ <tt class="methodname">FXDialogBox#execute_modal</tt> and
176
+ <tt class="methodname">FXDialogBox#execute_nonmodal</tt> methods for
177
+ examples of their use.</p></li><li style="list-style-type: disc"><p>The attribute setters for
178
+ <tt class="methodname">FXRealSpinner#selBackColor</tt> and
179
+ <tt class="methodname">FXSpinner#selBackColor</tt> were defined
180
+ incorrectly (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1297&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
181
+ Bug #1297</a>). These have been corrected. Thanks to Meinrad
182
+ Recheis for reporting this problem.</p></li><li style="list-style-type: disc"><p>The <tt class="methodname">tooltipPause</tt> attribute reader for
183
+ the <tt class="classname">FXApp</tt> class was missing (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1306&amp;group_id=300&amp;atid=1225" target="_top">RubyForge
184
+ Patch #1306</a>). Thanks to Joel VanderWerf for reporting this
185
+ omission and providing a patch to fix it.</p></li><li style="list-style-type: disc"><p>The API documentation for the
186
+ <tt class="classname">FXToolBarTab</tt> class was missing (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1322&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
187
+ Bug #1322</a>). Thanks to Joel VanderWerf for reporting this
188
+ omission.</p></li><li style="list-style-type: disc"><p>The attribute accessors for
189
+ <tt class="methodname">FXText#visibleRows</tt> and
190
+ <tt class="methodname">FXText#visibleColumns</tt> were defined and
191
+ documented incorrectly (see <a href="http://rubyforge.org/tracker/index.php?func=detail&amp;aid=1325&amp;group_id=300&amp;atid=1223" target="_top">RubyForge
192
+ Bug #1325</a>). These have been corrected. Thanks to Karl El-Koura
193
+ for reporting this problem.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.13 and
194
+ FXScintilla version 1.62.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2899"></a>Changes For Version 1.2.2 (October 1, 2004)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>In order to avoid versioning problems when dealing with a mix of
113
195
  applications based on either FXRuby 1.0 or 1.2, the feature name for
114
196
  FXRuby has been changed from "fox" to "fox12". For most application
115
197
  developers, this means that you will need to modify the source code
@@ -117,7 +199,7 @@
117
199
  changes should be required for legacy applications targeted at FXRuby
118
200
  1.0.</p></li><li style="list-style-type: disc"><p>Made a number of updates to the documentation, to reflect API
119
201
  changes for FXRuby 1.2.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.9 and
120
- FXScintilla version 1.61.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2780"></a>Changes For Version 1.2a2 (July 10, 2004)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>This is the second "alpha" release of FXRuby 1.2. This release
202
+ FXScintilla version 1.61.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2916"></a>Changes For Version 1.2a2 (July 10, 2004)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>This is the second "alpha" release of FXRuby 1.2. This release
121
203
  should be compatible with any FOX library version 1.2; it is not
122
204
  compatible with any previous FOX library versions. As this is an alpha
123
205
  release, users should expect a certain amount of instability, bugs,
@@ -159,7 +241,7 @@
159
241
  or JPEG image support built-in (see <a href="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=986180&amp;group_id=20243&amp;atid=120243" target="_top">SourceForge
160
242
  Bug #986180</a>). This has been fixed. Thanks to Bil Bas for
161
243
  reporting this problem.</p></li><li style="list-style-type: disc"><p>The binary gem for Windows was built with FOX version 1.2.7 and
162
- FXScintilla version 1.61.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2889"></a>Changes For Version 1.2a1 (June 28, 2004)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>This is the first "alpha" release of FXRuby 1.2. This release
244
+ FXScintilla version 1.61.</p></li></ul></div></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e3025"></a>Changes For Version 1.2a1 (June 28, 2004)</h2></div></div><div></div></div><div class="itemizedlist"><ul type="bullet"><li style="list-style-type: disc"><p>This is the first "alpha" release of FXRuby 1.2. This release
163
245
  should be compatible with any FOX library version 1.2; it is not
164
246
  compatible with any previous FOX library versions. As this is an alpha
165
247
  release, users should expect a certain amount of instability, bugs,
data/doc/cvs.html CHANGED
@@ -19,13 +19,13 @@
19
19
  modified SWIG interface files. I always use the latest development version
20
20
  of <a href="http://www.swig.org" target="_top">SWIG</a>, but any release after,
21
21
  say, SWIG 1.3.15 should work fine. The older SWIG 1.1 releases will
22
- definitely <span class="emphasis"><em>not</em></span> work.</p><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e4103"></a>Checking out the stable version</h2></div></div><div></div></div><p>The stable version of FXRuby is the 1.0.x branch and is compatible
22
+ definitely <span class="emphasis"><em>not</em></span> work.</p><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e4239"></a>Checking out the stable version</h2></div></div><div></div></div><p>The stable version of FXRuby is the 1.0.x branch and is compatible
23
23
  with any of the FOX 1.0.x releases. It is <span class="emphasis"><em>not</em></span>
24
24
  compatible with any other release branches of FOX (e.g. the FOX 1.2.x or
25
25
  1.3.x series of releases).</p><p>To check out the stable version of FXRuby, do the following:</p><div class="orderedlist"><ol type="1"><li><p>Log in to the CVS server by typing:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="screen">cvs -d:pserver:anonymous@rubyforge.org:/var/cvs/fxruby login</pre></td></tr></table><p>When prompted for a password for <span class="emphasis"><em>anonymous</em></span>,
26
26
  simply press the <b class="keycap">Enter</b> key.</p></li><li><p>Check out the stable branch of FXRuby by typing:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="screen">cvs -z3 -d:pserver:anonymous@rubyforge.org:/var/cvs/fxruby co -rrelease10 FXRuby</pre></td></tr></table></li></ol></div><p>At this point, you should be ready to change to the top-level
27
27
  directory and go through the normal build and installation process, as
28
- described in an earlier chapter.</p></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e4136"></a>Regenerating wrapper code with SWIG</h2></div></div><div></div></div><p>If you make changes to any of the SWIG interface files (the files
28
+ described in an earlier chapter.</p></div><div class="simplesect" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e4272"></a>Regenerating wrapper code with SWIG</h2></div></div><div></div></div><p>If you make changes to any of the SWIG interface files (the files
29
29
  ending with a <tt class="filename">.i</tt> extension, in the <tt class="filename">swig-interfaces</tt> subdirectory) you will need
30
30
  to re-run SWIG to regenerate parts of the FXRuby source code:</p><div class="orderedlist"><ol type="1"><li><p>Change directories to the <tt class="filename">swig-interfaces</tt> subdirectory of the
31
31
  FXRuby source tree.</p></li><li><p>Type the following command to create a "bootstrap"