wxruby3 0.9.0.pre.rc.2 → 0.9.0

data/lib/wx/doc/extra/11_drawing_and_dc.md

@@ -12,19 +12,19 @@ device context object is destroyed.
 For this reason the common practice in wxWidgets C++ code would be to create temporary DC objects on the
 stack and draw on them while they are in scope (for several classes it is even strongly advised to never create
 them any other way and to never keep objects alive out of scope). When leaving the scope these object would than be 
-automatically destroyed and the any buffered output flushed to the final target.
+automatically destroyed and any buffered output flushed to the final target.
 
-In Ruby this approach is impossible as Ruby is a purely dynamic language and does not **this kind** of scope bound
+In Ruby this approach is impossible as Ruby is a purely dynamic language and does not support **this kind** of scope bound
 life cycles. Any DC object created would have to be dynamically created and due to the properties of the GC driven
 life cycles could well be kept alive beyond the scope of it's creation. This will not always cause problems but could
 and does not really have an upside.
 
-To prevent confusion and potential problems wxRuby defines all `Wx::DC` derived classes to be abstract classes that
-cannot be instantiated using `new`. Rather all `Wx::DC` derived classes provide `::draw_on` factory methods to create 
+To prevent confusion and potential problems wxRuby defines all {Wx::DC} derived classes to be abstract classes that
+cannot be instantiated using `new`. Rather all {Wx::DC} derived classes provide `::draw_on` factory methods to create 
 temporary dc objects that will be passed on to blocks given and will only exist for the duration of the execution of
 the block. This will guarantee proper DC cleanup when leaving it's usage scope.
 
-> Note that it is a **BAD** idea to think about storing the dc reference provide to the block for later access!
+> Note that it is a **BAD** idea to think about storing the dc reference provided to the block for later access!
 
 A typical usage of a `::draw_on` method would be:
 
@@ -44,11 +44,11 @@ A typical usage of a `::draw_on` method would be:
 
 ## Windows, Wx::PaintDC and Wx::AutoBufferedPaintDC
 
-The `Wx::PaintDC` and `Wx::AutoBufferedPaintDC` classes provide `::draw_on` methods just like all other DC classes but
+The {Wx::PaintDC} and {Wx::AutoBufferedPaintDC} classes provide `::draw_on` methods just like all other DC classes but
 this is mostly to be consistent.
 
-In this case it is recommended to instead use the `Wx::Window#paint` or `Wx::Window#paint_buffered` methods as these
-provide some optimizations with regard to automatically detecting is the methods are called inside `Wx::EVT_PAINT` 
+In this case it is recommended to instead use the {Wx::Window#paint} or {Wx::Window#paint_buffered} methods as these
+provide some optimizations with regard to automatically detecting if the methods are called inside `Wx::EVT_PAINT` 
 handlers (which should normally be the case) or not.
 
 So the typical way to do buffered painting inside a windows `Wx::EVT_PAINT` handler would be something like:

data/lib/wx/doc/font.rb

@@ -1,5 +1,11 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
 
-class Wx
+
+module Wx
   class Font
 
     # @overload find_or_create_font(point_size, family, style, weight, underline=false, facename='', encoding=Wx::FontEncoding::FONTENCODING_DEFAULT)

data/lib/wx/doc/font_data.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
+
+  FONTRESTRICT_NONE = 0
+
+  FONTRESTRICT_SCALABLE = 1 << 0
+
+  FONTRESTRICT_FIXEDPITCH = 1 << 1
+
+end

data/lib/wx/doc/functions.rb

@@ -1,6 +1,14 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+
+
 # Wx global methods
 #
 # Documentation stubs for global Wx methods
+# :startdoc:
+
 
 
 module Wx
@@ -11,32 +19,73 @@ module Wx
   # @param lvl  [Integer] logging level (like {Wx::LOG_Message})
   # @param fmt  [String]  message (formatting) string
   # @param args [Array<Object>] optional message arguments
-  # @return [nil]
-  def self.log_generic(lvl, fmt, *args) end
+  # @param filename [String] optional file name for log info
+  # @param line [Integer] optional line number for log info
+  # @param func [String] optional function name for log info
+  # @param component [String] optional component name for log info
+  # @return [void]
+  def self.log_generic(lvl, fmt, *args, filename: nil, line: 0, func: nil, component: nil) end
 
   # Log a Wx low priority informational message to the current Wx log output
   # @param fmt  [String]  message (formatting) string
   # @param args [Array<Object>] optional message arguments
-  # @return [nil]
-  def self.log_info(fmt, *args) end
+  # @param filename [String] optional file name for log info
+  # @param line [Integer] optional line number for log info
+  # @param func [String] optional function name for log info
+  # @param component [String] optional component name for log info
+  # @return [void]
+  def self.log_info(fmt, *args, filename: nil, line: 0, func: nil, component: nil) end
 
   # Log a Wx Informational message to the current Wx log output
   # @param fmt  [String]  message (formatting) string
   # @param args [Array<Object>] optional message arguments
-  # @return [nil]
-  def self.log_message(fmt, *args) end
+  # @param filename [String] optional file name for log info
+  # @param line [Integer] optional line number for log info
+  # @param func [String] optional function name for log info
+  # @param component [String] optional component name for log info
+  # @return [void]
+  def self.log_message(fmt, *args, filename: nil, line: 0, func: nil, component: nil) end
 
   # Log a Wx Error message to the current Wx log output
   # @param fmt  [String]  message (formatting) string
   # @param args [Array<Object>] optional message arguments
-  # @return [nil]
-  def self.log_error(fmt, *args) end
+  # @param filename [String] optional file name for log info
+  # @param line [Integer] optional line number for log info
+  # @param func [String] optional function name for log info
+  # @param component [String] optional component name for log info
+  # @return [void]
+  def self.log_error(fmt, *args, filename: nil, line: 0, func: nil, component: nil) end
 
   # Log a Wx Warning message to the current Wx log output
   # @param fmt  [String]  message (formatting) string
   # @param args [Array<Object>] optional message arguments
-  # @return [nil]
-  def self.log_warning(fmt, *args) end
+  # @param filename [String] optional file name for log info
+  # @param line [Integer] optional line number for log info
+  # @param func [String] optional function name for log info
+  # @param component [String] optional component name for log info
+  # @return [void]
+  def self.log_warning(fmt, *args, filename: nil, line: 0, func: nil, component: nil) end
+
+  # Log a Wx verbose informational message to the current Wx log output
+  # (needs explicit activation to be shown)
+  # @param fmt  [String]  message (formatting) string
+  # @param args [Array<Object>] optional message arguments
+  # @param filename [String] optional file name for log info
+  # @param line [Integer] optional line number for log info
+  # @param func [String] optional function name for log info
+  # @param component [String] optional component name for log info
+  # @return [void]
+  def self.log_verbose(fmt, *args, filename: nil, line: 0, func: nil, component: nil) end
+
+  # Log a Wx debug message to the current Wx log output
+  # @param fmt  [String]  message (formatting) string
+  # @param args [Array<Object>] optional message arguments
+  # @param filename [String] optional file name for log info
+  # @param line [Integer] optional line number for log info
+  # @param func [String] optional function name for log info
+  # @param component [String] optional component name for log info
+  # @return [void]
+  def self.log_debug(fmt, *args, filename: nil, line: 0, func: nil, component: nil) end
 
   # Log a Wx Status message - this is directed to the status bar of the
   # specified Frame window, or the application main window if not specified.
@@ -51,19 +100,6 @@ module Wx
   # @return [nil]
   def self.log_status(fmt, *args) end
 
-  # Log a Wx verbose informational message to the current Wx log output
-  # (needs explicit activation to be shown)
-  # @param fmt  [String]  message (formatting) string
-  # @param args [Array<Object>] optional message arguments
-  # @return [nil]
-  def self.log_verbose(fmt, *args) end
-
-  # Log a Wx debug message to the current Wx log output
-  # @param fmt  [String]  message (formatting) string
-  # @param args [Array<Object>] optional message arguments
-  # @return [nil]
-  def self.log_debug(fmt, *args) end
-
   # @!endgroup
 
   # @!group Other class methods
@@ -76,7 +112,7 @@ module Wx
   # string - useful for debugging
   # @param obj [Object] wrapped object
   # @return [String] string with address in hex format
-  def self.cpp_ptr_addr(obj) end
+  def self.ptr_addr(obj) end
 
   # Converts a string XRC id into a Wx id
   # @param str [String] XRC id string

data/lib/wx/doc/gc_dc.rb

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

data/lib/wx/doc/gdi_common.rb

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

data/lib/wx/doc/graphics_context.rb

@@ -1,42 +1,62 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
 
-class Wx::GraphicsContext
-
-  # @overload self.draw_on(window)
-  #   Creates a {Wx::GraphicsContext} from a {Wx::Window} and passes that object to the given block.
-  #   Deletes the gc object after the block returns.
-  #   @see Wx::GraphicsRenderer#create_context
-  #   @param window [Wx::Window]
-  #   @return [Wx::GraphicsContext]
-  # @overload self.draw_on(windowDC)
-  #   Creates a {Wx::GraphicsContext} from a {Wx::WindowDC} and passes that object to the given block.
-  #   Deletes the gc object after the block returns.
-  #   @see Wx::GraphicsRenderer#create_context
-  #   @param windowDC [Wx::WindowDC]
-  #   @return [Wx::GraphicsContext]
-  # @overload self.draw_on(memoryDC)
-  #   Creates a {Wx::GraphicsContext} from a {Wx::MemoryDC} and passes that object to the given block.
-  #   Deletes the gc object after the block returns.
-  #   @see Wx::GraphicsRenderer#create_context
-  #   @param memoryDC [Wx::MemoryDC]
-  #   @return [Wx::GraphicsContext]
-  # @overload self.draw_on(printerDC)
-  #   Creates a {Wx::GraphicsContext} from a {Wx::PrinterDC} and passes that object to the given block.
-  #   Deletes the gc object after the block returns.
-  #   Under GTK+, this will only work when using the GtkPrint printing backend which is available since GTK+ 2.10.
-  #   @see Wx::GraphicsRenderer#create_context
-  #   @see  Printing Under Unix (GTK+)
-  #   @param printerDC [Wx::PrinterDC]
-  #   @return [Wx::GraphicsContext]
-  # @overload self.draw_on(image)
-  #   Creates a {Wx::GraphicsContext} associated with a {Wx::Image} and passes that object to the given block.
-  #   Deletes the gc object after the block returns.
-  #   The image specifies the size of the context as well as whether alpha is supported (if {Wx::Image#has_alpha}) or not and the initial contents of the context. The image object must have a life time greater than that of the new context as the context copies its contents back to the image when it is destroyed.
-  #   @param image [Wx::Image]
-  #   @return [Wx::GraphicsContext]
-  # @overload self.draw_on()
-  #   Create a lightweight context that can be used only for measuring text and passes that object to the given block.
-  #   Deletes the gc object after the block returns.
-  #   @return [Wx::GraphicsContext]
-  def self.draw_on(*args) end
+
+module Wx
+
+  class GraphicsContext
+
+    # @overload self.draw_on(window)
+    #   Creates a {Wx::GraphicsContext} from a {Wx::Window} and passes that object to the given block.
+    #   Deletes the gc object after the block returns.
+    #   @see Wx::GraphicsRenderer#create_context
+    #   @param window [Wx::Window]
+    #   @return [Wx::GraphicsContext]
+    # @overload self.draw_on(windowDC)
+    #   Creates a {Wx::GraphicsContext} from a {Wx::WindowDC} and passes that object to the given block.
+    #   Deletes the gc object after the block returns.
+    #   @see Wx::GraphicsRenderer#create_context
+    #   @param windowDC [Wx::WindowDC]
+    #   @return [Wx::GraphicsContext]
+    # @overload self.draw_on(memoryDC)
+    #   Creates a {Wx::GraphicsContext} from a {Wx::MemoryDC} and passes that object to the given block.
+    #   Deletes the gc object after the block returns.
+    #   @see Wx::GraphicsRenderer#create_context
+    #   @param memoryDC [Wx::MemoryDC]
+    #   @return [Wx::GraphicsContext]
+    # @overload self.draw_on(printerDC)
+    #   Creates a {Wx::GraphicsContext} from a {Wx::PrinterDC} and passes that object to the given block.
+    #   Deletes the gc object after the block returns.
+    #   Under GTK+, this will only work when using the GtkPrint printing backend which is available since GTK+ 2.10.
+    #   @see Wx::GraphicsRenderer#create_context
+    #   @see  Printing Under Unix (GTK+)
+    #   @param printerDC [Wx::PrinterDC]
+    #   @return [Wx::GraphicsContext]
+    # @overload self.draw_on(image)
+    #   Creates a {Wx::GraphicsContext} associated with a {Wx::Image} and passes that object to the given block.
+    #   Deletes the gc object after the block returns.
+    #   The image specifies the size of the context as well as whether alpha is supported (if {Wx::Image#has_alpha}) or not and the initial contents of the context. The image object must have a life time greater than that of the new context as the context copies its contents back to the image when it is destroyed.
+    #   @param image [Wx::Image]
+    #   @return [Wx::GraphicsContext]
+    # @overload self.draw_on()
+    #   Create a lightweight context that can be used only for measuring text and passes that object to the given block.
+    #   Deletes the gc object after the block returns.
+    #   @return [Wx::GraphicsContext]
+    def self.draw_on(*args) end
+
+  end
+
+  class GraphicsGradientStop
+
+    # Creates a stop with the given colour and position.
+    # @param col [Wx::Colour]  The colour of this stop. Note that the alpha component of the colour is honoured thus allowing the background colours to partially show through the gradient.
+    # @param pos [Float]  The stop position, must be in [0, 1] range with 0 being the beginning and 1 the end of the gradient.
+    # @return [Wx::GraphicsGradientStop]
+    def initialize(col=Wx::TransparentColour, pos=0.0) end
+
+  end
 
 end

data/lib/wx/doc/grid/grid.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::GRID
 
@@ -15,6 +21,15 @@ module Wx::GRID
     alias :set_table :assign_table
     alias :table= :assign_table
 
+    # Iterates all selected blocks passing each corresponding Wx::GRID::GridBlockCoords to the given block
+    # or returns an enumerator if no block given.
+    # @yieldparam [Wx::GRID::GridBlockCoords] selected_block
+    # @return [Object,Enumerator] result of last block execution or an Enumerator if no block given
+    def selected_blocks; end
+
   end
-  
+
+  # Provides an opaque handle for grid windows.
+  class GridWindow; end
+
 end

data/lib/wx/doc/hboxsizer.rb

@@ -0,0 +1,33 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+module Wx
+
+  # Just a shortcut version for creating a horizontal box sizer
+  class HBoxSizer < Wx::BoxSizer
+
+    # Constructor for a {Wx::HBoxSizer}.
+    # @return [Wx::HBoxSizer]
+    def initialize; end
+
+  end
+
+  # Just a shortcut version for creating a horizontal wrap sizer
+  class HWrapSizer < Wx::WrapSizer
+
+    # Constructor for a {Wx::HWrapSizer}.
+    # The flags parameter can be a combination of the values {Wx::EXTEND_LAST_ON_EACH_LINE} which will cause the last
+    # item on each line to use any remaining space on that line and {Wx::REMOVE_LEADING_SPACES} which removes any spacer
+    # elements from the beginning of a row.
+    # Both of these flags are on by default.
+    # @param flags [Integer]
+    # @return [Wx::HWrapSizer]
+    def initialize(flags=Wx::WRAPSIZER_DEFAULT_FLAGS) end
+
+  end
+
+end

data/lib/wx/doc/help_controller.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::HelpController
 

data/lib/wx/doc/html/html_help_controller.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::HTML::HelpController
 

data/lib/wx/doc/icon.rb

@@ -1,18 +1,26 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
 
-class Wx::Icon
+
+class Wx
 
   # Searches for an art file with basename 'name' and creates an Icon 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>:icon</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 [Integer] desired_width
   # @param [Integer] desired_height
+  # @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::Icon]
   # @see Wx::ArtLocator::find_art
-  def self.Icon(name, bmp_type = nil, desired_width=-1, desired_height=-1); end
+  def self.Icon(name, bmp_type = nil, desired_width=-1, desired_height=-1, art_path: nil, art_section: nil); end
 
 end

data/lib/wx/doc/id_helper.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/image.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
 
@@ -11,23 +17,55 @@ module Wx
     # @return [Array<String>]
     def self.extensions; end
 
+    # Returns an array with the supported mime types of the available image handlers.
+    # @return [Array<String>]
+    def self.mime_types; end
+
     # returns a Hash with all supported extensions per available BitmapType
     # @return [Hash]
     def self.handler_extensions; end
 
-    # Searches for an art file with basename 'name' and creates an Image 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>.
-    # @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 [Integer] index  Index of the image to load in the case that the image file contains multiple images. This is only used by GIF, ICO and TIFF handlers. The default value (-1) means "choose the default image" and is interpreted as the first image (index=0) by the GIF and TIFF handler and as the largest and most colourful one by the ICO handler.
-    # @return [Wx::Image]
-    # @see Wx::ArtLocator::find_art
-    def self.Image(name, bmp_type = nil, index=-1); end
+    module Histogram
+
+      # Calculate an image histogram key from given RGB values.
+      # @param [Integer] r Red value
+      # @param [Integer] g Green value
+      # @param [Integer] b Blue value
+      # @return [Integer] key value
+      def make_key(r,g,b) end
+
+      # Find first colour that is not used in the image and has higher RGB values than RGB(r, g, b)
+      # @param [Integer] r Red value
+      # @param [Integer] g Green value
+      # @param [Integer] b Blue value
+      # @return [Array(Integer,Integer,Integer),nil] RGB values of first unused colour or nil if none found
+      def find_first_unused_colour(r=1, g=0, b=0) end
+
+    end
+
+    # Computes the histogram of the image and fills a hash table, indexed
+    # with integer keys built as 0xRRGGBB, containing pairs (Array) of integer values.
+    # For each pair the first value is the index of the first pixel in the colour in the image
+    # and the second value the number of pixels having the colour in the image.
+    # The returned Hash object is extended with the {Wx::Image::Histogram} mixin.
+    # @return [Hash] hash object extended with {Wx::Image::Histogram}
+    def compute_histogram; end
 
   end
 
+  # Searches for an art file with basename 'name' and creates an Image 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_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>:image</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 [Integer] index  Index of the image to load in the case that the image file contains multiple images. This is only used by GIF, ICO and TIFF handlers. The default value (-1) means "choose the default image" and is interpreted as the first image (index=0) by the GIF and TIFF handler and as the largest and most colourful one by the ICO handler.
+  # @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::Image]
+  # @see Wx::ArtLocator::find_art
+  def self.Image(name, bmp_type = nil, index=-1, art_path: nil, art_section: nil); end
+
 end

data/lib/wx/doc/list_ctrl.rb

@@ -0,0 +1,38 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+class Wx::ListCtrl
+
+  include Enumerable
+
+  # Iterates all items in the list control passing each item (id) to the given block.
+  # @yieldparam [Integer] item
+  # @return [Object] result of last block iteration
+  def each(&block) end
+
+  # Iterates all selected items in the list control (like #get_next_item(item, Wx::LIST_NEXT_ALL, Wx::LIST_STATE_SELECTED))
+  # passing each item (id) to the given block.
+  # @yieldparam [Integer] item
+  # @return [Object] result of last block iteration
+  def each_selected(&block) end
+
+  # Returns array of selected items.
+  # @return [Array<Integer>] selected items
+  def get_selections; end
+
+  # Call this function to sort the items in the list control.
+  # The sorting method will call the given block repeatedly to compare two items from the list
+  # passing the <b>item data</b> for each item as well as the `data` argument given to the #sort_items method.
+  # The block should return 0 if the items are equal, negative value if the first item is less than the second
+  # one and positive value if the first one is greater than the second one.
+  # @param [Object] data user data to pass on to the sorting block
+  # @yieldparam [Object] item_data1 data for first item
+  # @yieldparam [Object] item_data2 data for second item
+  # @yieldparam [Object] data propagated data argument
+  def sort_items(data = nil, &block) end
+
+end

data/lib/wx/doc/log.rb

@@ -0,0 +1,45 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+module Wx
+
+  class Log
+
+    # Sets the current component for log info to the given value before executing the
+    # given block and restores the previous component value after the block returns.
+    # @param [String] comp component value for log info
+    def self.for_component(comp, &block) end
+
+  end
+
+  class LogStderr
+
+    # Creates a new LogStderr for the given file handle.
+    # Possible values are 2 for `stderr` and 1 for `stdout`.
+    # @param [Integer] fh file stream handle
+    def initialize(fh = 2) end
+  end
+
+  class LogNull
+
+    # Suspends logging before executing the given block and restarts logging when the block returns.
+    def self.no_log(&block) end
+
+  end
+
+  class LogChain
+
+    # Releases the redirection chain and restores the previous log instance as the active log target.
+    # Traditionally in C++ applications would rely on the destructor to do this but that is not a really
+    # predictable option in wxRuby since destruction only takes place after GC collection (which is not
+    # exactly predictable) so wxRuby adds this method to better control restoration time if needed.
+    # @return [void]
+    def release; end
+
+  end
+
+end

data/lib/wx/doc/memory_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
 

data/lib/wx/doc/mirror_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
 

data/lib/wx/doc/pen.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