nobody at rubyforge.org
2007-Jul-23  17:23 UTC
[wxruby-development] [1142] trunk/wxruby2/README: Updated README with latest version info and Kevin credit
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type"
content="text/html; charset=utf-8" /><style
type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:'':'';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family:
verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;
font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding:
6px; }
#msg ul, pre { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid;
padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family:
verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch
.binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[1142] trunk/wxruby2/README: Updated README with latest version
info and Kevin credit</title>
</head>
<body>
<div id="msg">
<dl>
<dt>Revision</dt> <dd>1142</dd>
<dt>Author</dt> <dd>brokentoy</dd>
<dt>Date</dt> <dd>2007-07-23 13:23:16 -0400 (Mon, 23 Jul
2007)</dd>
</dl>
<h3>Log Message</h3>
<pre>Updated README with latest version info and Kevin credit</pre>
<h3>Modified Paths</h3>
<ul>
<li><a
href="#trunkwxruby2README">trunk/wxruby2/README</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwxruby2README"></a>
<div class="modfile"><h4>Modified: trunk/wxruby2/README
(1141 => 1142)</h4>
<pre class="diff"><span>
<span class="info">---
trunk/wxruby2/README        2007-07-22
23:15:07 UTC (rev 1141)
+++
trunk/wxruby2/README        2007-07-23
17:23:16 UTC (rev 1142)
</span><span class="lines">@@ -1,5 +1,5 @@
</span><span class="cx"> README for wxruby2
</span><del>-Version 0.0.36
</del><ins>+Version 1.9.0
</ins><span class="cx"> 2006-10-02
</span><span class="cx"> 
</span><span class="cx"> This is wxruby2, the second
generation of wxRuby, a library
</span><span class="lines">@@ -7,12 +7,8 @@
</span><span class="cx"> It is released under a permissive
MIT-style license
</span><span class="cx"> (see the LICENSE file for
details).
</span><span class="cx"> 
</span><del>-*** NOTE ***
-This version is NOT VERY RELIABLE. At least on some platforms, it 
-crashes quite often. Hopefully within a couple more releases 
-it will be stable again (at least as good as it was in 0.0.30, 
-if not better). The API, however, is already pretty stable.
-************
</del><ins>+This version is a beta release, in preparation for a
stable release of
+wxruby version 2.0.
</ins><span class="cx"> 
</span><span class="cx">
------------------------FAQ---------------------------
</span><span class="cx"> 
</span><span class="lines">@@ -64,15 +60,19 @@
</span><span class="cx">
         -
Vastly improved support for OS X
</span><span class="cx">
         - Looks
much better under Linux because it uses GTK+2
</span><span class="cx">
         -
Simpler and more permissive license
</span><del>-        
- Wraps wxWidgets 2.6.3 instead of the older 2.4 series
</del><ins>+        
- Wraps wxWidgets 2.8.3 instead of the older 2.4 series
</ins><span class="cx">
        
</span><span class="cx"> - Is wxruby2 ready for
"production" use?
</span><span class="cx"> 
</span><del>-   No. We are still working on memory handling, so the
current wxruby2
-   code has memory leaks, double-free crashes, and other problems. Thanks 
-   to the power of SWIG, wxruby2 will soon be more stable and reliable 
-   than wxruby 0.6.0 (which also was never really stable enough for 
-   heavy-duty "production" use).
</del><ins>+   No - not quite - but it''s getting close and
you''re invited to give it
+   a try. It is currently a beta release, which fixes many or most of
+   the memory leaks and crashes in earlier "preview" version of
+   wxruby2. This release also includes all the classes and features that
+   are proposed for inclusion in wxruby 2.0.
+
+   It is considerably more stable and fully-featured than the old 0.6.0
+   release, which was never really stable enough for heavy-duty
+   production use.
</ins><span class="cx">    
</span><span class="cx"> - Does wxruby2 support the Xxx
class?
</span><span class="cx"> 
</span><span class="lines">@@ -126,6 +126,10 @@
</span><span class="cx">   and methods. We assume you are
writing your application in Ruby, so it
</span><span class="cx">   makes sense to keep as much
code as possible in Ruby. We have only
</span><span class="cx">   wrapped the wx classes that are
necessary to write GUI code.
</span><ins>+
+  There may be some advantages to porting the Wx network classes into
+  ruby, if they work better with multi-(native)-threaded code. This is
+  currently under evaluation.
</ins><span class="cx">   
</span><span class="cx"> - Why has it taken so long for
wxruby2 to be released?
</span><span class="cx"> 
</span><span class="lines">@@ -137,7 +141,6 @@
</span><span class="cx">   Wrapping wx is a big project
that requires a wide variety of skills. As of
</span><span class="cx">   August 2006, the wxRuby project
has about 30,000 lines of code, including
</span><span class="cx">   ruby, C++, and SWIG scripts. If
we weren''t using SWIG it would be far bigger.
</span><del>-  
</del><span class="cx"> 
</span><span class="cx"> 
</span><span class="cx"> For more details, see the project
home page:
</span><span class="lines">@@ -227,31 +230,38 @@
</span><span class="cx"> - BusyCursor can be used in a
Ruby block to ensure the original cursor
</span><span class="cx">   is always restored.
</span><span class="cx">   
</span><del>-  
</del><ins>+The core wxRuby project is focussed on providing a
mostly
+straightforward port of the C++ library. If you''re interested in a
more
+"ruby-ish" API for writing GUI code, the related "wxSugar"
project is a
+set of higher-level pure-ruby wrappers for exactly this purpose. See the
+wxruby website for more information.
</ins><span class="cx"> 
</span><span class="cx"> 
</span><span class="cx"> ----------------------COMPILING
WXRUBY--------------------------
</span><span class="cx"> REQUIREMENTS TO COMPILE/BUILD
WXRUBY ITSELF
</span><del>-- rake
-- SWIG 1.3.29 or later (NOTE: Earlier versions WILL NOT WORK!)
-- wxWidgets 2.6.3 SDK
</del><span class="cx"> 
</span><ins>+- rake 
+- SWIG, version 1.3.31. SWIG 1.3.29 or later may work; earlier version 
+  definitely won''t
+- wxWidgets 2.8.3 SDK. See further information on the wxruby website for
+  recommended compile-time options for wxWidgets.
</ins><span class="cx"> 
</span><ins>+
</ins><span class="cx"> OBTAINING THE SOURCE:
</span><span class="cx"> 
</span><del>-Source code is hosted in CVS at rubyforge.org. See the
links on
-the wxruby web site (http://wxruby.org). Check out the wxruby2 CVS module 
-(not the old wxruby module).
</del><ins>+Source code is hosted in Subversion at rubyforge.org.
See the links on
+the wxruby web site (http://wxruby.org). Check out the wxruby2
+Subversion module (not the old wxruby module).
</ins><span class="cx">   
</span><span class="cx"> 
</span><span class="cx"> BUILDING:
</span><span class="cx"> 
</span><span class="cx"> From the top-level directory
(typically wxruby2/),
</span><span class="cx"> just start the rake build with
the command:
</span><ins>+
</ins><span class="cx">   rake
</span><span class="cx">   
</span><del>-There is no ./configure step, nor do you need to 
-run ruby extconf.rb. 
</del><ins>+There is no ./configure step, nor do you need to run
ruby extconf.rb.
</ins><span class="cx"> 
</span><span class="cx"> 
</span><span class="cx"> INSTALLING THE LIBRARY:
</span><span class="lines">@@ -267,29 +277,41 @@
</span><span class="cx"> 
</span><span class="cx"> PORTING TO OTHER PLATFORMS
</span><span class="cx"> 
</span><del>-You may need to edit the appropriate platform-dependent
-rake file if your system is not yet supported, or if it
-is unusual. These files are found in the rake subdirectory:
</del><ins>+Platform-dependent rakefiles are used to set up
compiler-specific
+settings. The following platforms are currently fully supported:
</ins><span class="cx"> 
</span><del>-  Mac OSX:              rakemacosx.rb
-  MS Windows VC++:      rakemswin.rb
</del><ins>+  Mac OSX (gcc):        rakemacosx.rb
+  MS Windows (VC++):    rakemswin.rb
+  Linux (GTK2 + gcc):   rakelinux.rb
+  
+For other platforms, you may need to edit the appropriate
+platform-dependent rake file if your system is not yet supported, or if
+it is unusual. These files are found in the rake subdirectory:
+
</ins><span class="cx">   MS Windows BC++:     
rakebccwin.rb
</span><span class="cx">   MS Windows MingGW:   
rakemingw.rb
</span><span class="cx">   MS Windows Cygwin:   
rakecygwin.rb
</span><span class="cx">   NetBSD:              
rakenetbsd.rb
</span><del>-  Linux (GTK2):         rakelinux.rb
</del><span class="cx"> 
</span><span class="cx"> When editing a platform-dependent
rakefile, you might
</span><span class="cx"> merely need to set one or more of
the following variables:
</span><ins>+
</ins><span class="cx">     $extra_cppflags
</span><span class="cx">     $extra_ldflags
</span><span class="cx">     $extra_objs
</span><span class="cx">     $extra_libs
</span><span class="cx"> 
</span><span class="cx"> 
</span><ins>+CREDITS
+
+Kevin Smith set up the wxruby2 project using SWIG and did much of the
+work that still forms the core of the library in its present form. Over
+the years dozens of volunteers have contributed invaluable patches and
+new functionality. The list is too long to give here, but their
+contributions are recorded in the wxruby mailing list archives.
+
</ins><span class="cx">
-----------------------------------------------------------
</span><span class="cx"> 
</span><span class="cx"> LEAD MAINTAINER:
</span><del>-  Kevin Smith
-  http://qualitycode.com
-  mailto:wxruby@qualitycode.com
</del><ins>+  Alex Fenton
+  alex at pressure dot to
</ins></span></pre>
</div>
</div>
</body>
</html>
Maybe Matching Threads
- [1022] trunk/wxruby2/swig/classes/App.i: Memory mgmt: use Wx::App to mark still-alive Windows, set up Wx::THE_APP const
- [724] trunk/wxruby2: Initial commit of HtmlWindow functionality
- [1127] trunk/wxruby2: Move shared C++ GC functions into separate file included into wx.i
- [758] trunk/wxruby2: i18n support: added Locale class, methods for get/set languages & encodings
- [814] trunk/wxruby2/swig/classes: Added ScrollEvent class plus event processing and handler methods
