wxruby3 0.9.0.pre.rc.1-x64-mingw-ucrt → 0.9.0.pre.rc.2-x64-mingw-ucrt

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b0789682f3f41499d529e24441bcff8b0ec200db6b1a84cbac198e445f73f33
-  data.tar.gz: f48166b2c460c774916a7d2b177b73bdc353c0c7f3f35c760de3d6aa9a66dd57
+  metadata.gz: c3641fe86e3445b1cc2316d01fdf95f30685ec1cd7db34fa3d6f1a41866d2188
+  data.tar.gz: cafc7d51a9bc984d4d7e73181e3182be25ec45c4589f0af186d2ee1c95dfed6f
 SHA512:
-  metadata.gz: 8f817d5543dcf138ff6c21b161beff6e8e93677db8922d37da6bcebb4a2940a44400c16b9800ee44ccce4b574eecd1eb2c0db909ab464bcbfb0a0cb89870063c
-  data.tar.gz: 113af98388e9253f223fb5176f9722a61b7485f7a4a56dd79080a6eb55aafc3c6929522977d95e0564e7761e4655c8fdc3dde22796a108f8c5ba853329ca4ee0
+  metadata.gz: 333b2b88834008dccd8e07aa9264a8a17fa3d3591fc5e19e1bbcf729f2efd9e98f7ab309f7607f3e2157a8aadb5c4d96388a38db8f9c23b182e2bf19bbb84621
+  data.tar.gz: 5e77c8957774743fdeb71e216dfc71de9d5a626e8eca560c8e9f907e903d60af0368663354d841c066bac9041d98a38360aec63ade4e590e1eceee84643c6ee9

data/INSTALL.md

@@ -4,32 +4,45 @@
 
 # Installation of wxRuby3
 
+## Minimal requirements for installing wxRuby3
+
+The minimal requirements for installing any source based setup (gem, source package or Github clone) of wxRuby3 are:
+
+| Sofware                                       | Notes                                                                                                                                                                                                                           |
+|-----------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Ruby                                          | A supported version of the Ruby interpreter needs to be installed.                                                                                                                                                              |
+| C++ compiler<br>(incl. dev tools like `make`) | On linux a recent version of the GNU C++ compiler (with c++-14 support) needs to be installed<br>On Windows the RubyInstaller MSYS2-Devkit needs to be installed<br>On MacOS XCode with commandline tools needs to be installed |
+| Git version control toolkit                   |                                                                                                                                                                                                                                 |
+| SWIG >= 3.0.12                                | On MacOS install [Homebrew](https://brew.sh/) and than `brew install swig`                                                                                                                                                      |
+| Doxygen (>= 1.9.1, <= 1.9.6)                  | Doxygen > 1.9.6 has changes that cause problems with the wxWidgets doxygen files.<br>On MacOS: `brew tap mcorino/wxruby3` and than `brew install doxygen@1.9.6` (default brew recipe installs 1.9.7)                            |
+
+The wxRuby3 build process requires `git` to clone a copy of the wxWidgets Github repository to extract the interface 
+specifications from.<br>
+The wxRuby3 build process needs doxygen to generated XML files containing wxWidgets interface specs which are used to 
+generate SWIG interface definitions from which SWIG to generates C++ source code for the wrapper interfaces from
+which the native extension is compiled.
+
 ## Installation of a wxRuby3 Gem
 
 The wxRuby3 project provides gems on [RubyGems](https://rubygems.org) which can be installed with the
 standard `gem install` command line this:
 
-```sh
+```shell
 gem install wxruby3
  ```
 
 On Linux systems this will install the source based gem which will automatically build the native wxruby3 extension
 for the platform on which wxRuby3 is being installed.
 On Windows systems a prebuilt binary gem is available for the latest stable release(s) of [RubyInstaller](https://rubyinstaller.org) 
-installed rubies that will be installed by default if installing for that platform. Alternatively the source gem can be
-installed on Windows by installing with explicit platform specification like this:
+installed rubies that will be installed by default if installing for that platform (including an embedded, latest 
+stable version, wxWidgets installation).<br>
+Alternatively the source gem can be installed on Windows by installing with explicit platform specification like this:
 
-```sh
+```shell
 gem install wxruby3 --platform=ruby
 ```
 
-When installing the source gem the following basic requirements apply:
-
-- Git version control toolkit
-- Ruby 2.5 or later (including development package)
-- GNU g++ 4.8 or later on Linux, RubyInstaller+DevKit on Windows
-- [SWIG](https://www.swig.org) 3.0.12 or later
-- [Doxygen](https://www.doxygen.nl/)
+When installing the source gem the minimal requirements listed above apply.
 
 Also a wxWidgets installation (version 3.2 or later) is required for which there are multiple options.
 
@@ -39,38 +52,54 @@ Also a wxWidgets installation (version 3.2 or later) is required for which there
    The wxRuby build procedure will determine the availability and version of wxWidgets by locating and calling
    the `wx-config` utility script. In case no (compatible) wxWidgets version is found installation ends with an error.<br>
    Please note that even with this method a copy of the wxWidgets project will be checked out from GitHUb as the wxRuby3
-   build procedure requires access to the wxWidgets interface specification sources (see [here](TODO) for more details). 
+   build procedure requires access to the wxWidgets interface specification sources which are not normally part of any of 
+   the standard distribution packages.
    
 
 2. User installed wxWidgets version<br>
    <br>
-   In case the being system installed on does not provide (a compatible) wxWidgets version or a specific (possibly updated)
+   In case the system being installed on does not provide (a compatible) wxWidgets version or a specific (possibly updated)
    wxWidgets version is required the source gem can be installed using a user installed version like this (where the 
    `WXWIN` path should provide the location where the wxWidgets binaries are installed under `<wxwin path>/bin`):<br>
 
-```sh
+```shell
    gem install wxruby3 -- WXWIN=/path/to/wx/install 
 ```
    
-3. Automatic installed wxWidgets version<br>
+3. Automatic installed, embedded, wxWidgets version<br>
    <br>
-   This is the easiest method when the being system installed on does not provide (a compatible) wxWidgets version (and 
+   This is the easiest method when the system being installed on does not provide (a compatible) wxWidgets version (and 
    no specific user defined version is required) and can be used by installing the source gem like this (which will
-   cause automatic checkout and building of the latest wxWidgets release (>= 3.2) from GitHub:
-
+   cause automatic checkout and building of the latest stable wxWidgets release (>= 3.2) from GitHub:
 
-```sh
+```shell
    gem install wxruby3 -- WITH_WXWIN=1
 ```
 
+In case of option **2** it is also possible to do the doxygen XML generation as part of the wxWidgets user installation
+and use that for the gem installation. In that case the user is required to generate the XML interface specs using the
+`regen` script found in the `docs/doxygen` folder of the wxWidgets installation after which the XML output folder can be 
+provided to the gem installation as follows:
+
+```shell
+   gem install wxruby3 -- WXWIN=/path/to/wx/install WXXML=/path/to/wx/doxygen/xml
+```
+
+Please also not that in case of option two the user is responsible to make sure the wxWidgets shared libraries can be
+found by the system's dynamic loader at runtime.
+
 > **NOTE:** Be patient when installing the source gem. Building wxRuby3 takes a while and when wxWidgets is included event more. 
 
+> **NOTE:** Be aware that for prerelease versions of the gem you should add the `--pre` argument to the `gem install` command. 
+
 ## Building from source
 
-Checkout the wxRuby3 sources from [GitHub](https://github.com/mcorino/wxRuby3).
+Checkout the wxRuby3 sources from [GitHub](https://github.com/mcorino/wxRuby3) or download and unpack a release package.
 
-Basic requirements are the same as for installing the source gem. Gem dependencies are listed in the Gemfile in the root
-of the wxRuby3 tree.
+Requirements are the same as for installing the source gem. Gem dependencies are listed in the Gemfile in the root
+of the wxRuby3 tree and should be installed by executing `bundle install`.<br>
+To be able to generate HTML documentation the optional `:documentation` group should be included.<br>
+To be able to run the Rake memory check task the option `:develop` group should be included.
 
 The wxRuby3 project provides a Rake based build system. Call `rake help` to get an overview of the available commands.
 As mentioned there the `rake configure` command is required as the very first command. Call `rake configure[--help]` to

data/README.md

@@ -1,9 +1,11 @@
 [![Linux wxGTK](https://github.com/mcorino/wxRuby3/actions/workflows/linux.yml/badge.svg)](https://github.com/mcorino/wxRuby3/actions/workflows/linux.yml)
 [![Windows wxMSW](https://github.com/mcorino/wxRuby3/actions/workflows/msw.yml/badge.svg)](https://github.com/mcorino/wxRuby3/actions/workflows/msw.yml)
+[![Mac wxOSX](https://github.com/mcorino/wxRuby3/actions/workflows/mac.yml/badge.svg)](https://github.com/mcorino/wxRuby3/actions/workflows/mac.yml)
+
 [![License](https://img.shields.io/badge/license-MIT-yellowgreen.svg)](LICENSE)
 [![Gem Version](https://badge.fury.io/rb/wxruby3.svg)](https://badge.fury.io/rb/wxruby3)
-
 [![Documentation](https://img.shields.io/badge/docs-pages-blue.svg)](https://mcorino.github.io/wxRuby3)
+[![Chat](https://img.shields.io/gitter/room/mcorino/wxruby)](https://gitter.im/mcorino/wxruby3)
 
 # README for wxRuby3
 
@@ -33,13 +35,13 @@ Wx::App.run do
 end
 ```
 
-![Hello_World](assets/hello_world.png "Hello World sample")
+![Hello_World](assets/hello_world_combi.png "Hello World sample")
 
 ### Hello Button
 
 Anyone who is familiar with wxWidgets should feel right at home since the API may be Ruby-fied, it is still easily 
 recognizable (but being Ruby-fied allowing for elegant and compact coding). And for those that do not have previous 
-experience do not fear, wxRuby3 comes with detailed [documentation](https://mcorino.github.io/wxRuby3/file.00_starting.html) and lots of examples and test.    
+experience, do not fear, wxRuby3 comes with detailed [documentation](https://mcorino.github.io/wxRuby3/file.00_starting.html) and lots of examples and tests.    
 
 ```ruby
 require 'wx'
@@ -56,8 +58,7 @@ end
 Wx::App.run { TheFrame.new('Hello world!').show }
 ```
 
-![Hello_Button](assets/hello_button.png "Hello Button sample")
-![Hello_Button_Clicked](assets/hello_button_clicked.png "Hello Button sample clicked")
+![Hello_Button_Clicked](assets/hello_button_clicked_combi.png "Hello Button sample clicked")
 
 
 ## wxRuby3 licence
@@ -99,12 +100,39 @@ Currently the following are fully supported:
 |----------------------------------------------------------------------------|-----------------| --- |
 | Windows 10 (tested)<br>(most likely also Windows 11)                       | Ruby >= 2.5<br>(RubyInstaller MSYS2-DevKit) | wxWidgets >= 3.2 |
 | Linux (tested; any AMD-64 distribution)<br>(most likely also i686 and ARM) | Ruby >= 2.5 | wxWidgets >= 3.2 |
+| MacOS >= 10.10 using Cocoa (tested on AMD-64)                              | Ruby >= 2.5 | wxWidgets >= 3.2 | 
 
 Support for other platforms is not being actively developed at present,
 but patches are welcome. It is likely to be much simpler to get wxRuby
 working on similar modern systems (eg FreeBSD or Solaris with GTK) than
 on legacy systems (eg Windows 98, Mac OS 9).
 
+### How can I install wxRuby3?
+
+wxRuby3 is distributed as a Ruby gem on [RubyGems](https://rubygems.org).<br>
+Apart from a regular source-only version of the gem there is also a binary gem version for Windows 10 provided (for the 
+latest stable Ruby version at the time of publishing) which includes an embedded wxWidgets installation (also latest 
+stable version). 
+
+Installing the binary gem version on Windows requires no additional software to be installed except for a supported 
+version of the Ruby interpreter.<br>
+To install the source-only gem the following software is required:
+
+| Sofware                                       | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+|-----------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| Ruby                                          | A supported version of the Ruby interpreter needs to be installed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| C++ compiler<br>(incl. dev tools like `make`) | On linux a recent version of the GNU C++ compiler (with c++-14 support) needs to be installed<br>On Windows the RubyInstaller MSYS2-Devkit needs to be installed<br>On MacOS XCode with commandline tools needs to be installed                                                                                                                                                                                                                                                                                                                                                                                                              |
+| Git version control toolkit                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| SWIG >= 3.0.12                                | On MacOS install [Homebrew](https://brew.sh/) and than `brew install swig`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| Doxygen (>= 1.9.1, <= 1.9.6)                  | Doxygen > 1.9.6 has changes that cause problems with the wxWidgets doxygen files.<br>On MacOS: `brew tap mcorino/wxruby3` and than `brew install doxygen@1.9.6` (default brew recipe installs 1.9.7)                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| wxWidgets >= 3.2 (*OPTIONAL*)                 | On Linux most distributions provide system installable (development) packages for wxWidgets providing a supported version. Alternatively you can fairly easily install your own preferred version manually (see the [wxWidgets](https://wxwidgets.org) project for details).<br>On Windows and MacOS the process is less straightforward (also here see the [wxWidgets](https://wxwidgets.org) project for details).<br>The wxRuby3 source-only gem can also be installed using a private local wxWidgets installation or an embedded installation (most likely preferred on Windows and MacOS). See [INSTALL](INSTALL.md) for more details. |    
+
+In case the prerequisites above are met the (source-only or binary) gem can be installed executing the following command:
+
+```shell
+gem install wxruby3
+```
+
 ### Where can I ask a question, or report a bug?
 
 Use GitHUb Issues.
@@ -180,5 +208,9 @@ maintainable solution.
 
 ### I am getting an error trying to install or compile wxRuby3
 
-Please double-check the [INSTALL](INSTALL.md) documents, and search issue archives. If 
+Please double-check the instructions above and in the [INSTALL](INSTALL.md) document and search issue archives. If 
 this doesn't help, please post your question using GitHub Issues.
+
+### Is there another, more declarative way, for writing wxRuby3 desktop GUI applications?
+
+Yes. [Glimmer DSL for WX](https://github.com/AndyObtiva/glimmer-dsl-wx) enables software engineers to build GUI using wxruby3 following the Ruby way with the least amount of code possible. That is by offering a minimalistic declarative high-level DSL that maps visually to the way software engineers think about the GUI hierarchy in addition to adopting Rails' strategy of Convention over Configuration via smart defaults and automation of wxruby3 low-level details. You can check out the [Glimmer DSL for WX README "Coming From wxruby3" section](https://github.com/AndyObtiva/glimmer-dsl-wx#coming-from-wxruby3) for more information on how to translate wxruby3 apps to [Glimmer DSL for WX](https://github.com/AndyObtiva/glimmer-dsl-wx) syntax.

data/lib/wx/core/brush.rb

@@ -0,0 +1,6 @@
+
+module Wx
+
+  TheBrushList = Wx::Brush
+
+end

data/lib/wx/core/events/evt_list.rb

@@ -1002,6 +1002,12 @@ class Wx::EvtHandler
       Wx::EVT_MEDIA_PAUSE,
       Wx::MediaEvent
     ] if Wx.const_defined?(:EVT_MEDIA_PAUSE)
+  # from wxHyperlinkEvent
+  self.register_event_type EventType[
+      'evt_hyperlink', 1,
+      Wx::EVT_HYPERLINK,
+      Wx::HyperlinkEvent
+    ] if Wx.const_defined?(:EVT_HYPERLINK)
   # from wxCommandEvent
   self.register_event_type EventType[
       'evt_button', 1,
@@ -1388,4 +1394,5 @@ class Wx::EvtHandler
       Wx::EVT_DIRCTRL_FILEACTIVATED,
       Wx::GenericDirCtrl
     ] if Wx.const_defined?(:EVT_DIRCTRL_FILEACTIVATED)
+  # from wxHyperlinkCtrl
 end

data/lib/wx/core/evthandler.rb

@@ -22,9 +22,17 @@ class Wx::EvtHandler
   # methods; used internally by disconnect (see EvtHandler.i)
   EVENT_NAME_TYPE_MAP = {}
   private_constant :EVENT_NAME_TYPE_MAP
+  # Hash to look up event handler arity from symbol names of evt handler
+  # methods; internal use
+  EVENT_NAME_EVENT_ARITY_MAP = {}
+  private_constant :EVENT_NAME_EVENT_ARITY_MAP
 
   class << self
 
+    def event_type_arity(name)
+      EVENT_NAME_EVENT_ARITY_MAP[name.to_sym] || 0
+    end
+
     def get_event_type_class_map
       EVENT_TYPE_CLASS_MAP
     end
@@ -79,8 +87,8 @@ class Wx::EvtHandler
 
   # Given the Integer constant Wx::EVT_XXX, returns the convenience
   # handler method name associated with that type of event.
-  def self.event_name_for_type(name)
-    EVENT_NAME_TYPE_MAP.key(name)
+  def self.event_name_for_type(evt_id)
+    EVENT_NAME_TYPE_MAP.key(evt_id)
   end
 
   # Given an integer value +int_val+, returns the name of the EVT_xxx
@@ -121,6 +129,8 @@ class Wx::EvtHandler
       return
     end
 
+    EVENT_NAME_EVENT_ARITY_MAP[ev_type.name.to_sym] = ev_type.arity
+
     # set up the evt_xxx method
     case ev_type.arity
     when 0 # events without an id

data/lib/wx/core/font.rb

@@ -1,22 +1,30 @@
 
 require_relative './font/encoding'
 
-class Wx::Font
-  class << self
-    # Returns the name of the platform's default font encoding 
-    def get_default_encoding_name
-      ENCODING_NAMES[ get_default_encoding ]
-    end
+module Wx
+
+  class Font
+    class << self
+      # Returns the name of the platform's default font encoding
+      def get_default_encoding_name
+        ENCODING_NAMES[ get_default_encoding ]
+      end
 
-    # Sets the default encoding to be +enc+, which may be the string
-    # name of an encoding (eg 'UTF8') or an internal WxWidgets flag 
-    # (eg Wx::FONTENCODING_UTF8).
-    def set_default_encoding_name(enc)
-      if flag_int = ENCODING_NAMES.index(enc.upcase)
-        set_default_encoding(Wx::FontEncoding.new(flag_int))
-      else
-        raise ArgumentError, "Unknown font encoding name '#{enc}'"
+      # Sets the default encoding to be +enc+, which may be the string
+      # name of an encoding (eg 'UTF8') or an internal WxWidgets flag
+      # (eg Wx::FONTENCODING_UTF8).
+      def set_default_encoding_name(enc)
+        if flag_int = ENCODING_NAMES.index(enc.upcase)
+          set_default_encoding(Wx::FontEncoding.new(flag_int))
+        else
+          raise ArgumentError, "Unknown font encoding name '#{enc}'"
+        end
       end
     end
   end
+
+  # make this simply an alias for the Font class so the #find_or_create_font methods
+  # can be accessed through that name too.
+  TheFontList = Font
+
 end

data/lib/wx/core/helpprovider.rb

@@ -6,9 +6,9 @@ class Wx::HelpProvider
     # SWIG Director; it can't be reaped and re-wrapped later. The
     # easiest way is to make the currently set one an instance variable
     # of this class
-    alias :__wx_set :set
+    wx_set = instance_method :set
     define_method(:set) do | help_provider |
-      __wx_set(help_provider)
+      wx_set.bind(self).call(help_provider)
       @__hp__ = help_provider
     end
   end

data/lib/wx/core/menu.rb

@@ -75,4 +75,9 @@ class Wx::Menu
   methods_with_optional_ids_and_pos :insert,
                                     :insert_check_item,
                                     :insert_radio_item
+
+  # wxRuby2 backward compatibility version; no alias as #append has been altered above
+  def append_item(*args)
+    append(*args)
+  end
 end

data/lib/wx/core/pen.rb

@@ -0,0 +1,6 @@
+
+module Wx
+
+  ThePenList = Wx::Pen
+
+end

data/lib/wx/core/window.rb

@@ -1,5 +1,6 @@
 # Copyright 2004-2007 by Kevin Smith
-# released under the MIT-style wxruby2 license
+# Copyright 2022 by Martin Corino
+# released under the MIT(-style) wxruby2/3 license
 
 # The base class for all things displayed on screen
 class Wx::Window
@@ -69,4 +70,30 @@ class Wx::Window
       self.paint(&block)
     end
   end
+
+  # implement non-static variants of these
+
+  def from_dip(*args)
+    Wx::Window.from_dip(*args, self)
+  end
+  def to_dip(*args)
+    Wx::Window.to_dip(*args, self)
+  end
+
+  def from_phys(*args)
+    Wx::Window.from_phys(*args, self)
+  end
+  def to_phys(*args)
+    Wx::Window.to_phys(*args, self)
+  end
+
+  # implement Window update locker
+  def locked(&block)
+    self.freeze
+    begin
+      block.call if block_given?
+    ensure
+      self.thaw
+    end
+  end
 end

data/lib/wx/doc/app.rb

@@ -0,0 +1,40 @@
+
+class Wx::App
+
+  # Set the menu item id for the About menu item.
+  # Default is {Wx::ID_ABOUT}
+  # @param [Integer] id
+  def set_mac_about_menu_itemid(id) end
+  alias :mac_about_menu_itemid= :set_mac_about_menu_itemid
+  
+  # Get the current menu item id for the About menu item.
+  # Default is {Wx::ID_ABOUT}
+  # @return [Integer]
+  def get_mac_about_menu_itemid(id) end
+  alias :mac_about_menu_itemid :get_mac_about_menu_itemid
+
+  # Set the menu item id for the Preferences menu item.
+  # Default is {Wx::ID_PREFERENCES}
+  # @param [Integer] id
+  def set_mac_preferences_menu_itemid(id) end
+  alias :mac_preferences_menu_itemid= :set_mac_preferences_menu_itemid
+
+  # Get the current menu item id for the Preferences menu item.
+  # Default is {Wx::ID_PREFERENCES}
+  # @return [Integer]
+  def get_mac_preferences_menu_itemid(id) end
+  alias :mac_preferences_menu_itemid :get_mac_preferences_menu_itemid
+
+  # Set the menu item id for the Exit menu item.
+  # Default is {Wx::ID_EXIT}
+  # @param [Integer] id
+  def set_mac_exit_menu_itemid(id) end
+  alias :mac_exit_menu_itemid= :set_mac_exit_menu_itemid
+
+  # Get the current menu item id for the Exit menu item.
+  # Default is {Wx::ID_EXIT}
+  # @return [Integer]
+  def get_mac_exit_menu_itemid(id) end
+  alias :mac_exit_menu_itemid :get_mac_exit_menu_itemid
+  
+end

data/lib/wx/doc/brush.rb

@@ -0,0 +1,17 @@
+
+module Wx
+
+  class Brush
+
+    # Finds a brush with the specified attributes in the global list and returns it, else creates a new brush, adds it to the global brush list, and returns it.
+    # @param [Wx::Colour,String,Symbol] colour The Brush colour.
+    # @param [Wx::BrushStyle] style The brush style. See {Wx::BrushStyle} for a list of the styles.
+    # @return [Wx::Brush]
+    def self.find_or_create_brush(colour, style=Wx::BrushStyle::BRUSHSTYLE_SOLID) end
+
+  end
+
+  # In wxRuby this is simply an alias for the Brush class.
+  TheBrushList = Wx::Brush
+
+end

data/lib/wx/doc/font.rb

@@ -0,0 +1,27 @@
+
+class Wx
+  class Font
+
+    # @overload find_or_create_font(point_size, family, style, weight, underline=false, facename='', encoding=Wx::FontEncoding::FONTENCODING_DEFAULT)
+    #   Finds a font of the given specification in the global font list, or creates one and adds it to the list.
+    #   @param [Integer] point_size Size in points. See {Wx::Font#set_point_size} for more info.
+    #   @param [Wx::FontFamily] family The font family: a generic portable way of referring to fonts without specifying a facename.
+    #   @param [Wx::FontStyle] style One of {Wx::FontStyle::FONTSTYLE_NORMAL}, {Wx::FontStyle::FONTSTYLE_SLANT} and {Wx::FontStyle::FONTSTYLE_ITALIC}.
+    #   @param [Wx::FontWeight] weight Font weight, sometimes also referred to as font boldness. One of the {Wx::FontWeight} enumeration values.
+    #   @param [Boolean] underline The value can be true or false.
+    #   @param [String] facename An optional string specifying the face name to be used. If it is an empty string, a default face name will be chosen based on the family.
+    #   @param [Wx::FontEncoding] encoding An encoding which may be one of the enumeration values of {Wx::FontEncoding}. If the specified encoding isn't available, no font is created (see also Font Encodings).
+    #   @return [Wx::Font]
+    #   @see Wx::Font#initialize
+    # @overload find_or_create_font(font_info)
+    #   Finds a font of the given specification in the global font list, or creates one and adds it to the list.
+    #   @param [Wx::FontInfo] font_info
+    #   @return [Wx::Font]
+    def self.find_or_create_font(*args) end
+
+  end
+
+  # In wxRuby this is simply an alias for the Font class.
+  TheFontList = Font
+
+end

data/lib/wx/doc/gen/activity_indicator.rb

@@ -0,0 +1,65 @@
+# :stopdoc:
+# This file is automatically generated by the WXRuby3 documentation 
+# generator. Do not alter this file.
+# :startdoc:
+
+
+module Wx
+
+  # Small control showing an animation indicating that the program is currently busy performing some background task.
+  # === 
+  # 
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> {Wx::MSW} Appearance
+  #   </td><td> {Wx::GTK} Appearance
+  #   </td><td> {Wx::OSX} Appearance
+  #   </td></tr></table></div>
+  # 
+  class ActivityIndicator < Control
+  
+    # @overload initialize()
+    #   Default constructor.
+    #   Use {Wx::ActivityIndicator#create} to really create the control after using this constructor.
+    #   @return [ActivityIndicator]
+    # @overload initialize(parent, winid=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=("activityindicator"))
+    #   Constructor fully creating the control.
+    #   The arguments have the usual meanings and only parent is typically required.
+    #   @param parent [Wx::Window] 
+    #   @param winid [Integer] 
+    #   @param pos [Array(Integer, Integer), Wx::Point] 
+    #   @param size [Array(Integer, Integer), Wx::Size] 
+    #   @param style [Integer] 
+    #   @param name [String] 
+    #   @return [ActivityIndicator]
+    def initialize(*args) end
+    
+    # Create the control initialized using the default constructor.
+    # This method can be used to finish the control creation if it hadn't been done already by using the non-default constructor.
+    # @param parent [Wx::Window] 
+    # @param winid [Integer] 
+    # @param pos [Array(Integer, Integer), Wx::Point] 
+    # @param size [Array(Integer, Integer), Wx::Size] 
+    # @param style [Integer] 
+    # @param name [String] 
+    # @return [true,false]
+    def create(parent, winid=Wx::StandardID::ID_ANY, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=("activityindicator")) end
+    
+    # Starts animation of the indicator.
+    # Does nothing if the indicator is already running.
+    # @return [void]
+    def start; end
+    
+    # Stops the animation of the indicator.
+    # Notice that the animation is stopped even if {Wx::ActivityIndicator#start} had been called multiple times before, i.e. the calls are not cumulative.
+    # @return [void]
+    def stop; end
+    
+    # Returns true if the control is currently showing activity.
+    # Returns false initially, true once {Wx::ActivityIndicator#start} is called and false again after calling {Wx::ActivityIndicator#stop}.
+    # @return [true,false]
+    def is_running; end
+    alias_method :running?, :is_running
+    
+  end # ActivityIndicator
+  
+
+end

data/lib/wx/doc/gen/aui/aui_tool_bar.rb

@@ -415,8 +415,8 @@ module Wx::AUI
     # If there are custom items set, then the overflow menu will be displayed even if there are no items from the main toolbar that overflow.
     # 
     # The toolbar must have the {Wx::AUI::AuiToolBarStyle::AUI_TB_OVERFLOW} style.
-    # @param prepend [Wx::AuiToolBarItemArray]  are the items to show before any overflow items
-    # @param append [Wx::AuiToolBarItemArray]  are the items to show after any overflow items
+    # @param prepend [Array<Wx::AUI::AuiToolbarItem>,nil]  are the items to show before any overflow items
+    # @param append [Array<Wx::AUI::AuiToolbarItem>,nil]  are the items to show after any overflow items
     # @return [void]
     def set_custom_overflow_items(prepend, append) end