wxruby3 0.9.0.pre.beta.8-x64-mingw-ucrt

data/lib/wx/doc/aui/auimanager.rb

@@ -0,0 +1,12 @@
+
+class Wx::AUI::AuiManager
+
+  # Yield each pane to the given block.
+  # @yieldparam [Wx::AUI::AuiPaneInfo] pane the Aui pane info yielded
+  def each_pane; end
+
+  # Returns an array of all panes managed by the frame manager.
+  # @return [Array<Wx::AUI::AuiPaneInfo>] all managed panes
+  def get_all_panes; end
+  alias_method :all_panes, :get_all_panes
+end

data/lib/wx/doc/aui/auinotebook.rb

@@ -0,0 +1,9 @@
+
+class Wx::AUI::AuiNotebook
+
+  # Finds tab control and its tab index associated with a given window.
+  # @param [Wx::Window] page the notebook page window
+  # @return [Array<Wx::AUI::AuiTabCtrl, Integer>, nil] tab control and index if found else nil
+  def find_tab(page) end
+
+end

data/lib/wx/doc/colour_dialog.rb

@@ -0,0 +1,15 @@
+
+class Wx::ColourDialog
+
+  # Returns (a copy of) the colour data of the dialog.
+  # @return [Wx::ColourData] colour data copy
+  def get_colour_data; end
+  alias :colour_data :get_colour_data
+
+  # Updates the colour data for the dialog.
+  # @param [Wx::ColourData] clr_data the colour data to update the dialog with
+  # @return [void]
+  def set_colour_data(clr_data); end
+  alias :colour_data= :set_colour_data
+
+end

data/lib/wx/doc/core.rb

@@ -0,0 +1,11 @@
+
+module Wx
+
+  class << self
+    # Returns trace level (always 0 if #wxrb_debug returns false)
+    # In case #wxrb_debug returns true #wxrb_trace_level= is also defined)
+    # @return [Integer]
+    attr_reader :wrb_trace_level
+  end
+
+end

data/lib/wx/doc/dc.rb

@@ -0,0 +1,49 @@
+
+class Wx::DC
+
+  # Provides similar functionality like wxDCBrushChanger setting the given brush as the active
+  # brush for the DC for the duration of the block execution restoring the previous brush afterwards.
+  # @param [Wx::Brush] brush new brush to use during block execution
+  # @return [void]
+  # @yieldparam [Wx::DC] dc the DC (self)
+  def with_brush(brush) end
+
+  # Provides similar functionality like wxDCPenChanger setting the given pen as the active
+  # pen for the DC for the duration of the block execution restoring the previous pen afterwards.
+  # @param [Wx::Pen] pen new pen to use during block execution
+  # @return [void]
+  # @yieldparam [Wx::DC] dc the DC (self)
+  def with_pen(pen) end
+
+  # Provides similar functionality like wxDCFontChanger setting the given font as the active
+  # font for the DC for the duration of the block execution restoring the previous font afterwards.
+  # @param [Wx::Font] font new font to use during block execution
+  # @return [void]
+  # @yieldparam [Wx::DC] dc the DC (self)
+  def with_font(font) end
+
+  # Provides similar functionality like wxDCTextColourChanger setting the given colour as the active
+  # text foreground colour for the DC for the duration of the block execution restoring the previous colour afterwards.
+  # @param [Wx::Colour] clr new colour to use during block execution
+  # @return [void]
+  # @yieldparam [Wx::DC] dc the DC (self)
+  def with_text_foreground(clr) end
+  alias :with_text_fg :with_text_foreground
+
+  # Provides similar functionality like wxDCTextBgColourChanger setting the given colour as the active
+  # text background colour for the DC for the duration of the block execution restoring the previous colour afterwards.
+  # @param [Wx::Colour] clr new colour to use during block execution
+  # @return [void]
+  # @yieldparam [Wx::DC] dc the DC (self)
+  def with_text_background(clr) end
+  alias :with_text_bg :with_text_background
+
+  # Provides similar functionality like wxDCTextBgModeChanger setting the given mode as the active
+  # background mode for the DC for the duration of the block execution restoring the previous mode afterwards.
+  # @param [Integer] mode new mode to use during block execution
+  # @return [void]
+  # @yieldparam [Wx::DC] dc the DC (self)
+  def with_background_mode(mode) end
+  alias :with_bg_mode :with_background_mode
+
+end

data/lib/wx/doc/enum.rb

@@ -0,0 +1,88 @@
+###
+# wxRuby3 Enum class
+# Copyright (c) M.J.N. Corino, The Netherlands
+###
+
+
+module Wx
+
+  # Base class for typed enums.
+  # Derives from Numeric and behaves as such in math operations but provides
+  # type safety for arguments requiring the specific enum class.
+  class Enum < Numeric
+
+    # Initialize a new enum value.
+    # @param [Integer] val enum integer value
+    def initialize(val)end
+
+    # Coerces enum value to be compatible with other if possible. Raises TypeError if not compatible.
+    # @param [Numeric] other numeric value
+    # @return [Array<Integer, Integer>] the integer equivalences of other and enum value
+    def coerce(other) end
+
+    # Returns true.
+    def integer?; end
+
+    # Returns false.
+    def real?; end
+
+    # Redirects to the @value member attribute for any missing methods.
+    def method_missing(sym, *args) end
+
+    # Checks type and value equality.
+    # @param [Object] o the object to compare
+    # @return [true,false] true if o is instance of same enum class as self **and** integer values are equal; false otherwise
+    def eql?(o) end
+
+    # Compares integer values if possible. Raises ArgumentError if not compatible
+    # @param [Enum,Numeric] o enum or numeric object to compare.
+    # @return [-1,0,1]
+    def <=>(o) end
+
+    # Returns bitwise or-ed value.
+    # In case other is same class as self an enum instance of that class is returned
+    # otherwise an Integer value.
+    # @param [Wx::Enum,Integer] other
+    # @return [Wx::Enum,Integer]
+    def |(other) end
+
+    # Returns bitwise and-ed value.
+    # In case other is same class as self an enum instance of that class is returned
+    # otherwise an Integer value.
+    # @param [Wx::Enum,Integer] other
+    # @return [Wx::Enum,Integer]
+    def &(other) end
+
+    # Returns an enum instance of the complement value (same class as self).
+    # @return [Wx::Enum]
+    def ~; end
+
+    # Returns true if value is 0 otherwise false.
+    # @return [Boolean]
+    def !; end
+
+    # Return next integer value from enum's value.
+    # @return [Integer] next integer value
+    def succ; end
+
+    # Return string representation.
+    def inspect; end
+
+    # Return integer value of enum
+    def to_int; end
+    alias :to_i :to_int
+
+    # Create a new class and associated enum values.
+    # @param [String,Symbol] name name of new enum class
+    # @param [Hash] enum_values hash with enum value name and enum integer value pairs
+    # @return [Class] new enum class
+    def self.create(name, enum_values) end
+
+    # Returns enum class matching name or nil.
+    # @param [String,Symbol] name name of enum class
+    # @return [Class,nil] enum class
+    def self.[](name) end
+
+  end
+
+end

data/lib/wx/doc/evthandler.rb

@@ -0,0 +1,87 @@
+# Additional event handler methods documentation stubs.
+
+
+class Wx::EvtHandler
+
+  # Public method to register the mapping of a custom event type
+  # +konstant+ (which should be a unique integer; one will be created if
+  # not supplied) to a custom event class +klass+. If +meth+ and +arity+
+  # are given, a convenience evt_handler method called +meth+ will be
+  # created, which accepts +arity+ arguments (specify both or neither).
+  # @param klass [Class] event class
+  # @param konstant [Integer] unique event type id (if nil a unique value will be autogenerated)
+  # @param meth [String,Symbol] optional event handler method name
+  # @param arity [Integer] event handler method arity (should be 0, 1 or 2 if not nil)
+  # @return [Integer] unique event type id
+  def self.register_class(klass, konstant = nil, meth = nil, arity = nil) end
+
+  def connect(first_id, last_id, evt_type, handler) end
+
+  def disconnect(first_id, last_id, evt_spec) end
+
+  # Processes an event, searching event tables and calling zero or more suitable event handler function(s).
+  #
+  # Normally, your application would not call this function: it is called in the wxWidgets implementation to
+  # dispatch incoming user interface events to the framework (and application).
+  #
+  # However, you might need to call it if implementing new functionality (such as a new control) where you
+  # define new event types, as opposed to allowing the user to override virtual functions.
+  #
+  # In wxRuby this method can not be effectively overridden.
+  # In order to override default event processing define a try_before(event) or try_after(event) method
+  # as member of a derived EvtHandler class.
+  #
+  # The normal order of event table searching is as follows:
+  #
+  # 1. {Wx::App#filter_event} is called. If it returns anything but -1 (default) the processing stops here.
+  # 2. #try_before (if it exists, otherwise the C++ default implementation) is called (this is where {Wx::Validator} are taken into account for {Wx::Window} objects). If this returns true, the function exits.
+  # 3. If the object is disabled (via a call to {Wx::EvtHandler#set_evt_handler_enabled}) the function skips to step (7).
+  # 4. Dynamic event table of the handlers bound using Bind<>() is searched in the most-recently-bound to the most-early-bound order. If a handler is found, it is executed and the function returns true unless the handler used {Wx::Event#skip} to indicate that it didn't handle the event in which case the search continues.
+  # 5. Static events table of the handlers bound using event table macros is searched for this event handler in the order of appearance of event table macros in the source code. If this fails, the base class event table is tried, and so on until no more tables exist or an appropriate function was found. If a handler is found, the same logic as in the previous step applies.
+  # 6. The search is applied down the entire chain of event handlers (usually the chain has a length of one). This chain can be formed using {Wx::EvtHandler#set_next_handler}
+  #    Note that in the case of Wx::Window you can build a stack of event handlers (see {Wx::Window#push_event_handler} for more info). If any of the handlers of the chain return true, the function exits.
+  # 7. #try_after (if it exists, otherwise the C++ default implementation) is called: for the {Wx::Window} object this may propagate the event to the window parent (recursively). If the event is still not processed, {#process_event} on the {Wx::THE_APP} object is called as the last step.
+  #
+  # Notice that steps (2)-(6) are performed in {#process_event_locally} which is called by this function.
+  #
+  # @param event [Wx::Event]  Event to process.
+  # @return [true,false] true if event has been processed
+  def process_event(event) end
+
+  # Process a command, supplying the window identifier, command event identifier, and member function or proc.
+  # @param [Integer] id window identifier
+  # @param [Integer] evt_id event type identifier
+  # @param [String,Symbol,Method,Proc] meth (name of) method or event handling proc
+  # @yieldparam [Wx::CommandEvent] event event to handle
+  def evt_command(id, evt_id, meth = nil, &block) end
+
+  # Process a command for a range of window identifiers, supplying the minimum and maximum window identifiers, command event identifier, and member function or proc.
+  # @param [Integer] id1 minimum window identifier
+  # @param [Integer] id2 maximum window identifier
+  # @param [Integer] evt_id event type identifier
+  # @param [String,Symbol,Method,Proc] meth (name of) method or event handling proc
+  # @yieldparam [Wx::CommandEvent] event event to handle
+  def evt_command_range(id1, id2, evt_id, meth = nil, &block) end
+
+  # Convenience evt_handler to listen to all mouse events.
+  # @yieldparam [Wx::MouseEvent] event event to handle
+  def evt_mouse_events(&block) end
+
+  # Convenience evt handler to listen to all scrollwin events.
+  # @yieldparam [Wx::ScrollWinEvent] event event to handle
+  def evt_scrollwin(&block) end
+
+  # Processes Wx::WindowDestroyEvent events.
+  # In wxRuby Wx::Event#skipped will be forced to true after the provided
+  # handler has finished to make sure the event is propagated as it is
+  # required that Wx::App gets to handle the event in the end.
+  # @yieldparam [Wx::WindowDestroyEvent] event event to handle
+  def evt_window_destroy(&block) end
+
+  # Schedule a call for asynchronous execution (at idle time).
+  # @param meth [Symbol,String,Method,Proc] (name of) method or proc to call
+  # @param args [Array<Object>] optional arguments to pass to the call
+  # @return [void]
+  # @yield [*args] optional arguments
+  def call_after(meth = nil, *args, &block) end
+end

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

@@ -0,0 +1,154 @@
+<!--
+# @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 and Linux or other 
+unix-like systems with GTK2 or GTK3 libraries. As wxWidgets also has stable releases for Mac OSX and Linux QT platforms
+it should not be to hard to support these. Contributions to achieve this 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 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. For the
+exit sequence to 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](packages.md) for more details on wxRuby sub-modules.

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

@@ -0,0 +1,179 @@
+<!--
+# @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::HtmlHelpFrame`
+- `Wx::HTML::HtmlHelpController`
+- 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.