wxruby3 0.9.1-x64-mingw-ucrt → 0.9.2-x64-mingw-ucrt

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

@@ -17,14 +17,13 @@ module Wx
   # If you need direct access the bitmap data instead going through drawing to it using {Wx::MemoryDC} you need to use the {Wx::PixelData} class (either {Wx::NativePixelData} for RGB bitmaps or {Wx::AlphaPixelData} for bitmaps with an additionally alpha channel).
   # Note that many {Wx::Bitmap} functions take a type parameter, which is a value of the {Wx::BitmapType} enumeration. The validity of those values depends however on the platform where your program is running and from the wxWidgets configuration. If all possible wxWidgets settings are used:
   # 
-  # - wxMSW supports BMP and ICO files, BMP and ICO resources;
-  # - wxGTK supports any file supported by gdk-pixbuf;
-  # - wxMac supports PICT resources;
-  # - wxX11 supports XPM files, XPM data, XBM data;
+  # - WXMSW supports BMP and ICO files, BMP and ICO resources;
+  # - WXGTK supports any file supported by gdk-pixbuf;
+  # - WXOSX supports PICT resources;
+  # - WXX11 supports XPM files, XPM data, XBM data;
   # 
   # In addition, {Wx::Bitmap} can load and save all formats that {Wx::Image} can; see {Wx::Image} for more info. Of course, you must have loaded the {Wx::Image} handlers (see {init_all_image_handlers} and {Wx::Image.add_handler}). Note that all available {Wx::BitmapHandlers} for a given wxWidgets port are automatically loaded at startup so you won't need to use {Wx::Bitmap.add_handler}.
   # More on the difference between {Wx::Image} and {Wx::Bitmap}: {Wx::Image} is just a buffer of RGB bytes with an optional buffer for the alpha bytes. It is all generic, platform independent and image file format independent code. It includes generic code for scaling, resizing, clipping, and other manipulations of the image data. OTOH, {Wx::Bitmap} is intended to be a wrapper of whatever is the native image format that is quickest/easiest to draw to a DC or to be the target of the drawing operations performed on a {Wx::MemoryDC}. By splitting the responsibilities between {Wx::Image}/{Wx::Bitmap} like this then it's easier to use generic code shared by all platforms and image types for generic operations and platform specific code where performance or compatibility is needed.
-  # === 
   # 
   # Category:  Graphics Device Interface (GDI)
   # Predefined objects/pointers: {Wx::NULL_BITMAP}
@@ -207,7 +206,7 @@ module Wx
     alias_method :logical_height, :get_logical_height
     
     # Returns the size of the bitmap in logical pixels.
-    # For the platforms using DPI-independent pixels, i.e. those where {Wx::HAS_DPI_INDEPENDENT_PIXELS} is defined, such as wxOSX or wxGTK 3, this function returns the physical size of the bitmap, as returned by {Wx::Bitmap#get_size}, divided by its scale factor, as returned by {Wx::Bitmap#get_scale_factor}, while for the other platforms, it simply returns the same thing as {Wx::Bitmap#get_size}.
+    # For the platforms using DPI-independent pixels, i.e. those where {Wx::HAS_DPI_INDEPENDENT_PIXELS} is defined, such as WXOSX or WXGTK 3, this function returns the physical size of the bitmap, as returned by {Wx::Bitmap#get_size}, divided by its scale factor, as returned by {Wx::Bitmap#get_scale_factor}, while for the other platforms, it simply returns the same thing as {Wx::Bitmap#get_size}.
     # This ensures that the result of this function is always expressed in the pixel coordinates appropriate for the current platform, i.e. its return value is always in logical pixels, used for window and {Wx::DC} coordinates, whether these pixels are the same as physical pixels, which are returned by {Wx::Bitmap#get_size}, or not.
     # @see Wx::Bitmap#get_logical_width
     # @see  Wx::Bitmap#get_logical_height
@@ -241,7 +240,7 @@ module Wx
     
     # Returns the scale factor of this bitmap.
     # Scale factor is 1 by default, but can be greater to indicate that the size of bitmap in logical, DPI-independent pixels is smaller than its actual size in physical pixels. Bitmaps with scale factor greater than 1 must be used in high DPI to appear sharp on the screen.
-    # Note that the scale factor is only used in the ports where logical pixels are not the same as physical ones, such as wxOSX or wxGTK3, and this function always returns 1 under the other platforms.
+    # Note that the scale factor is only used in the ports where logical pixels are not the same as physical ones, such as WXOSX or WXGTK3, and this function always returns 1 under the other platforms.
     # @see Wx::Bitmap#set_scale_factor
     # @see  Wx::Bitmap#get_logical_width
     # @see  Wx::Bitmap#get_logical_height
@@ -300,7 +299,11 @@ module Wx
     # Loads a bitmap from a file or resource.
     # true if the operation succeeded, false otherwise.
     # 
-    # A palette may be associated with the bitmap if one exists (especially for colour Windows bitmaps), and if the code supports it. You can check if one has been created by using the {Wx::Bitmap#get_palette} member.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>A palette may be associated with the bitmap if one exists (especially for colour Windows bitmaps), and if the code supports it. You can check if one has been created by using the {Wx::Bitmap#get_palette} member.
+    # </p>
+    # </div>>
     # @see Wx::Bitmap#save_file 
     # @param name [String]  Either a filename or a Windows resource name. The meaning of name is determined by the type parameter.
     # @param type [Wx::BitmapType]  One of the {Wx::BitmapType} values; see the note in the class detailed description. Note that the {Wx::BITMAP_DEFAULT_TYPE} constant has different value under different wxWidgets ports. See the bitmap.h header for the value it takes for a specific port.
@@ -315,7 +318,11 @@ module Wx
     # Saves a bitmap in the named file.
     # true if the operation succeeded, false otherwise.
     # 
-    # Depending on how wxWidgets has been configured, not all formats may be available.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Depending on how wxWidgets has been configured, not all formats may be available.
+    # </p>
+    # </div>>
     # @see Wx::Bitmap#load_file 
     # @param name [String]  A filename. The meaning of name is determined by the type parameter.
     # @param type [Wx::BitmapType]  One of the {Wx::BitmapType} values; see the note in the class detailed description.
@@ -324,7 +331,7 @@ module Wx
     def save_file(name, type, palette=nil) end
     
     # Sets the bitmap scale factor.
-    # This doesn't change the bitmap actual size or its contents, but changes its scale factor, so that it appears in a smaller size when it is drawn on screen: e.g. setting scale to 2 means that the bitmap will be twice smaller (in each direction) when drawn on screen in the ports in which logical and physical pixels differ (i.e. wxOSX and wxGTK3, but not wxMSW).
+    # This doesn't change the bitmap actual size or its contents, but changes its scale factor, so that it appears in a smaller size when it is drawn on screen: e.g. setting scale to 2 means that the bitmap will be twice smaller (in each direction) when drawn on screen in the ports in which logical and physical pixels differ (i.e. WXOSX and WXGTK3, but not WXMSW).
     # When creating a new bitmap, {Wx::Bitmap#create_with_dip_size} can be used to specify the correct scale factor from the beginning.
     # @param scale [Float] 
     # @return [void]
@@ -332,9 +339,17 @@ module Wx
     alias_method :scale_factor=, :set_scale_factor
     
     # Sets the mask for this bitmap.
-    # The bitmap object owns the mask once this has been called.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>The bitmap object owns the mask once this has been called.
+    # </p>
+    # </div>>
     # 
-    # A mask can be set also for bitmap with an alpha channel but doing so under wxMSW is not recommended because performance of drawing such bitmap is not very good.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>A mask can be set also for bitmap with an alpha channel but doing so under WXMSW is not recommended because performance of drawing such bitmap is not very good.
+    # </p>
+    # </div>
     # @see Wx::Bitmap#get_mask
     # @see  Wx::Mask 
     # @param mask [Wx::Mask] 
@@ -381,7 +396,6 @@ module Wx
   # Of course, this code relies on actually having the resources with the corresponding names (i.e. open_NxN) in MSW .rc file or Mac application bundle and open_NxN_png arrays being defined in the program code, e.g. by including a file generated with bin2c (see {bitmap_png_from_data}), on the other platforms.
   # 
   # Also note that the existing code using {Wx::Bitmap} is compatible with the functions taking {Wx::BitmapBundle} in wxWidgets 3.1.6 and later because bitmaps are implicitly convertible to the objects of this class, so just passing {Wx::Bitmap} to the functions taking {Wx::BitmapBundle} continues to work and if high resolution versions of bitmap are not (yet) available for the other toolbar tools, single bitmaps can continue to be used instead.
-  # === 
   # 
   # Category:  Graphics Device Interface (GDI)
   # 
@@ -552,9 +566,12 @@ module Wx
   
   # This class encapsulates a monochrome mask bitmap, where the masked area is black and the unmasked area is white.
   # When associated with a bitmap and drawn in a device context, the unmasked area of the bitmap will be drawn, and the masked area will not be drawn.
-  # A mask can be associated also with a bitmap with an alpha channel but drawing such bitmaps under wxMSW may be slow so using them should be avoided if drawing performance is an important factor.
   # 
-  # === 
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>A mask can be associated also with a bitmap with an alpha channel but drawing such bitmaps under WXMSW may be slow so using them should be avoided if drawing performance is an important factor.
+  # </p>
+  # </div>
   # 
   # Category:  Graphics Device Interface (GDI)
   # @see Wx::Bitmap
@@ -602,7 +619,7 @@ module Wx
     def create(*args) end
     
     # Returns the mask as a monochrome bitmap.
-    # Currently this method is implemented in wxMSW, wxGTK and wxOSX.
+    # Currently this method is implemented in WXMSW, WXGTK and WXOSX.
     # @return [Wx::Bitmap]
     def get_bitmap; end
     alias_method :bitmap, :get_bitmap

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

@@ -8,7 +8,7 @@ module Wx
 
   # A bitmap button is a control that contains a bitmap.
   # Notice that since wxWidgets 2.9.1 bitmap display is supported by the base {Wx::Button} class itself and the only tiny advantage of using this class is that it allows specifying the bitmap in its constructor, unlike {Wx::Button}. Please see the base class documentation for more information about images support in {Wx::Button}.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -21,22 +21,21 @@ module Wx
   # - {Wx::BU_BOTTOM}: Aligns the bitmap label to the bottom of the button. 
   # 
   # Note that the {Wx::BU_EXACTFIT} style supported by {Wx::Button} is not used by this class as bitmap buttons don't have any minimal standard size by default.
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::CommandEvent} events.
   # Event handler methods for events emitted by this class:
   # 
   # - {Wx::EvtHandler#evt_button}(id, meth = nil, &block): Process a {Wx::EVT_BUTTON} event, when the button is clicked. 
   # 
-  # === 
-  # 
-  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
   # @see Wx::Button 
   # 
   # 
+  # @wxrb_require USE_BMPBUTTON
   class BitmapButton < Button
   
     # @overload initialize()
@@ -44,7 +43,11 @@ module Wx
     #   @return [Wx::BitmapButton]
     # @overload initialize(parent, id, bitmap, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::BUTTON_NAME_STR)
     #   Constructor, creating and showing a button.
-    #   The bitmap parameter is normally the only bitmap you need to provide, and wxWidgets will draw the button correctly in its different states. If you want more control, call any of the functions {Wx::BitmapButton#set_bitmap_pressed}, {Wx::BitmapButton#set_bitmap_focus}, {Wx::BitmapButton#set_bitmap_disabled}.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>The bitmap parameter is normally the only bitmap you need to provide, and wxWidgets will draw the button correctly in its different states. If you want more control, call any of the functions {Wx::BitmapButton#set_bitmap_pressed}, {Wx::BitmapButton#set_bitmap_focus}, {Wx::BitmapButton#set_bitmap_disabled}.
+    #   </p>
+    #   </div>>
     #   @see Wx::BitmapButton#create
     #   @see  Wx::Validator 
     #   @param parent [Wx::Window]  Parent window. Must not be NULL.

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

@@ -8,9 +8,14 @@ module Wx
 
   # A combobox that displays bitmap in front of the list items.
   # It currently only allows using bitmaps of one size, and resizes itself so that a bitmap can be shown next to the text field.
-  # While {Wx::BitmapComboBox} contains the {Wx::ComboBox} API, but it might not actually be derived from that class. In fact, if the platform does not have a native implementation, {Wx::BitmapComboBox} will inherit from {Wx::OwnerDrawnComboBox}. You can determine if the implementation is generic by checking whether {Wx::GENERIC_BITMAPCOMBOBOX} is defined. Currently {Wx::BitmapComboBox} is implemented natively for MSW and GTK+.
   # 
-  # === Styles
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>While {Wx::BitmapComboBox} contains the {Wx::ComboBox} API, but it might not actually be derived from that class. In fact, if the platform does not have a native implementation, {Wx::BitmapComboBox} will inherit from {Wx::OwnerDrawnComboBox}. You can determine if the implementation is generic by checking whether {Wx::GENERIC_BITMAPCOMBOBOX} is defined. Currently {Wx::BitmapComboBox} is implemented natively for MSW and GTK+.
+  # </p>
+  # </div>>
+  # 
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -22,7 +27,7 @@ module Wx
   # 
   # Todocreate {Wx::CB_PROCESS_ENTER} rather than reusing {Wx::TE_PROCESS_ENTER}!
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::CommandEvent} events.
   # Event handler methods for events emitted by this class:
@@ -33,11 +38,9 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_text_enter}(id, meth = nil, &block): Process a {Wx::EVT_TEXT_ENTER} event, when RETURN is pressed in the combobox. 
   # 
-  # === 
-  # 
-  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
   # @see Wx::ComboBox
   # @see  Wx::Choice
@@ -45,6 +48,7 @@ module Wx
   # @see  Wx::CommandEvent 
   # 
   # 
+  # @wxrb_require USE_BITMAPCOMBOBOX
   class BitmapComboBox < ComboBox
   
     # @overload initialize()

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

@@ -58,12 +58,12 @@ module Wx
   # - {Wx::Toolbook}: controlled by a {Wx::ToolBar}
   # 
   # This abstract class is the parent of all these book controls, and provides their basic interface. This is a pure virtual class so you cannot allocate it directly.
-  # === 
   # 
   # Category:  Book Controls
   # @see wxBookCtrl Overview 
   # 
   # 
+  # @wxrb_require USE_AUI|USE_NOTEBOOK|USE_LISTBOOK|USE_CHOICEBOOK|USE_TOOLBOOK|USE_TREEBOOK
   class BookCtrlBase < Control
   
     include Wx::WithImages
@@ -141,7 +141,11 @@ module Wx
     # 
     # true if successful, false otherwise.
     # 
-    # Do not delete the page, it will be deleted by the book control.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Do not delete the page, it will be deleted by the book control.
+    # </p>
+    # </div>>
     # @see Wx::BookCtrlBase#insert_page 
     # @param page [Wx::Window]  Specifies the new page.
     # @param text [String]  Specifies the text for the new page.
@@ -163,7 +167,11 @@ module Wx
     # Inserts a new page at the specified position.
     # true if successful, false otherwise.
     # 
-    # Do not delete the page, it will be deleted by the book control.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Do not delete the page, it will be deleted by the book control.
+    # </p>
+    # </div>>
     # @see Wx::BookCtrlBase#add_page 
     # @param index [Integer]  Specifies the position for the new page.
     # @param page [Wx::Window]  Specifies the new page.
@@ -224,7 +232,11 @@ module Wx
     def create(parent, winid, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, name=('')) end
     
     # Sets the width and height of the pages.
-    # This method is currently not implemented for wxGTK.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This method is currently not implemented for WXGTK. 
+    # </p>
+    # </div>
     # @param size [Array(Integer, Integer), Wx::Size] 
     # @return [void]
     def set_page_size(size) end

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

@@ -10,7 +10,6 @@ module Wx
   # The PAGE_CHANGING events are sent before the current page is changed. It allows the program to examine the current page (which can be retrieved with {Wx::BookCtrlEvent#get_old_selection}) and to veto the page change by calling {Wx::NotifyEvent#veto} if, for example, the current values in the controls of the old page are invalid.
   # The PAGE_CHANGED events are sent after the page has been changed and the program cannot veto it any more, it just informs it about the page change.
   # To summarize, if the program is interested in validating the page values before allowing the user to change it, it should process the PAGE_CHANGING event, otherwise PAGE_CHANGED is probably enough. In any case, it is probably unnecessary to process both events at once.
-  # === 
   # 
   # Category:  {Wx::Events}, Book Controls
   # @see Wx::Notebook
@@ -21,10 +20,11 @@ module Wx
   # @see  Wx::AUI::AuiNotebook 
   # 
   # 
+  # @wxrb_require USE_AUI|USE_NOTEBOOK|USE_LISTBOOK|USE_CHOICEBOOK|USE_TOOLBOOK|USE_TREEBOOK
   class BookCtrlEvent < NotifyEvent
   
     # Constructor (used internally by wxWidgets only).
-    # @param eventType [Wx::CommandLinkButton::EventType] 
+    # @param eventType [Wx::Slider::EventType] 
     # @param id [Integer] 
     # @param sel [Integer] 
     # @param oldSel [Integer] 
@@ -37,7 +37,11 @@ module Wx
     alias_method :old_selection, :get_old_selection
     
     # Returns the currently selected page, or {Wx::NOT_FOUND} if none was selected.
-    # under Windows, {Wx::BookCtrlEvent#get_selection} will return the same value as {Wx::BookCtrlEvent#get_old_selection} when called from the EVT_BOOKCTRL_PAGE_CHANGING handler and not the page which is going to be selected.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>under Windows, {Wx::BookCtrlEvent#get_selection} will return the same value as {Wx::BookCtrlEvent#get_old_selection} when called from the EVT_BOOKCTRL_PAGE_CHANGING handler and not the page which is going to be selected. 
+    # </p>
+    # </div>
     # @return [Integer]
     def get_selection; end
     alias_method :selection, :get_selection

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

@@ -8,7 +8,6 @@ module Wx
 
   # The basic idea behind a box sizer is that windows will most often be laid out in rather simple basic geometry, typically in a row or a column or several hierarchies of either.
   # For more information, please see {Wx::BoxSizer}.
-  # === 
   # 
   # Category:  Window Layout
   # @see Wx::Sizer

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

@@ -80,7 +80,6 @@ module Wx
   # Do not initialize objects on the stack before the program commences, since other required structures may not have been set up yet. Instead, define global pointers to objects and create them in {Wx::App::OnInit} or when required.
   # An application may wish to create brushes with different characteristics dynamically, and there is the consequent danger that a large number of duplicate brushes will be created. Therefore an application may wish to get a pointer to a brush by using the global list of brushes {Wx::TheBrushList}, and calling the member function Wx::BrushList#find_or_create_brush.
   # This class uses reference counting and copy-on-write internally so that assignments between two instances of this class are very cheap. You can therefore use actual objects instead of pointers without efficiency problems. If an instance of this class is changed it will create its own data internally so that other instances, which previously shared the data using the reference counting, are not affected.
-  # === 
   # 
   # Category:  Graphics Device Interface (GDI)
   # Predefined objects/pointers: 
@@ -206,7 +205,11 @@ module Wx
     alias_method :transparent?, :is_transparent
     
     # Sets the stipple bitmap.
-    # The style will be set to {Wx::BrushStyle::BRUSHSTYLE_STIPPLE}, unless the bitmap has a mask associated to it, in which case the style will be set to {Wx::BrushStyle::BRUSHSTYLE_STIPPLE_MASK_OPAQUE}.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>The style will be set to {Wx::BrushStyle::BRUSHSTYLE_STIPPLE}, unless the bitmap has a mask associated to it, in which case the style will be set to {Wx::BrushStyle::BRUSHSTYLE_STIPPLE_MASK_OPAQUE}.
+    # </p>
+    # </div>>
     # @see Wx::Bitmap 
     # @param bitmap [Wx::Bitmap]  The bitmap to use for stippling.
     # @return [void]

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

@@ -50,12 +50,11 @@ module Wx
   # but take care to not cause undesirable re-entrance when doing it (see {Wx::App#yield} for more details). The simplest way to do it is to use {Wx::WindowDisabler} class as illustrated in the above example.
   # Note that a {Wx::BusyInfo} is always built with the {Wx::STAY_ON_TOP} window style (see {Wx::Frame} window styles for more info).
   # 
-  # ===
-  # 
   # Category:  Common Dialogs
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_BUSYINFO
   class BusyInfo < ::Object
   
     # Update the information text.
@@ -89,6 +88,7 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_BUSYINFO
   class BusyInfoFlags < ::Object
   
     # Default constructor initializes all attributes to default values.

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

@@ -9,7 +9,7 @@ module Wx
   # A button is a control that contains a text string, and is one of the most common elements of a GUI.
   # It may be placed on a dialog box or on a {Wx::Panel} panel, or indeed on almost any other window.
   # By default, i.e. if none of the alignment styles are specified, the label is centered both horizontally and vertically. If the button has both a label and a bitmap, the alignment styles above specify the location of the rectangle combining both the label and the bitmap and the bitmap position set with {Wx::Button#set_bitmap_position} defines the relative position of the bitmap with respect to the label (however currently non-default alignment combinations are not implemented on all platforms).
-  # Since version 2.9.1 {Wx::Button} supports showing both text and an image (currently only when using wxMSW, wxGTK or wxOSX/Cocoa ports), see {Wx::Button#set_bitmap} and {Wx::Button#set_bitmap_label}, {Wx::Button#set_bitmap_disabled} &c methods. In the previous wxWidgets versions this functionality was only available in (the now trivial) {Wx::BitmapButton} class which was only capable of showing an image without text.
+  # Since version 2.9.1 {Wx::Button} supports showing both text and an image (currently only when using WXMSW, WXGTK or WXOSX/Cocoa ports), see {Wx::Button#set_bitmap} and {Wx::Button#set_bitmap_label}, {Wx::Button#set_bitmap_disabled} &c methods. In the previous wxWidgets versions this functionality was only available in (the now trivial) {Wx::BitmapButton} class which was only capable of showing an image without text.
   # A button may have either a single image for all states or different images for the following states (different images are not currently supported under macOS where the normal image is used for all states): 
   # 
   # - <b>normal:</b> the default state 
@@ -25,7 +25,7 @@ module Wx
   # All of the bitmaps must be of the same size and the normal bitmap must be set first (to a valid bitmap), before setting any other ones. Also, if the size of the bitmaps is changed later, you need to change the size of the normal bitmap before setting any other bitmaps with the new size (and you do need to reset all of them as their original values can be lost when the normal bitmap size changes).
   # The position of the image inside the button be configured using {Wx::Button#set_bitmap_position}. By default the image is on the left of the text.
   # Please also notice that GTK+ uses a global setting called <code>gtk-button-images</code> to determine if the images should be shown in the buttons at all. If it is off (which is the case in e.g. Gnome 2.28 by default), no images will be shown, consistently with the native behaviour.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -43,22 +43,21 @@ module Wx
   # 
   # - {Wx::Border::BORDER_NONE}: Creates a button without border. This is currently implemented in MSW, GTK2 and OSX/Cocoa. 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::CommandEvent} events.
   # Event handler methods for events emitted by this class:
   # 
   # - {Wx::EvtHandler#evt_button}(id, meth = nil, &block): Process a {Wx::EVT_BUTTON} event, when the button is clicked. 
   # 
-  # === 
-  # 
-  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
   # @see Wx::BitmapButton 
   # 
   # 
+  # @wxrb_require USE_BUTTON
   class Button < AnyButton
   
     # @overload initialize()
@@ -95,7 +94,11 @@ module Wx
     def create(parent, id, label=(''), pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=0, validator=Wx::DEFAULT_VALIDATOR, name=Wx::BUTTON_NAME_STR) end
     
     # Returns true if an authentication needed symbol is displayed on the button.
-    # This method always returns false if the platform is not Windows Vista or newer.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This method always returns false if the platform is not Windows Vista or newer.
+    # </p>
+    # </div>>
     # @see Wx::Button#set_auth_needed
     # @return [Boolean]
     def get_auth_needed; end
@@ -109,7 +112,11 @@ module Wx
     alias_method :label, :get_label
     
     # Sets whether an authentication needed symbol should be displayed on the button.
-    # This method doesn't do anything if the platform is not Windows Vista or newer.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This method doesn't do anything if the platform is not Windows Vista or newer.
+    # </p>
+    # </div>>
     # @see Wx::Button#get_auth_needed
     # @param needed [Boolean] 
     # @return [void]
@@ -120,7 +127,12 @@ module Wx
     # the panel or the dialog box containing it).
     # As normal, pressing return causes the default button to be depressed when the return key is pressed.
     # See also {Wx::Window#set_focus} which sets the keyboard focus for windows and text panel items, and {Wx::TopLevelWindow#set_default_item}.
-    # Under Windows, only dialog box buttons respond to this function.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Under Windows, only dialog box buttons respond to this function.
+    # </p>
+    # </div>>
     # 
     # the old default item (possibly NULL)
     # @return [Wx::Window]

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

@@ -7,15 +7,13 @@
 module Wx
 
   # This event is sent by {Wx::LayoutAlgorithm} to calculate the amount of the remaining client area that the window should occupy.
-  # === Events using this class
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::CalculateLayoutEvent} events.
   # Event handler methods:
   # 
   # - {Wx::EvtHandler#evt_calculate_layout}(meth = nil, &block): Process a {Wx::EVT_CALCULATE_LAYOUT} event, which asks the window to take a 'bite' out of a rectangle provided by the algorithm. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # @see Wx::QueryLayoutInfoEvent
   # @see  Wx::SashLayoutWindow

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

@@ -12,14 +12,14 @@ module Wx
   # All global settings (such as colours and fonts used) can, of course, be changed. But also, the display style for each day in the month can be set independently using {Wx::CalendarDateAttr} class.
   # An item without custom attributes is drawn with the default colours and font and without border, but setting custom attributes with {Wx::CalendarCtrl#set_attr} allows modifying its appearance. Just create a custom attribute object and set it for the day you want to be displayed specially (note that the control will take ownership of the pointer, i.e. it will delete it itself). A day may be marked as being a holiday, even if it is not recognized as one by {Wx::DateTime} using the {Wx::CalendarDateAttr#set_holiday} method.
   # As the attributes are specified for each day, they may change when the month is changed, so you will often want to update them in EVT_CALENDAR_PAGE_CHANGED event handler.
-  # If neither the {Wx::CAL_SUNDAY_FIRST} or {Wx::CAL_MONDAY_FIRST} style is given, the first day of the week is determined from operating system's settings, if possible. The native wxGTK calendar chooses the first weekday based on locale, and these styles have no effect on it.
-  # === Styles
+  # If neither the {Wx::CAL_SUNDAY_FIRST} or {Wx::CAL_MONDAY_FIRST} style is given, the first day of the week is determined from operating system's settings, if possible. The native WXGTK calendar chooses the first weekday based on locale, and these styles have no effect on it.
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
-  # - {Wx::CAL_SUNDAY_FIRST}: Show Sunday as the first day in the week (not in wxGTK) 
+  # - {Wx::CAL_SUNDAY_FIRST}: Show Sunday as the first day in the week (not in WXGTK) 
   # 
-  # - {Wx::CAL_MONDAY_FIRST}: Show Monday as the first day in the week (not in wxGTK) 
+  # - {Wx::CAL_MONDAY_FIRST}: Show Monday as the first day in the week (not in WXGTK) 
   # 
   # - {Wx::CAL_SHOW_HOLIDAYS}: Highlight holidays in the calendar (only generic) 
   # 
@@ -33,7 +33,7 @@ module Wx
   # 
   # - {Wx::CAL_SHOW_WEEK_NUMBERS}: Show week numbers on the left side of the calendar. (not in generic) 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::CalendarEvent} events.
   # Event handler methods for events emitted by this class:
@@ -48,21 +48,24 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_calendar_week_clicked}(id, meth = nil, &block): User clicked on the week of the year number (only generic). 
   # 
-  # Changing the selected date will trigger an EVT_CALENDAR_DAY, MONTH or YEAR event as well as an EVT_CALENDAR_SEL_CHANGED event.
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Changing the selected date will trigger an EVT_CALENDAR_DAY, MONTH or YEAR event as well as an EVT_CALENDAR_SEL_CHANGED event.
+  # </p>
+  # </div>
   # 
-  # === 
-  # 
-  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
-  # Implementations:  native under wxGTK, wxMSW ports; a generic implementation is used elsewhere.
+  # Implementations:  native under WXGTK, WXMSW ports; a generic implementation is used elsewhere.
   # @see Calendar Sample
   # @see  Wx::CalendarDateAttr
   # @see  Wx::CalendarEvent
   # @see  Wx::DatePickerCtrl 
   # 
   # 
+  # @wxrb_require USE_CALENDARCTRL
   class CalendarCtrl < Control
   
     # Restrict the dates that can be selected in the control to the specified range.
@@ -180,7 +183,7 @@ module Wx
     alias_method :holiday_colour_fg, :get_holiday_colour_fg
     
     # Returns one of {Wx::CalendarHitTestResult} constants and fills either date or wd pointer with the corresponding value depending on the hit test code.
-    # Not implemented in wxGTK currently.
+    # Not implemented in WXGTK currently.
     # @param pos [Array(Integer, Integer), Wx::Point] 
     # @param date [Wx::DateTime] 
     # @param wd [Wx::DateTime::WeekDay] 

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

@@ -8,12 +8,12 @@ module Wx
 
   # {Wx::CalendarDateAttr} is a custom attributes for a calendar date.
   # The objects of this class are used with {Wx::CalendarCtrl}.
-  # === 
   # 
   # Category:  Data Structures
   # @see Wx::CalendarCtrl 
   # 
   # 
+  # @wxrb_require USE_CALENDARCTRL
   class CalendarDateAttr < ::Object
   
     # @overload initialize(colText=Wx::NULL_COLOUR, colBack=Wx::NULL_COLOUR, colBorder=Wx::NULL_COLOUR, font=Wx::NULL_FONT, border=Wx::CalendarDateBorder::CAL_BORDER_NONE)

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

@@ -42,6 +42,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_CALENDARCTRL
   class CalendarDateBorder < Wx::Enum
   
     # No Border (Default)
@@ -62,6 +63,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_CALENDARCTRL
   class CalendarHitTestResult < Wx::Enum
   
     # Hit outside of anything.
@@ -115,12 +117,11 @@ module Wx
   EVT_CALENDAR_WEEK_CLICKED = 10082
   
   # The {Wx::CalendarEvent} class is used together with {Wx::CalendarCtrl}.
-  # === 
-  # 
   # Category:  {Wx::Events}
   # @see Wx::CalendarCtrl 
   # 
   # 
+  # @wxrb_require USE_CALENDARCTRL
   class CalendarEvent < DateEvent
   
     # @overload initialize()
@@ -128,7 +129,7 @@ module Wx
     # @overload initialize(win, dt, type)
     #   @param win [Wx::Window] 
     #   @param dt [Time,Date,DateTime] 
-    #   @param type [Wx::CommandLinkButton::EventType] 
+    #   @param type [Wx::Slider::EventType] 
     #   @return [Wx::CalendarEvent]
     def initialize(*args) end
     

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

@@ -10,7 +10,6 @@ module Wx
   # Text controls usually have their own caret but {Wx::Caret} provides a way to use a caret in other windows.
   # Currently, the caret appears as a rectangle of the given size. In the future, it will be possible to specify a bitmap to be used for the caret shape.
   # A caret is always associated with a window and the current caret can be retrieved using {Wx::Window#get_caret}. The same caret can't be reused in two different windows.
-  # === 
   # 
   # Category:  {Wx::Miscellaneous}
   # 

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

@@ -19,6 +19,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_CHECKBOX
   class CheckBoxState < Wx::Enum
   
     # 
@@ -37,7 +38,7 @@ module Wx
   
   # A checkbox is a labelled box which by default is either on (checkmark is visible) or off (no checkmark).
   # Optionally (when the {Wx::CHK_3STATE} style flag is set) it can have a third state, called the mixed or undetermined state. Often this is used as a "Does Not Apply" state.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -49,23 +50,22 @@ module Wx
   # 
   # - {Wx::Alignment::ALIGN_RIGHT}: Makes the text appear on the left of the checkbox. 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::CommandEvent} events.
   # Event handler methods for events emitted by this class:
   # 
   # - {Wx::EvtHandler#evt_checkbox}(id, meth = nil, &block): Process a {Wx::EVT_CHECKBOX} event, when the checkbox is clicked. 
   # 
-  # === 
-  # 
-  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
   # @see Wx::RadioButton
   # @see  Wx::CommandEvent 
   # 
   # 
+  # @wxrb_require USE_CHECKBOX
   class CheckBox < Control
   
     # @overload initialize()