wxruby3 0.9.7 → 1.0.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wxruby3
 version: !ruby/object:Gem::Version
-  version: 0.9.7
+  version: 1.0.0
 platform: ruby
 authors:
 - Martin Corino
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-05 00:00:00.000000000 Z
+date: 2024-05-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -66,12 +66,27 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: plat4m
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: wxRuby3 is a Ruby library providing an extension for the wxWidgets C++
   UI framework
 email: mcorino@m2c-software.nl
 executables:
 - wxruby
-extensions: []
+extensions:
+- ext/mkrf_conf_ext.rb
 extra_rdoc_files: []
 files:
 - ".yardopts"
@@ -95,6 +110,7 @@ files:
 - assets/logo.xcf
 - assets/repo-social-preview.png
 - bin/wxruby
+- ext/mkrf_conf_ext.rb
 - ext/wxruby3/include/wxRubyApp.h
 - ext/wxruby3/include/wxruby-ClientData.h
 - ext/wxruby3/include/wxruby-ComboPopup.h
@@ -170,6 +186,8 @@ files:
 - lib/wx/core/gauge.rb
 - lib/wx/core/generic_validator.rb
 - lib/wx/core/genericdirctrl.rb
+- lib/wx/core/geometry.rb
+- lib/wx/core/graphics_pen_info.rb
 - lib/wx/core/hboxsizer.rb
 - lib/wx/core/helpcontroller.rb
 - lib/wx/core/helpcontrollerhelpprovider.rb
@@ -199,6 +217,7 @@ files:
 - lib/wx/core/real_point.rb
 - lib/wx/core/rect.rb
 - lib/wx/core/region_iterator.rb
+- lib/wx/core/secret_store.rb
 - lib/wx/core/simplehelpprovider.rb
 - lib/wx/core/size.rb
 - lib/wx/core/sizer.rb
@@ -231,6 +250,7 @@ files:
 - lib/wx/doc/busy_info.rb
 - lib/wx/doc/client_dc.rb
 - lib/wx/doc/clipboard.rb
+- lib/wx/doc/colour.rb
 - lib/wx/doc/colour_dialog.rb
 - lib/wx/doc/comboctrl.rb
 - lib/wx/doc/config.rb
@@ -242,6 +262,7 @@ files:
 - lib/wx/doc/date_picker_ctrl.rb
 - lib/wx/doc/datetime.rb
 - lib/wx/doc/dc.rb
+- lib/wx/doc/dc_overlay.rb
 - lib/wx/doc/editable_listbox.rb
 - lib/wx/doc/enum.rb
 - lib/wx/doc/event.rb
@@ -249,28 +270,13 @@ files:
 - lib/wx/doc/event_loop.rb
 - lib/wx/doc/events.rb
 - lib/wx/doc/evthandler.rb
-- lib/wx/doc/extra/00_starting.md
-- lib/wx/doc/extra/01_packages.md
-- lib/wx/doc/extra/02_lifecycles.md
-- lib/wx/doc/extra/03_dialogs.md
-- lib/wx/doc/extra/04_enums.md
-- lib/wx/doc/extra/05_event-handling.md
-- lib/wx/doc/extra/06_geometry.md
-- lib/wx/doc/extra/07_colour_and_font.md
-- lib/wx/doc/extra/08_extensions.md
-- lib/wx/doc/extra/09_exceptions.md
-- lib/wx/doc/extra/10_art.md
-- lib/wx/doc/extra/11_drawing_and_dc.md
-- lib/wx/doc/extra/12_client_data.md
-- lib/wx/doc/extra/13_validators.md
-- lib/wx/doc/extra/14_config.md
-- lib/wx/doc/extra/15_persistence.md
 - lib/wx/doc/font.rb
 - lib/wx/doc/font_data.rb
 - lib/wx/doc/functions.rb
 - lib/wx/doc/gc_dc.rb
 - lib/wx/doc/gdi_common.rb
 - lib/wx/doc/generic_validator.rb
+- lib/wx/doc/geometry.rb
 - lib/wx/doc/graphics_context.rb
 - lib/wx/doc/grid/grid.rb
 - lib/wx/doc/hboxsizer.rb
@@ -318,6 +324,7 @@ files:
 - lib/wx/doc/rtc/richtext_style_sheet.rb
 - lib/wx/doc/scaled_dc.rb
 - lib/wx/doc/screen_dc.rb
+- lib/wx/doc/secret_store.rb
 - lib/wx/doc/sizer.rb
 - lib/wx/doc/static_bitmap.rb
 - lib/wx/doc/stc/styled_text_ctrl.rb
@@ -395,10 +402,10 @@ files:
 - lib/wx/stc/styled_text_ctrl.rb
 - lib/wx/version.rb
 - lib/wx/wxruby/base.rb
+- lib/wx/wxruby/cmd/check.rb
 - lib/wx/wxruby/cmd/sampler.rb
 - lib/wx/wxruby/cmd/setup.rb
 - lib/wx/wxruby/cmd/test.rb
-- rakefile
 - rakelib/bin.rake
 - rakelib/bin.rb
 - rakelib/build.rake
@@ -412,18 +419,14 @@ files:
 - rakelib/install.rake
 - rakelib/install.rb
 - rakelib/lib/config.rb
-- rakelib/lib/config/cygwin.rb
+- rakelib/lib/config/freebsd.rb
 - rakelib/lib/config/linux.rb
 - rakelib/lib/config/macosx.rb
 - rakelib/lib/config/mingw.rb
-- rakelib/lib/config/netbsd.rb
-- rakelib/lib/config/pkgman/arch.rb
-- rakelib/lib/config/pkgman/base.rb
-- rakelib/lib/config/pkgman/debian.rb
+- rakelib/lib/config/pkgman/linux.rb
 - rakelib/lib/config/pkgman/macosx.rb
-- rakelib/lib/config/pkgman/rhel.rb
-- rakelib/lib/config/pkgman/suse.rb
 - rakelib/lib/config/unixish.rb
+- rakelib/lib/config/unknown.rb
 - rakelib/lib/core/include/client_data.inc
 - rakelib/lib/core/include/enum.inc
 - rakelib/lib/core/include/funcall.inc
@@ -441,6 +444,7 @@ files:
 - rakelib/lib/director/about_dialog_info.rb
 - rakelib/lib/director/accelerator.rb
 - rakelib/lib/director/accessible.rb
+- rakelib/lib/director/affine_matrix.rb
 - rakelib/lib/director/animation.rb
 - rakelib/lib/director/animation_ctrl.rb
 - rakelib/lib/director/any_button.rb
@@ -526,6 +530,7 @@ files:
 - rakelib/lib/director/gdi_object.rb
 - rakelib/lib/director/gdicommon.rb
 - rakelib/lib/director/generic_dirctrl.rb
+- rakelib/lib/director/geometry.rb
 - rakelib/lib/director/graphics_context.rb
 - rakelib/lib/director/graphics_object.rb
 - rakelib/lib/director/grid_cell_attr.rb
@@ -633,6 +638,7 @@ files:
 - rakelib/lib/director/scroll_bar.rb
 - rakelib/lib/director/scrolled_t.rb
 - rakelib/lib/director/searchctrl.rb
+- rakelib/lib/director/secret_store.rb
 - rakelib/lib/director/sizer.rb
 - rakelib/lib/director/sizer_item.rb
 - rakelib/lib/director/slider.rb
@@ -688,6 +694,7 @@ files:
 - rakelib/lib/generate/doc/animation_ctrl.yaml
 - rakelib/lib/generate/doc/art_provider.yaml
 - rakelib/lib/generate/doc/aui_manager.yaml
+- rakelib/lib/generate/doc/banner_window.yaml
 - rakelib/lib/generate/doc/bitmap.yaml
 - rakelib/lib/generate/doc/box_sizer.yaml
 - rakelib/lib/generate/doc/busy_info.yaml
@@ -715,9 +722,11 @@ files:
 - rakelib/lib/generate/doc/fs_file.yaml
 - rakelib/lib/generate/doc/gdi_common.yaml
 - rakelib/lib/generate/doc/graphics_context.yaml
+- rakelib/lib/generate/doc/graphics_object.yaml
 - rakelib/lib/generate/doc/grid_cell_attr.yaml
 - rakelib/lib/generate/doc/grid_ctrl.yaml
 - rakelib/lib/generate/doc/gui_event_loop.yaml
+- rakelib/lib/generate/doc/header_ctrl.yaml
 - rakelib/lib/generate/doc/help_controller.yaml
 - rakelib/lib/generate/doc/html_cell.yaml
 - rakelib/lib/generate/doc/html_help_controller.yaml
@@ -725,11 +734,13 @@ files:
 - rakelib/lib/generate/doc/html_window.yaml
 - rakelib/lib/generate/doc/icon.yaml
 - rakelib/lib/generate/doc/image.yaml
+- rakelib/lib/generate/doc/info_bar.yaml
 - rakelib/lib/generate/doc/keyboard_state.yaml
 - rakelib/lib/generate/doc/list_ctrl.yaml
 - rakelib/lib/generate/doc/locale.yaml
 - rakelib/lib/generate/doc/log.yaml
 - rakelib/lib/generate/doc/mdi_frame.yaml
+- rakelib/lib/generate/doc/media_ctrl.yaml
 - rakelib/lib/generate/doc/memory_dc.yaml
 - rakelib/lib/generate/doc/menu.yaml
 - rakelib/lib/generate/doc/menu_item.yaml
@@ -738,6 +749,7 @@ files:
 - rakelib/lib/generate/doc/notebook.yaml
 - rakelib/lib/generate/doc/panel.yaml
 - rakelib/lib/generate/doc/pen.yaml
+- rakelib/lib/generate/doc/persistent_window.yaml
 - rakelib/lib/generate/doc/pg_editor.yaml
 - rakelib/lib/generate/doc/pg_multi_button.yaml
 - rakelib/lib/generate/doc/pg_properties.yaml
@@ -748,11 +760,15 @@ files:
 - rakelib/lib/generate/doc/property_grid_interface.yaml
 - rakelib/lib/generate/doc/property_grid_manager.yaml
 - rakelib/lib/generate/doc/property_sheet_dialog.yaml
+- rakelib/lib/generate/doc/rearrange_list.yaml
+- rakelib/lib/generate/doc/ribbon_panel.yaml
+- rakelib/lib/generate/doc/rich_text_formatting_dialog.yaml
 - rakelib/lib/generate/doc/rich_text_html_handler.yaml
 - rakelib/lib/generate/doc/scroll_bar.yaml
 - rakelib/lib/generate/doc/scrolled_canvas.yaml
 - rakelib/lib/generate/doc/scrolled_control.yaml
 - rakelib/lib/generate/doc/scrolled_window.yaml
+- rakelib/lib/generate/doc/secret_store.yaml
 - rakelib/lib/generate/doc/sizer.yaml
 - rakelib/lib/generate/doc/splash_screen.yaml
 - rakelib/lib/generate/doc/static_box.yaml
@@ -769,6 +785,7 @@ files:
 - rakelib/lib/generate/doc/validator.yaml
 - rakelib/lib/generate/doc/variant.yaml
 - rakelib/lib/generate/doc/window.yaml
+- rakelib/lib/generate/doc/wizard.yaml
 - rakelib/lib/generate/doc/wizard_page_simple.yaml
 - rakelib/lib/generate/doc/xml_node.yaml
 - rakelib/lib/generate/doc/xml_resource.yaml
@@ -829,8 +846,15 @@ files:
 - samples/dragdrop/dragdrop.rb
 - samples/dragdrop/tn_dragdrop.png
 - samples/drawing/SVGlogo24.xpm
+- samples/drawing/art/drawing/image.bmp
+- samples/drawing/art/drawing/mask.bmp
+- samples/drawing/art/drawing/pat35.bmp
+- samples/drawing/art/drawing/pat36.bmp
+- samples/drawing/art/drawing/pat4.bmp
+- samples/drawing/art/drawing/smile.xpm
 - samples/drawing/bitmap.rb
 - samples/drawing/bitmap_image.rb
+- samples/drawing/drawing.rb
 - samples/drawing/graphics_drawing.rb
 - samples/drawing/image_prt.rb
 - samples/drawing/maths_images.rb
@@ -838,6 +862,7 @@ files:
 - samples/drawing/ruby-logo.jpg
 - samples/drawing/tn_bitmap.png
 - samples/drawing/tn_bitmap_image.png
+- samples/drawing/tn_drawing.png
 - samples/drawing/tn_graphics_drawing.png
 - samples/drawing/tn_image_prt.png
 - samples/drawing/tn_maths_images.png
@@ -925,22 +950,12 @@ files:
 - samples/ribbon/triangle.xpm
 - samples/sample.xpm
 - samples/sampler.rb
-- samples/sampler/back.xpm
-- samples/sampler/copy.xpm
-- samples/sampler/cut.xpm
 - samples/sampler/editor.rb
 - samples/sampler/ext.rb
-- samples/sampler/filesave.xpm
-- samples/sampler/find.xpm
-- samples/sampler/findrepl.xpm
-- samples/sampler/forward.xpm
-- samples/sampler/paste.xpm
 - samples/sampler/play.xpm
-- samples/sampler/redo.xpm
 - samples/sampler/sample.rb
 - samples/sampler/stc_editor.rb
 - samples/sampler/txt_editor.rb
-- samples/sampler/undo.xpm
 - samples/splash/mobile.xpm
 - samples/splash/splash.png
 - samples/splash/splash.rb
@@ -1126,6 +1141,7 @@ files:
 - tests/test_pg.rb
 - tests/test_proof_check.rb
 - tests/test_richtext.rb
+- tests/test_secret_store.rb
 - tests/test_sizer.rb
 - tests/test_std_controls.rb
 - tests/test_styled_text_ctrl.rb
@@ -1141,17 +1157,20 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/mcorino/wxRuby3/issues
+  homepage_uri: https://github.com/mcorino/wxRuby3/wiki
   source_code_uri: https://github.com/mcorino/wxRuby3
   documentation_uri: https://mcorino.github.io/wxRuby3
-  homepage_uri: https://github.com/mcorino/wxRuby3
-post_install_message: |2+
-
-  The wxRuby3 Gem has been successfully installed.
-  Before being able to use wxRuby3 you need to run the post-install setup process
-  by executing the command 'wxruby setup'.
-
-  Run 'wxruby setup -h' to see information on the available commandline options.
-
+  github_repo: https://github.com/mcorino/wxRuby3
+post_install_message: "\nThe wxRuby3 Gem has been successfully installed including
+  the 'wxruby' utility.\n\nIn case no suitable binary release package was available
+  for your platform you  \nwill need to run the post-install setup process by executing:\n\n$
+  wxruby setup\n\nTo check whether wxRuby3 is ready to run or not you can at any time
+  execute the \nfollowing command:\n\n$ wxruby check\n\nRun 'wxruby check -h' for
+  more information.\n\nWhen the wxRuby3 setup has been fully completed you can start
+  using wxRuby3.\n\nYou can run the regression tests to verify the installation by
+  executing:\n\n$ wxruby test\n\nThe wxRuby3 sample explorer can be run by executing:\n\n$
+  wxruby sampler\n\nHave fun using wxRuby3.\n\nRun 'wxruby -h' to see information
+  on the available commands.\n\n"
 rdoc_options:
 - "--exclude=\\.dll"
 - "--exclude=\\.so"
@@ -1171,7 +1190,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.9
 signing_key: 
 specification_version: 4
 summary: wxWidgets extension for Ruby

data/lib/wx/doc/extra/00_starting.md

@@ -1,154 +0,0 @@
-<!--
-# @markup markdown
-# @title 0. Overview of wxRuby
--->
-
-# 0. Overview of wxRuby
-
-## What is wxRuby?
-
-wxRuby3 is a cross-platform GUI library for Ruby, based on the popular [wxWidgets](https://wxwidgets.org)
-cross platform GUI toolkit for C++. It uses native widgets wherever possible, providing
-the correct look, feel and behaviour to GUI applications on Windows, OS
-X and Linux/GTK. wxRuby aims to provide a comprehensive solution to
-developing professional-standard desktop applications in Ruby.
-
-Like Ruby and wxWidgets, wxRuby is Open Source, which means that it is free for anyone to use and the source code 
-is available for anyone to look at and use in any way they like. Also, anyone can contribute (tested) fixes, additions 
-and enhancements to the project.
-
-Like wxWidgets wxRuby is a cross platform toolkit. This means that the same program will run on multiple platforms 
-without modification. Currently Supported platforms are Microsoft Windows, MacOSX and Linux or other 
-unix-like systems with GTK2 or GTK3 libraries. Contributions to achieve support for other wxWidgets supported platforms
-are appreciated.
-
-Since the programming language is Ruby, wxRuby programs are simple and easy to write and understand. To accomplish the
-full Ruby experience wxRuby has not ported the wxWidgets API 1 on 1 to Ruby but has made an effort to make the wxRuby
-API typically Ruby-ish. This means all method signatures (names, arguments) have been transformed to conform to common
-Ruby naming rules as well as other Ruby programming practices. Also does wxRuby introduce iterators in favor of getters
-returning arrays or lists.
-Check out the samples and the documentation for details.
-
-## What is wxRuby3?
-
-The wxRuby3 project is a new, rebooted, implementation of wxRuby (as compared to wxRuby2 and earlier versions) with the
-clear intent to make this implementation better maintainable and extensible.
-
-To this end wxRuby3 adopted much of the approach of the wxPython Phoenix project in that the wxRuby API is generated 
-from the wxWidgets XML interface definitions. Unlike the Phoenix project however, wxRuby does not use a home-grown
-interface code generator but rather still relies on SWIG for that (with Ruby tooling to configure and post-process).
-The wxRuby generation process more or less conforms to: 
-
-1. build wxWidgets interface XML
-2. parse interface XML
-3. generate SWIG interface definitions
-4. generate Ruby extension code with SWIG
-5. post-process Ruby extension code
-
-As the wxRuby tooling is already parsing the full wxWidgets interface specs (from which wxWidgets generates it's own 
-reference documentation) it also uses the parsed information to generate matching reference documentation for the 
-wxRuby API. This documentation is not (yet) perfect but should go a long way in helping people using wxRuby to build
-GUI applications.
-
-The wxRuby3 API is largely compatible with the earlier wxRuby incarnations but not 100% mostly due to more 
-modularization and more explicit typing of (especially) enums. Also wxRuby3 exclusively targets a lot more modern 
-versions of wxWidgets (>= 3.2) and Ruby (>= 2.5) so there are some shifts from that as well. All in all though,
-people that once took a stab at looking at wxRuby(2) should not have much problems getting up to speed again. 
-
-## Quick start
-
-To create an application with wxRuby you need to require the wxRuby libraries:
-
-```ruby
-require 'wx'
-```
-
-Next would be the application code and a main entry point. With wxRuby (as with wxWidgets) the entry
-point is mostly just a simple call to start the applications event loop (as we're talking about event 
-based GUI applications here). 
-In wxRuby the Wx::App class provides some typically Ruby-style magic to make this as easy as possible.
-
-Using this the simplest Hello World application could be:
-
-```ruby
-require 'wx'
-Wx::App.run { puts 'Hello world!' }
-```
-
-As you can see there is no obligation to create an instance of the Wx::App class in wxRuby for
-(admittedly extremely) simple applications. Calling the #run class method with a block will suffice.<br>
-The class method will create an instance of the generic Wx::App class under the hood and use the 
-provided block as the #on_init callback. As the code inside the block returns a false-type value (#puts 
-returns `nil`) the application will terminate immediately after writing "Hello world!" to standard
-output (actually not even starting the event loop at all).
-
-Of course this is not truly a GUI application so let's elaborate a little to make the GUI element
-more real.
-
-```ruby
-require 'wx'
-Wx::App.run { Wx::Frame.new(nil, title: 'Hello World!').show }
-```
-
-Executing this will create a generic Frame instance in the on_init callback of the application
-and show the frame. As #show returns a true-type when successful the event loop will actually be
-started and keep the application running until the frame is closed. 
-
-## The application class
-
-For more complex applications the approach demonstrated above will quickly become insufficient. In those cases
-creating a specialized derived App class is the better option.
-This provides the possibility (as with all Ruby classes) to override the constructor (#initialize) for
-custom initialization, attribute definitions and create customized #on_init and/or #on_exit methods like
-this:
-
-```ruby
-require 'wx'
-
-class MyApp < Wx::App
-  def initialize
-    super
-    @frame = nil
-  end
-  attr_reader :frame
-  
-  def on_init
-    @frame = Wx::Frame.new(nil, title: 'Hello World!')
-    @frame.show
-  end
-  
-  def on_exit
-    puts 'Exiting.'
-  end
-end
-```
-
-When creating #on_init/#on_exit methods it is important to understand that those would not be overrides (as is the case
-with wxWidgets itself). The base Wx::App class actually does not define these methods so it's also not needed (even not possible)
-to call `super` in the implementation. The wxRuby application class implementation will call the wxWidget OnInit base implementation
-itself and after successful completion check for the existence of an #on_init method (which could also be 'automagicallly'
-created from a block passed to #run) and call that if available or terminate the application if not. The
-exit sequence of executions are similar but reversed (first a possible #on_exit method and than the wxWidgets base OnExit).
-
-What remains though is that for a derived application class it is still not necessary to explicitly create a class instance.
-Simply calling the #run class method will suffice.
-
-```ruby
-MyApp.run
-```
-
-The current application instance (as long as the application is active) can always be retrieved by
-calling `Wx.get_app`.
-
-## wxRuby modules
-
-The toplevel module of the wxRuby library is the `Wx` module and when using `require 'wx'` to load the wxRuby library
-**all** constants and classes are loaded and can be accessed from that scope like `Wx::Frame` or `Wx::RichTextCtrl` 
-like previous versions of wxRuby supported.
-
-With the current wxRuby library however a more modular approach has been used similar to wxWidgets itself which
-distributes implementations over various sub-modules. These sub-modules can be loaded separately to provide more control.
-The core module still provides the toplevel `Wx` namespace and all classes and constants declared in that namespace.
-All other modules add to that (and **all** require the core module).
-
-See [here](01_packages.md) for more details on wxRuby sub-modules.

data/lib/wx/doc/extra/01_packages.md

@@ -1,180 +0,0 @@
-<!--
-# @markup markdown
-# @title 1. wxRuby Modules
--->
-
-# 1. wxRuby Modules
-
-## Introduction
-
-Previous wxRuby implementations provided a single toplevel module approach for the wxRuby API with a single loading
-option. Including `require 'wx'` in any application would load the entire wxRuby library and make all classes, module
-methods and constants available under the `Wx` toplevel module.
-
-The wxRuby3 project however implements a more modular approach similar to wxWidgets itself which distributes
-implementations over various sub-modules. These sub-modules can be loaded separately to provide more control.
-The core module still provides the toplevel `Wx` namespace and all classes and constants declared in that namespace.
-All other modules add to that (and **all** require the core module).
-
-## Loading and Naming scopes
-
-The *old* **all-in-one** approach in still supported with the wxRuby3 project. Using
-
-```ruby
-require 'wx'
-```
-
-will load all wxRuby API modules and make all classes and constants available from the `Wx` toplevel module. This 
-*global* naming scope approach does **not** extend to class or module methods (including dialog *functors*; see 
-[here](03_dialogs.md) for more information).
- 
-The *new* sub-module approach however allows for loading only part(s) of the wxRuby library like:
-
-```ruby
-require 'wx/core' # load wxRuby core Wx module
-require 'wx/grid' # load wxRuby Wx::GRID module - provides Grid control
-require 'wx/rtc'  # load wxRuby Wx::RTC module - provides RichText control 
-```
-
-However, when loading the library like this scoping rules change by default. Specifically the constants and classes
-from the loaded sub-modules will **not** be accessible from the `Wx` scope anymore (like `Wx::Grid`) but must instead be
-explicitly scoped from the sub-module (like `Wx::GRID::Grid`).
-
-It is possible to revert the 'global scope' resolution behaviour by setting the toplevel constant `WX_GLOBAL_CONSTANTS` to
-`true` before the require statements like:
-
-```ruby
-WX_GLOBAL_CONSTANTS=true
-require 'wx/core' # load wxRuby core Wx module
-require 'wx/grid' # load wxRuby Wx::GRID module - provides Grid control
-require 'wx/rtc'  # load wxRuby Wx::RTC module - provides RichText control 
-```
-
-## Modules
-
-Currently the following modules have been implemented.
-
-### Core
-
-The core wxRuby package providing the toplevel {Wx} module.
-This package includes basic classes like:
-
-- {Wx::Object}
-- {Wx::EvtHandler}
-- {Wx::Event}
-- {Wx::CommandEvent}
-- {Wx::App}
-- {Wx::Window}
-- {Wx::NonOwnedWindow}
-- {Wx::TopLevelWindow}
-- {Wx::Frame}
-- {Wx::Dialog}
-
-as well as most common window classes, control/widget classes, event classes, constant and enum definitions
-and global functions not part of any of the other packages.
-
-### AUI - Advanced User Interface controls and related classes
-
-The wxRuby AUI package providing the {Wx::AUI} module.
-This package includes all classes, constants and enum definitions that are considered part of the 
-wxWidgets AUI framework like:
-
-- {Wx::AUI::AuiManager}
-- {Wx::AUI::AuiMDIParentFrame}
-- {Wx::AUI::AuiMDIChildFrame}
-- {Wx::AUI::AuiMDIClientWindow}
-- etc
-
-### GRID - Grid control and related classes
-
-The wxRuby GRID package providing the {Wx::GRID} module.
-This package includes all classes, constants and enum definitions that are associated with the
-wxWidgets wxGrid control like:
-
-- {Wx::GRID::Grid}
-- {Wx::GRID::GridTableBase}
-- {Wx::GRID::GridCellEditor}
-- {Wx::GRID::GridCellRenderer}
-- {Wx::GRID::GridEvent}
-- etc
-
-### HTML - Html framework classes
-
-The wxRuby HTML package providing the {Wx::HTML} module.
-This package includes all classes, constants and enum definitions that are considered part of the
-wxWidgets Html framework like:
-
-- {Wx::HTML::HtmlWindow}
-- {Wx::HTML::HtmlHelpWindow}
-- {Wx::HTML::HtmlPrintout}
-- {Wx::HTML::HtmlHelpController}
-- {Wx::HTML::HtmlListBox}
-- etc
-
-### PG - PropertyGrid control and related classes
-
-The wxRuby PG package providing the {Wx::PG} module.
-This package includes all classes, constants and enum definitions that are associated with the
-wxWidgets wxPropertyGrid control like:
-
-- {Wx::PG::PropertyGrid}
-- {Wx::PG::PropertyGridManager}
-- {Wx::PG::PGCell}
-- {Wx::PG::PGProperty}
-- {Wx::PG::PropertyGridEvent}
-- etc
-
-### PRT - Printing framework classes
-
-The wxRuby PRT package providing the {Wx::PRT} module.
-This package includes all classes, constants and enum definitions that are considered part of the
-wxWidgets Printing framework like:
-
-- {Wx::PRT::PreviewFrame}
-- {Wx::PRT::Printer}
-- {Wx::PRT::PrinterDC}
-- {Wx::PRT::PrintDialog}
-- etc
-
-### RBN - Ribbon framework classes
-
-The wxRuby RBN package providing the {Wx::RBN} module.
-This package includes all classes, constants and enum definitions that are considered part of the
-wxWidgets Ribbon framework like:
-
-- {Wx::RBN::RibbonControl}
-- {Wx::RBN::RibbonGallery}
-- {Wx::RBN::RibbonPanel}
-- {Wx::RBN::RibbonPage}
-- {Wx::RBN::RibbonBar}
-- etc
-
-### RTC - RichText control and related classes
-
-The wxRuby RTC package providing the {Wx::RTC} module.
-This package includes all classes, constants and enum definitions that are associated with the
-wxWidgets wxRichTextCtrl control like:
-
-- {Wx::RTC::RichTextCtrl}
-- {Wx::RTC::RichTextEvent}
-- {Wx::RTC::RichTextBuffer}
-- etc
-
-### STC - StyledText control and related classes
-
-The wxRuby STC package providing the {Wx::STC} module.
-This package includes all classes, constants and enum definitions that are associated with the
-wxWidgets wxStyledTextCtrl control (Scintilla integration) like:
-
-- {Wx::STC::StyledTextCtrl}
-- {Wx::STC::StyledTextEvent}
-
-## Feature dependencies
-
-Availability of wxRuby packages is controlled by the wxWidget feature switches. The default build options will
-include all platform supported features but in case of building wxRuby for customized wxWidgets builds the wxRuby3
-build procedures will take the wxWidgets settings into account.
-
-If for instance wxWidgets was built without Html support (using the configure `--disable-html` switch) the wxRuby
-HTML package will not be available as well.
-This behavior is controlled by the `wxUSE_xxx` macros that wxRuby extracts from the wxWidgets `wx/setup.h` file.