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

data/lib/wx/doc/config.rb

@@ -0,0 +1,190 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+module Wx
+
+  # {Wx::ConfigBase} defines the basic interface of all config classes.
+  # In Ruby this class is an empty placeholder providing access to the static
+  # {Wx::ConfigBase.create}, {Wx::ConfigBase.set} and {Wx::ConfigBase.get}
+  # methods as well as providing the base for a similar inheritance hierarchy
+  # as in C++.
+  class ConfigBase
+
+    # Create a new config object and sets it as the current one unless a global Ruby config was already created/installed.
+    # This function will create the most appropriate implementation of Wx::ConfigBase available for the current platform.
+    # In Ruby this means that a Wx::Config instance will created and appropriately wrapped in C++.
+    # @return [Wx::Config] the current configuration object
+    def self.create; end
+
+    # Sets the config object as the current one, returns the previous current object (both the parameter and returned
+    # value may be nil).
+    # @param [Wx::Config,nil] config the config object to install
+    # @return [Wx::Config] the previous current configuration object
+    def self.set(config) end
+
+    # Get the current config object.
+    # If there is no current object and create_on_demand is true, this creates one.
+    # @param [Boolean] create_on_demand specifies whether to create a configuration object is none has been created/installed before
+    # @return [Wx::Config,nil] the current configuration object
+    def self.get(create_on_demand=true) end
+
+  end
+
+  # Configuration class for wxRuby which stores it's settings in a (possibly nested) Hash.
+  # This way configurations can be easily persisted using any commonly used Ruby methods like
+  # YAML or JSON files.
+  #
+  # Wx::Config supports Boolean (true or false), Integer, Float and String values and nested groups
+  # (essentially nested hashes). Any entry values set will be sanitized to match the supported types, i.e.
+  # if the value matches a supported type the value is accepted unaltered otherwise Integer (`to_int`), Float (`to_f`)
+  # or String (`to_s`) coercion are applied (in that order). Hash values are installed as nested groups.
+  #
+  # Like the C++ wxConfigBase derivatives Wx::Config supports arbitrary access using path strings which support
+  # absolute paths ('/xxxx') and relative paths ('xxx/xxx', '../xxx', './xxxx'). Relative segments can also be
+  # embedded in the path strings ('/aaa/bbb/../ccc').
+  class Config < ConfigBase
+
+    # Config path separator
+    SEPARATOR = '/'
+
+    # Common configuration access methods for either the root object or any nested group objects.
+    module Interface
+
+      # Iterate all settings at the current object (no recursion).
+      # Passes key/value pairs to the given block or returns an Enumerator is no block given.
+      # @yieldparam [String] key setting key
+      # @yieldparam [Boolean,String,Integer,Float,Wx::Config::Group] value setting value
+      # @return [Object,Enumerator] either the last result of the executed block or an enumerator if no block given
+      def each(&block) end
+
+      # Iterate all value entries at the current object (no recursion).
+      # Passes key/value pairs to the given block or returns an Enumerator is no block given.
+      # @yieldparam [String] key entry key
+      # @yieldparam [Boolean,String,Integer,Float] value entry value
+      # @return [Object,Enumerator] either the last result of the executed block or an enumerator if no block given
+      def each_entry(&block) end
+
+      # Iterate all group entries at the current object (no recursion).
+      # Passes key/value pairs to the given block or returns an Enumerator is no block given.
+      # @yieldparam [String] key entry key
+      # @yieldparam [Wx::Config::Group] value entry value
+      # @return [Object,Enumerator] either the last result of the executed block or an enumerator if no block given
+      def each_group(&block) end
+
+      # Returns the total number of value entries at the current object only (if recurse is false) or including
+      # any nested groups (if recurse is true)
+      # @param [Boolean] recurse
+      # @return [Integer] count
+      def number_of_entries(recurse: false) end
+
+      # Returns the total number of group entries at the current object only (if recurse is false) or including
+      # any nested groups (if recurse is true)
+      # @param [Boolean] recurse
+      # @return [Integer] count
+      def number_of_groups(recurse: false) end
+
+      # Returns if a value entry exists matching the given path string.
+      # Path strings can be absolute (starting with {SEPARATOR}) or relative to the current object and can have
+      # relative segments embedded ('.' and '..' are supported).
+      # @param [String] path_str entry path
+      # @return [Boolean] true if entry exists, false otherwise
+      def has_entry?(path_str) end
+
+      # Returns if a group entry exists matching the given path string.
+      # Path strings can be absolute (starting with {SEPARATOR}) or relative to the current object and can have
+      # relative segments embedded ('.' and '..' are supported).
+      # @param [String] path_str entry path
+      # @return [Boolean] true if entry exists, false otherwise
+      def has_group?(path_str) end
+
+      # Returns a value for an entry at the current object identified by `key`.
+      # @param [String] key entry key
+      # @return [Boolean,String,Integer,Float,Wx::Config::Group,nil] value entry value
+      def get(key) end
+
+      # Sets a value for an entry at the current object identified by `key` or deletes the entry if `val` is nil.
+      # Returns the new value for the entry.
+      # Group entries can be set using Hash values (entry values in the hash will be sanitized).
+      # @param [String] key entry key
+      # @param [Boolean,String,Integer,Float,Hash,nil] val entry value
+      # @return [Boolean,String,Integer,Float,Wx::Config::Group,nil] value entry value
+      def set(key, val) end
+
+      # Removes the entry at the current object identified by `key` if it exists and returns it's value.
+      # @param [String] key entry key
+      # @return [Boolean,String,Integer,Float,Hash,nil] entry value
+      def delete(key) end
+
+      # Changes key for the entry at the current object identified by `old_key` to `new_key` if it exists.
+      # @param [String] old_key current entry key
+      # @param [String] new_key new entry key
+      # @return [Boolean] true if the entry was renamed, false otherwise
+      def rename(old_key, new_key) end
+
+      # Returns a value for an entry from the configuration identified by `path_str`.
+      # Allows arbitrary access though the entire configuration using absolute or relative paths.
+      # @param [String] path_str
+      # @return [Boolean,String,Integer,Float,Wx::Config::Group,nil] value entry value
+      def [](path_str) end
+
+      # Sets a value for an entry from the configuration identified by `path_str` or deletes the entry if `val` is nil.
+      # Returns the new value for the entry.
+      # Group entries can be set using Hash values (entry values in the hash will be sanitized).
+      # @param [String] path_str
+      # @param [Boolean,String,Integer,Float,Hash,nil] val entry value
+      # @return [Boolean,String,Integer,Float,Wx::Config::Group,nil] value entry value
+      def []=(path_str, val) end
+
+      # Returns the path string for the current configuration object.
+      # @return [String]
+      def to_s; end
+
+      # Returns the Hash object used to store the settings for the current configuration object.
+      # @return [Hash]
+      def to_h; end
+
+      # Returns true if the current configuration object is the root (Wx::Config) object, false otherwise
+      # (for Wx::Config::Group objects).
+      # @return [Boolean]
+      def root?; end
+
+      # Returns the root (Wx::Config) object
+      # @return [Wx::Config] root configuration object
+      def root; end
+
+      # Returns the path segment array for the current configuration object.
+      # @return [Array<String>] path array
+      def path; end
+
+      # Returns the parent configuration object or nil if this for the root object.
+      # @return [Wx::Config,Wx::Config::Group,nil] root object
+      def parent; end
+
+    end
+
+    class Group
+
+      include Interface
+
+    end
+
+    include Interface
+
+    # Constructor.
+    # @param [Hash] hash optional Hash initializing configuration object
+    # @return [Wx::Config]
+    def initialize(hash = nil)end
+
+    # Replaces the configuration content with the content of the provided Hash.
+    # Values will be sanitized (see {Wx::Config}).
+    # @param [Hash] hash content to replace configuration
+    # @return [self]
+    def replace(hash) end
+
+  end
+
+end

data/lib/wx/doc/const.rb

@@ -1,3 +1,10 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
 module Wx
 
 =begin

data/lib/wx/doc/controlwithitems.rb

@@ -1,3 +1,9 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
 
 class Wx::ControlWithItems
 

data/lib/wx/doc/core.rb

@@ -1,3 +1,9 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
 
 module Wx
 

data/lib/wx/doc/cursor.rb

@@ -1,16 +1,24 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
 
-class Wx::Cursor
+
+class Wx
 
   # Searches for an art file with basename 'name' and creates a Cursor if found.
   # Raises an ArgumentError if not found.
   # Wx::ArtLocator::find_art is used to look up the art file using ::Kernel#caller_locations to
-  # determine the values for the 'art_path' and 'art_owner' arguments ('art_path' is set to the
-  # absolute path to the folder holding the caller's code and 'art_owner' to the basename of the
-  # caller's source file). The 'art_type' argument is set to <code>:icon</code>.
+  # determine the values for the 'art_path' and 'art_section' arguments if not specified here
+  # ('art_path' is set to the absolute path to the folder holding the caller's code and 'art_section'
+  # to the basename of the caller's source file). The 'art_type' argument is set to <code>:cursor</code>.
   # @param [String,Symbol] name base name of art file
   # @param [Wx::BitmapType,nil] bmp_type bitmap type for art file (nil means any supported type)
+  # @param [String,nil] art_path base path to look up the art file
+  # @param [String,nil] art_section optional owner folder name for art files
   # @return [Wx::Cursor]
   # @see Wx::ArtLocator::find_art
-  def self.Cursor(name, bmp_type = nil); end
+  def self.Cursor(name, bmp_type = nil, art_path: nil, art_section: nil); end
 
 end

data/lib/wx/doc/data_object.rb

@@ -1,3 +1,9 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
 
 module Wx
 

data/lib/wx/doc/datetime.rb

@@ -0,0 +1,16 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+module Wx
+
+  # Default/Null time (mostly equates to `now`).
+  DEFAULT_DATE_TIME = nil
+
+  # Default/Null time (mostly equates to `now`).
+  DefaultDateTime = DEFAULT_DATE_TIME
+
+end

data/lib/wx/doc/dc.rb

@@ -1,3 +1,9 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
 
 module Wx
   class DC

data/lib/wx/doc/enum.rb

@@ -1,7 +1,14 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+
 ###
 # wxRuby3 Enum class
-# Copyright (c) M.J.N. Corino, The Netherlands
 ###
+# :startdoc:
+
 
 
 module Wx

data/lib/wx/doc/event.rb

@@ -1,3 +1,9 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
 
 module Wx
 
@@ -21,4 +27,10 @@ module Wx
 
   end
 
+  # Find a window with the focus, that is also a descendant of the given window.
+  # This is used to determine the window to initially send commands to.
+  # @param [Wx::Window] ancestor
+  # @return [Wx::Window,nil] descendant window of ancestor with focus
+  def self.find_focus_descendant(ancestor) end
+
 end

data/lib/wx/doc/event_blocker.rb

@@ -1,3 +1,9 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
 
 module Wx
 

data/lib/wx/doc/event_loop.rb

@@ -0,0 +1,13 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+module Wx
+
+  # In wxRuby simply an alias for GUIEventLoop.
+  EventLoop = GUIEventLoop
+
+end

data/lib/wx/doc/events.rb

@@ -1,3 +1,9 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
 
 module Wx
 

data/lib/wx/doc/evthandler.rb

@@ -1,4 +1,12 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+
 # Additional event handler methods documentation stubs.
+# :startdoc:
+
 
 
 class Wx::EvtHandler

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

@@ -18,9 +18,9 @@ is available for anyone to look at and use in any way they like. Also, anyone ca
 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.
+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
@@ -75,7 +75,7 @@ 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
+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 
@@ -127,8 +127,8 @@ When creating #on_init/#on_exit methods it is important to understand that those
 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).
+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.

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

@@ -56,117 +56,118 @@ Currently the following modules have been implemented.
 
 ### Core
 
-The core wxRuby package providing the toplevel `Wx` module.
+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`
+- {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.
+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`
+- {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.
+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`
+- {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.
+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`
+- {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.
+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`
+- {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.
+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`
+- {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.
+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`
+- {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.
+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`
+- {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.
+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`
+- {Wx::STC::StyledTextCtrl}
+- {Wx::STC::StyledTextEvent}
 
 ## Feature dependencies
 

data/lib/wx/doc/extra/02_lifecycles.md

@@ -76,7 +76,7 @@ As mentioned above the wxWidgets GUI framework resources will only be fully init
 starts. Likewise the framework resources will be de-initialized (deleted) after `#on_exit` method ends which means that 
 your application should not attempt to access any of these resources (windows, fonts, colours etc.) after that moment.
 
-Also, largely because of the way the wxWidgets framework is designed but also because of that way this meshes with Ruby 
+Also, largely because of the way the wxWidgets framework is designed but also because of the way this meshes with Ruby 
 GC, there is no safe way to re-initialize the framework after an application instance ends it run. This means you 
 **cannot** safely attempt to start another application instance after a previous (first) one has ended. 
 
@@ -120,7 +120,7 @@ therefor provides special support to ease handling the destruction of these. See
 One of the trickier things to handle correctly in the kind of native extensions like wxRuby is maintaining object 
 identities i.e. keeping native instances synced with their Ruby wrapper counter parts.
 
-Whenever a native extension is allowed to call back into Ruby space we encounter the problem the we need to map any 
+Whenever a native extension is allowed to call back into Ruby space we encounter the problem that we need to map any 
 native object data provided for the call to the right Ruby types and when necessary to the right Ruby instance (object
 identity).
 
@@ -131,8 +131,8 @@ passing them on to Ruby space.
 For a lot of other objects though it is essential to not only map to the right **most derived** class type but also to
 the exact Ruby instance which was originally instantiated as wrapper for the native object if any exists (in case no
 Ruby instance existed yet a new instance of the correct **most derived** class should be instantiated at that point). 
-The reason this is important is 1. because the Ruby instance may have been used to identify, link to or otherwise 
-reference other data and/or functionality related to that specific Ruby/native pair and 2. the Ruby instance could 
+The reason this is important is **1.** because the Ruby instance may have been used to identify, link to or otherwise 
+reference other data and/or functionality related to that specific Ruby/native pair and **2.** the Ruby instance could 
 contain data elements (instance variables) related to that specific Ruby/native pair.<br>
 In the case of wxRuby Window instance for example it is common to derive custom Window classes with custom behaviour and
 corresponding instance variables that drive that behaviour. When an event handler or an overloaded native method is passed
@@ -155,11 +155,12 @@ There are however quite a lot of wrapped native objects in wxRuby for which *obj
 object tracking has been disabled for their classes. This means these kind of classes/object should **not** be derived from
 (if even possible and/or useful) to add functionality/information or their identity used as key to link other information.<br>
 These classes include:
-- classes considered POD types like Wx::Size, Wx::Point, Wx::RealPoint, Wx::Rect, Wx::GBSpan, Wx::GBPosition, Wx::BusyInfoFlags,
+* classes considered POD types like Wx::Size, Wx::Point, Wx::RealPoint, Wx::Rect, Wx::GBSpan, Wx::GBPosition, Wx::BusyInfoFlags,
 Wx::AboutDialogInfo
-- final non-instantiatable classes like the Wx::DC (Device Context) class family, Wx::GraphicsContext, Wx::WindowsDisabler,
+* final non-instantiatable classes like the Wx::DC (Device Context) class family, Wx::GraphicsContext, Wx::WindowsDisabler,
 Wx::EventBlocker, Wx::BusyInfo
-- classes with native singleton objects like Wx::Clipboard
-- the reference counted GDI objects like Wx::Pen, Wx::Brush, Wx::Colour, Wx::Cursor, Wx::Bitmap, Wx::Icon
+* classes with native singleton objects like Wx::Clipboard
+* the reference counted GDI objects like Wx::Pen, Wx::Brush, Wx::Colour, Wx::Cursor, Wx::Bitmap, Wx::Icon and similar 
+reference counted objects like Wx::Font
 
 The reference documentation will note untracked object classes.