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

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

@@ -76,7 +76,7 @@ module Wx
   
   # Font weights.
   # 
-  # The values of this enum correspond to the CSS font weight specifications, see https://www.w3.org/TR/css-fonts-4/#font-weight-prop, with the addition of one font weight bolder than heavy
+  # The values of this enum correspond to the CSS font weight specifications, see https://www.w3.org/TR/css-fonts-4/\#font-weight-prop, with the addition of one font weight bolder than heavy
   # 
   class FontWeight < Wx::Enum
   
@@ -132,7 +132,7 @@ module Wx
   
   # Symbolic font sizes.
   # 
-  # The elements of this enum correspond to CSS absolute size specifications, see http://www.w3.org/TR/CSS21/fonts.html#font-size-props
+  # The elements of this enum correspond to CSS absolute size specifications, see http://www.w3.org/TR/CSS21/fonts.html\#font-size-props
   # @see Wx::Font#set_symbolic_size
   # 
   # 
@@ -206,7 +206,7 @@ module Wx
     # 
     FONTFLAG_UNDERLINED = Wx::FontFlag.new(64)
     
-    # Strike-through style (implemented in MSW, GTK, and wxOSX)
+    # Strike-through style (implemented in MSW, GTK, and WXOSX)
     # 
     FONTFLAG_STRIKETHROUGH = Wx::FontFlag.new(128)
     
@@ -645,7 +645,6 @@ module Wx
   # The easiest way to create a custom font is to use {Wx::FontInfo} object to specify the font attributes and then use wxFont::wxFont(const wxFontInfo&) constructor. Alternatively, you could start with one of the pre-defined fonts or use {Wx::Window#get_font} and modify the font, e.g. by increasing its size using {Wx::Font#make_larger} or changing its weight using {Wx::Font#make_bold}.
   # 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.
   # You can retrieve the current system font settings with {Wx::SystemSettings}.
-  # === 
   # 
   # Category:  Graphics Device Interface (GDI)
   # Predefined objects/pointers: {Wx::NULL_FONT}, {Wx::NORMAL_FONT}, {Wx::SMALL_FONT}, {Wx::ITALIC_FONT}, {Wx::SWISS_FONT}
@@ -667,7 +666,7 @@ module Wx
     alias_method :base_font, :get_base_font
     
     # Returns the encoding of this font.
-    # Note that under wxGTK the returned value is always {Wx::FontEncoding::FONTENCODING_UTF8}.
+    # Note that under WXGTK the returned value is always {Wx::FontEncoding::FONTENCODING_UTF8}.
     # @see Wx::Font#set_encoding 
     # @return [Wx::FontEncoding]
     def get_encoding; end
@@ -700,7 +699,7 @@ module Wx
     
     # Returns a user-friendly string for this font object.
     # Returned string is always non-empty unless the font is invalid (in which case an assert is triggered).
-    # The string does not encode all {Wx::Font} infos under all platforms; e.g. under wxMSW the font family is not present in the returned string.
+    # The string does not encode all {Wx::Font} infos under all platforms; e.g. under WXMSW the font family is not present in the returned string.
     # Some examples of the formats of returned strings (which are platform-dependent) are in {Wx::Font#set_native_font_info_user_desc}.
     # @see Wx::Font#set_native_font_info_user_desc
     # @see  Wx::Font#get_native_font_info_desc 
@@ -726,7 +725,7 @@ module Wx
     alias_method :fractional_point_size, :get_fractional_point_size
     
     # Gets the pixel size.
-    # Note that under wxMSW if you passed to {Wx::Font#set_pixel_size} (or to the ctor) a {Wx::Size} object with a null width value, you'll get a null width in the returned object.
+    # Note that under WXMSW if you passed to {Wx::Font#set_pixel_size} (or to the ctor) a {Wx::Size} object with a null width value, you'll get a null width in the returned object.
     # @see Wx::Font#set_pixel_size 
     # @return [Wx::Size]
     def get_pixel_size; end
@@ -824,7 +823,7 @@ module Wx
     def underlined; end
     
     # Returns stricken-through version of this font.
-    # Currently stricken-through fonts are only supported in wxMSW, wxGTK, and wxOSX.
+    # Currently stricken-through fonts are only supported in WXMSW, WXGTK, and WXOSX.
     # @see Wx::Font#make_strikethrough
     # @return [Wx::Font]
     def strikethrough; end
@@ -864,7 +863,7 @@ module Wx
     def make_underlined; end
     
     # Changes this font to be stricken-through.
-    # Currently stricken-through fonts are only supported in wxMSW, wxGTK, and wxOSX.
+    # Currently stricken-through fonts are only supported in WXMSW, WXGTK, and WXOSX.
     # @see Wx::Font#strikethrough
     # @return [Wx::Font]
     def make_strikethrough; end
@@ -888,7 +887,7 @@ module Wx
     def scaled(x) end
     
     # Sets the encoding for this font.
-    # Note that under wxGTK this function has no effect (because the underlying Pango library always uses {Wx::FontEncoding::FONTENCODING_UTF8}).
+    # Note that under WXGTK this function has no effect (because the underlying Pango library always uses {Wx::FontEncoding::FONTENCODING_UTF8}).
     # @see Wx::Font#get_encoding 
     # @param encoding [Wx::FontEncoding] 
     # @return [void]
@@ -896,7 +895,11 @@ module Wx
     alias_method :encoding=, :set_encoding
     
     # Sets the facename for the font.
-    # To avoid portability problems, don't rely on a specific face, but specify the font family instead (see {Wx::FontFamily} and {Wx::Font#set_family}).
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>To avoid portability problems, don't rely on a specific face, but specify the font family instead (see {Wx::FontFamily} and {Wx::Font#set_family}).
+    # </p>
+    # </div>>
     # 
     # true if the given face name exists; if the face name doesn't exist in the user's system then the font is invalidated (so that {Wx::Font#is_ok} will return false) and false is returned.
     # @see Wx::Font#get_face_name
@@ -932,18 +935,18 @@ module Wx
     # generic syntax 
     # example 
     # 
-    # wxGTK2 
+    # WXGTK2 
     # <code>[underlined] [strikethrough] [FACE-NAME] [bold] [oblique|italic] [POINTSIZE]</code> 
     # Monospace bold 10 
     # 
-    # wxMSW 
+    # WXMSW 
     # <code>[light|bold] [italic] [FACE-NAME] [POINTSIZE] [ENCODING]</code> 
     # Tahoma 10 WINDOWS-1252 
     # 
-    # Todoadd an example for wxMac
+    # Todoadd an example for WXOSX
     # 
     # For more detailed information about the allowed syntaxes you can look at the documentation of the native API used for font-rendering (e.g. pango_font_description_from_string under GTK, although notice that it doesn't support the "underlined" and "strikethrough" attributes and so those are handled by wxWidgets itself).
-    # Note that unlike {Wx::Font#set_native_font_info}, this function doesn't always restore all attributes of the {Wx::Font} object under all platforms; e.g. on wxMSW the font family is not restored (because GetNativeFontInfoUserDesc doesn't return it on wxMSW). If you want to serialize/deserialize a font in string form, you should use {Wx::Font#get_native_font_info_desc} and {Wx::Font#set_native_font_info} instead.
+    # Note that unlike {Wx::Font#set_native_font_info}, this function doesn't always restore all attributes of the {Wx::Font} object under all platforms; e.g. on WXMSW the font family is not restored (because GetNativeFontInfoUserDesc doesn't return it on WXMSW). If you want to serialize/deserialize a font in string form, you should use {Wx::Font#get_native_font_info_desc} and {Wx::Font#set_native_font_info} instead.
     # @see Wx::Font#set_native_font_info 
     # @param info [String] 
     # @return [Boolean]
@@ -968,7 +971,7 @@ module Wx
     
     # Sets the pixel size.
     # The height parameter of pixelSize must be positive while the width parameter may also be zero (to indicate that you're not interested in the width of the characters: a suitable width will be chosen for best rendering).
-    # This feature (specifying the font pixel size) is directly supported only under wxMSW and wxGTK currently; under other platforms a font with the closest size to the given one is found using binary search (this maybe slower).
+    # This feature (specifying the font pixel size) is directly supported only under WXMSW and WXGTK currently; under other platforms a font with the closest size to the given one is found using binary search (this maybe slower).
     # @see Wx::Font#get_pixel_size 
     # @param pixelSize [Array(Integer, Integer), Wx::Size] 
     # @return [void]
@@ -1007,7 +1010,7 @@ module Wx
     alias_method :underlined=, :set_underlined
     
     # Sets strike-through attribute of the font.
-    # Currently stricken-through fonts are only supported in wxMSW, wxGTK, and wxOSX.
+    # Currently stricken-through fonts are only supported in WXMSW, WXGTK, and WXOSX.
     # @see Wx::Font#get_strikethrough
     # @param strikethrough [Boolean]  true to add strike-through style, false to remove it.
     # @return [void]
@@ -1103,7 +1106,11 @@ module Wx
     #                         Wx::FontWeight::FONTWEIGHT_BOLD, true)
     #   ```
     #   
-    #   If the desired font does not exist, the closest match will be chosen. Under Windows, only scalable TrueType fonts are used.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>If the desired font does not exist, the closest match will be chosen. Under Windows, only scalable TrueType fonts are used. 
+    #   </p>
+    #   </div>>
     #   @param pointSize [Integer]  Size in points. See {Wx::Font#set_point_size} for more info. Notice that, for historical reasons, the value 70 here is interpreted at {Wx::DEFAULT} and results in creation of the font with the default size and not of a font with the size of 70pt. If you really need the latter, please use SetPointSize(70). Note that this constructor and the matching Create() method overload are the only places in {Wx::Font} API handling {Wx::DEFAULT} specially: neither {Wx::Font#set_point_size} nor the constructor taking {Wx::FontInfo} handle this value in this way.
     #   @param family [Wx::FontFamily]  The font family: a generic portable way of referring to fonts without specifying a facename. This parameter must be one of the {Wx::FontFamily} enumeration values. If the faceName argument is provided, then it overrides the font family.
     #   @param style [Wx::FontStyle]  One of {Wx::FontStyle::FONTSTYLE_NORMAL}, {Wx::FontStyle::FONTSTYLE_SLANT} and {Wx::FontStyle::FONTSTYLE_ITALIC}.
@@ -1116,7 +1123,11 @@ module Wx
     #   Creates a font object with the specified attributes and size in pixels.
     #   Notice that the use of this constructor is often more verbose and less readable than the use of constructor from {Wx::FontInfo}, consider using that constructor instead.
     #   
-    #   If the desired font does not exist, the closest match will be chosen. Under Windows, only scalable TrueType fonts are used.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>If the desired font does not exist, the closest match will be chosen. Under Windows, only scalable TrueType fonts are used. 
+    #   </p>
+    #   </div>>
     #   @param pixelSize [Array(Integer, Integer), Wx::Size]  Size in pixels. See {Wx::Font#set_pixel_size} for more info.
     #   @param family [Wx::FontFamily]  The font family: a generic portable way of referring to fonts without specifying a facename. This parameter must be one of the {Wx::FontFamily} enumeration values. If the faceName argument is provided, then it overrides the font family.
     #   @param style [Wx::FontStyle]  One of {Wx::FontStyle::FONTSTYLE_NORMAL}, {Wx::FontStyle::FONTSTYLE_SLANT} and {Wx::FontStyle::FONTSTYLE_ITALIC}.
@@ -1263,7 +1274,7 @@ module Wx
     def underlined(underlined=true) end
     
     # Use a strike-through version of the font.
-    # Currently this is only implemented in wxMSW, wxGTK, and wxOSX.
+    # Currently this is only implemented in WXMSW, WXGTK, and WXOSX.
     # @param strikethrough [Boolean] 
     # @return [Wx::FontInfo]
     def strikethrough(strikethrough=true) end

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

@@ -7,8 +7,6 @@
 module Wx
 
   # This class holds a variety of information related to font dialogs.
-  # === 
-  # 
   # Category:  Common Dialogs, Data Structures
   # @see wxFontDialog Overview
   # @see  Wx::Font
@@ -17,6 +15,7 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FONTDLG
   class FontData < Object
   
     # Constructor.
@@ -56,7 +55,7 @@ module Wx
     def get_enable_effects; end
     
     # Returns the state of the flags restricting the selection.
-    # Note that currently these flags are only effectively used in wxMSW.
+    # Note that currently these flags are only effectively used in WXMSW.
     # 
     # - {Wx::FONTRESTRICT_NONE} If no restriction applies, or a combination of the following flags:
     # - {Wx::FONTRESTRICT_SCALABLE} To show only scalable fonts - no raster fonts.
@@ -79,7 +78,7 @@ module Wx
     alias_method :show_help, :get_show_help
     
     # Restricts the selection to a subset of the available fonts.
-    # Note that currently these flags are only effectively used in wxMSW and are ignored in the other ports.
+    # Note that currently these flags are only effectively used in WXMSW and are ignored in the other ports.
     # Possible values are:
     # 
     # - {Wx::FONTRESTRICT_NONE} No restriction, show all fonts in the dialog.

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

@@ -14,14 +14,13 @@ module Wx
   def self.get_font_from_user(parent, fontInit, caption=('')) end
   
   # This class represents the font chooser dialog.
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see wxFontDialog Overview
   # @see  Wx::FontData
   # @see  get_font_from_user 
   # 
   # 
+  # @wxrb_require USE_FONTDLG
   class FontDialog < Dialog
   
     # Returns the font data associated with the font dialog.

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

@@ -8,7 +8,7 @@ module Wx
 
   # This control allows the user to select a font.
   # The generic implementation is a button which brings up a {Wx::FontDialog} when clicked. Native implementation may differ but this is usually a (small) widget which give access to the font-chooser dialog. It is only available if {Wx::Setup::USE_FONTPICKERCTRL} is set to 1 (the default).
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -21,23 +21,22 @@ module Wx
   # 
   # - {Wx::FNTP_USEFONT_FOR_LABEL}: Uses the currently selected font to draw the label of the button. 
   # 
-  # === 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::FontPickerEvent} events.
   # Event handler methods for events emitted by this class:
   # 
   # - {Wx::EvtHandler#evt_fontpicker_changed}(id, meth = nil, &block): The user changed the font selected in the control either using the button or using text control (see {Wx::FNTP_USE_TEXTCTRL}; note that in this case the event is fired only if the user's input is valid, i.e. recognizable). 
   # 
-  # === 
-  # 
-  # Category:  Picker Controls  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  Picker 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::FontDialog
   # @see  Wx::FontPickerEvent 
   # 
   # 
+  # @wxrb_require USE_FONTDLG,USE_FONTPICKERCTRL
   class FontPickerCtrl < PickerBase
   
     # @overload initialize()

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

@@ -26,19 +26,18 @@ module Wx
   EVT_FONTPICKER_CHANGED = 10170
   
   # This event class is used for the events generated by {Wx::FontPickerCtrl}.
-  # === Events using this class
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::FontPickerEvent} events.
   # Event handler methods:
   # 
   # - {Wx::EvtHandler#evt_fontpicker_changed}(id, meth = nil, &block): Generated whenever the selected font changes. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # @see Wx::FontPickerCtrl 
   # 
   # 
+  # @wxrb_require USE_FONTDLG,USE_FONTPICKERCTRL
   class FontPickerEvent < CommandEvent
   
     # The constructor is not normally used by the user code.

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

@@ -19,9 +19,14 @@ module Wx
   # It usually has thick borders and a title bar, and can optionally contain a menu bar, toolbar and status bar. A frame can contain any window that is not a frame or dialog.
   # A frame that has a status bar and toolbar, created via the {Wx::Frame#create_status_bar} and {Wx::Frame#create_tool_bar} functions, manages these windows and adjusts the value returned by {Wx::Frame#get_client_size} to reflect the remaining size available to application windows.
   # If a frame is to be used as an input form, the controls should not be created as its children. Instead, a {Wx::Panel} should be created as the sole child of the frame, serving as the parent of the actual controls (the frame will size the panel so it always fills its client area). Doing this will ensure that tabbing between the controls works and the frame background has the expected colour. Moreover, as a frame is by default resizable, it could be better to use {Wx::ScrolledWindow} instead of {Wx::Panel}, to make sure the controls are easily accessible regardless of the frame size. However, please consider whether it would not be better to use {Wx::Dialog} instead of {Wx::Frame}, where using a panel like this is not needed and {Wx::Dialog} also offers other benefits such as creating specialized sizers (e.g., for buttons, with their platform-correct order).
-  # An application should normally define a {Wx::CloseEvent} handler for the frame to respond to system close events, for example so that related data and subwindows can be cleaned up.
   # 
-  # == Default event processing
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>An application should normally define a {Wx::CloseEvent} handler for the frame to respond to system close events, for example so that related data and subwindows can be cleaned up.
+  # </p>
+  # </div>>
+  # 
+  # ## Default event processing
   # 
   # {Wx::Frame} processes the following events:
   # 
@@ -29,7 +34,7 @@ module Wx
   # 
   # - {Wx::EVT_MENU_HIGHLIGHT}: the default implementation displays the help string associated with the selected item in the first pane of the status bar, if there is one.
   # 
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -45,7 +50,7 @@ module Wx
   # 
   # - {Wx::MAXIMIZE}: Displays the frame maximized. Windows and GTK+ only. 
   # 
-  # - {Wx::MAXIMIZE_BOX}: Displays a maximize box on the frame. Notice that under wxGTK {Wx::RESIZE_BORDER} must be used as well or this style is ignored. 
+  # - {Wx::MAXIMIZE_BOX}: Displays a maximize box on the frame. Notice that under WXGTK {Wx::RESIZE_BORDER} must be used as well or this style is ignored. 
   # 
   # - {Wx::CLOSE_BOX}: Displays a close box on the frame. 
   # 
@@ -57,7 +62,7 @@ module Wx
   # 
   # - {Wx::FRAME_TOOL_WINDOW}: Causes a frame with a small title bar to be created; the frame does not appear in the taskbar under Windows or GTK+. 
   # 
-  # - {Wx::FRAME_NO_TASKBAR}: Creates an otherwise normal frame but it does not appear in the taskbar under Windows or GTK+ (note that it will minimize to the desktop window under Windows which may seem strange to the users and thus it might be better to use this style only without {Wx::MINIMIZE_BOX} style). In wxGTK, the flag is respected only if the window manager supports _NET_WM_STATE_SKIP_TASKBAR hint. 
+  # - {Wx::FRAME_NO_TASKBAR}: Creates an otherwise normal frame but it does not appear in the taskbar under Windows or GTK+ (note that it will minimize to the desktop window under Windows which may seem strange to the users and thus it might be better to use this style only without {Wx::MINIMIZE_BOX} style). In WXGTK, the flag is respected only if the window manager supports _NET_WM_STATE_SKIP_TASKBAR hint. 
   # 
   # - {Wx::FRAME_FLOAT_ON_PARENT}: The frame will always be on top of its parent (unlike {Wx::STAY_ON_TOP}). A frame created with this style must have a non-NULL parent. 
   # 
@@ -71,7 +76,7 @@ module Wx
   # 
   # See also the Window Styles.
   # 
-  # === Extra Styles
+  # ### Extra Styles
   # 
   # This class supports the following extra styles:
   # 
@@ -79,7 +84,7 @@ module Wx
   # 
   # - {Wx::FRAME_EX_METAL}: On macOS, frames with this style will be shown with a metallic look. This is an extra style. 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # Event handler methods for events emitted by this class:
   # 
@@ -95,8 +100,6 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_menu_highlight_all}(meth = nil, &block): A menu item has been highlighted, i.e. the currently selected menu item has changed. See {Wx::MenuEvent}. 
   # 
-  # === 
-  # 
   # Category:  Managed Windows
   # @see Wx::MDIParentFrame
   # @see  Wx::MDIChildFrame
@@ -111,7 +114,11 @@ module Wx
     #   @return [Wx::Frame]
     # @overload initialize(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_FRAME_STYLE, name=Wx::FRAME_NAME_STR)
     #   Constructor, creating the window.
-    #   For Motif, MWM (the Motif Window Manager) should be running for any window styles to work (otherwise all styles take effect).
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>For Motif, MWM (the Motif Window Manager) should be running for any window styles to work (otherwise all styles take effect).
+    #   </p>
+    #   </div>>
     #   @see Wx::Frame#create 
     #   @param parent [Wx::Window]  The window parent. This may be, and often is, NULL. If it is non-NULL, the frame will be minimized when its parent is minimized and restored when it is restored (although it will still be possible to minimize and restore just this frame itself).
     #   @param id [Integer]  The window identifier. It may take a value of -1 to indicate a default value.
@@ -143,7 +150,11 @@ module Wx
     # Creates a status bar at the bottom of the frame.
     # A pointer to the status bar if it was created successfully, NULL otherwise.
     # 
-    # The width of the status bar is the whole width of the frame (adjusted automatically when resizing), and the height and text size are chosen by the host windowing system.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>The width of the status bar is the whole width of the frame (adjusted automatically when resizing), and the height and text size are chosen by the host windowing system.
+    # </p>
+    # </div>>
     # @see Wx::Frame#set_status_text
     # @see  Wx::Frame#on_create_status_bar
     # @see  Wx::Frame#get_status_bar 
@@ -157,7 +168,11 @@ module Wx
     # Creates a toolbar at the top or left of the frame.
     # A pointer to the toolbar if it was created successfully, NULL otherwise.
     # 
-    # By default, the toolbar is an instance of {Wx::ToolBar}. To use a different class, override {Wx::Frame#on_create_tool_bar}. When a toolbar has been created with this function, or made known to the frame with {Wx::Frame#set_tool_bar}, the frame will manage the toolbar position and adjust the return value from {Wx::Window#get_client_size} to reflect the available space for application windows. Under Pocket PC, you should always use this function for creating the toolbar to be managed by the frame, so that wxWidgets can use a combined menubar and toolbar. Where you manage your own toolbars, create a {Wx::ToolBar} as usual.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>By default, the toolbar is an instance of {Wx::ToolBar}. To use a different class, override {Wx::Frame#on_create_tool_bar}. When a toolbar has been created with this function, or made known to the frame with {Wx::Frame#set_tool_bar}, the frame will manage the toolbar position and adjust the return value from {Wx::Window#get_client_size} to reflect the available space for application windows. Under Pocket PC, you should always use this function for creating the toolbar to be managed by the frame, so that wxWidgets can use a combined menubar and toolbar. Where you manage your own toolbars, create a {Wx::ToolBar} as usual.
+    # </p>
+    # </div>>
     # @see Wx::Frame#create_status_bar
     # @see  Wx::Frame#on_create_tool_bar
     # @see  Wx::Frame#set_tool_bar
@@ -221,7 +236,11 @@ module Wx
     def process_command(id) end
     
     # Tells the frame to show the given menu bar.
-    # If the frame is destroyed, the menu bar and its menus will be destroyed also, so do not delete the menu bar explicitly (except by resetting the frame's menu bar to another frame or NULL). Under Windows, a size event is generated, so be sure to initialize data members properly before calling {Wx::Frame#set_menu_bar}. Note that on some platforms, it is not possible to call this function twice for the same frame object.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>If the frame is destroyed, the menu bar and its menus will be destroyed also, so do not delete the menu bar explicitly (except by resetting the frame's menu bar to another frame or NULL). Under Windows, a size event is generated, so be sure to initialize data members properly before calling {Wx::Frame#set_menu_bar}. Note that on some platforms, it is not possible to call this function twice for the same frame object.
+    # </p>
+    # </div>>
     # @see Wx::Frame#get_menu_bar
     # @see  Wx::MenuBar
     # @see  Wx::Menu. 
@@ -250,7 +269,11 @@ module Wx
     # Sets the status bar text and updates the status bar display.
     # This is a simple wrapper for {Wx::StatusBar#set_status_text} which doesn't do anything if the frame has no status bar, i.e. {Wx::Frame#get_status_bar} returns NULL.
     # 
-    # Use an empty string to clear the status bar.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use an empty string to clear the status bar.
+    # </p>
+    # </div>>
     # @see Wx::Frame#create_status_bar
     # @see  Wx::StatusBar 
     # @param text [String]  The text for the status field.
@@ -260,7 +283,11 @@ module Wx
     alias_method :status_text=, :set_status_text
     
     # Sets the widths of the fields in the status bar.
-    # The widths of the variable fields are calculated from the total width of all fields, minus the sum of widths of the non-variable fields, divided by the number of variable fields.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>The widths of the variable fields are calculated from the total width of all fields, minus the sum of widths of the non-variable fields, divided by the number of variable fields.
+    # </p>
+    # </div>>
     # @param widths_field [Array<Integer>]  Must contain an array of n integers, each of which is a status field width in pixels. A value of -1 indicates that the field is variable width; at least one field must be -1. You should delete this array after calling {Wx::Frame#set_status_widths}.
     # @return [void]
     def set_status_widths(widths_field) end
@@ -271,6 +298,20 @@ module Wx
     def set_tool_bar(toolBar) end
     alias_method :tool_bar=, :set_tool_bar
     
+    # MSW-specific function for accessing the taskbar button under Windows 7 or later.
+    # Returns a {Wx::TaskBarButton} pointer representing the taskbar button of the window under Windows 7 or later. The returned {Wx::TaskBarButton} may be used, if non-NULL, to access the functionality including thumbnail representations, thumbnail toolbars, notification and status overlays, and progress indicators.
+    # The returned pointer must not be deleted, it is owned by the frame and will be only deleted when the frame itself is destroyed.
+    # This function is not available in the other ports by design, any occurrences of it in the portable code must be guarded by 
+    # ```ruby
+    #   if Wx::PLATFORM == 'WXMSW'
+    #     #...
+    #   end
+    # ```
+    #  preprocessor guards.
+    # @return [Wx::TaskBarButton]
+    # @wxrb_require WXMSW,USE_TASKBARBUTTON
+    def msw_get_task_bar_button; end
+    
     # @param text [String] 
     # @param number [Integer] 
     # @return [void]

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

@@ -10,6 +10,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_FILESYSTEM
   class FileSystemOpenFlags < Wx::Enum
   
     # Open for reading.
@@ -24,6 +25,7 @@ module Wx
   
   # Parameter indicating how file offset should be interpreted.
   # 
+  # @wxrb_require USE_FILESYSTEM
   class SeekMode < Wx::Enum
   
     # Seek from the file beginning.
@@ -42,6 +44,7 @@ module Wx
   
   # IO stream error codes.
   # 
+  # @wxrb_require USE_FILESYSTEM
   class StreamError < Wx::Enum
   
     # No error occurred.
@@ -64,9 +67,12 @@ module Wx
   
   # This class represents a single file opened by {Wx::FileSystem}.
   # It provides more information than wxWidgets' input streams (stream, filename, mime type, anchor).
-  # Any pointer returned by a method of {Wx::FSFile} is valid only as long as the {Wx::FSFile} object exists. For example a call to {Wx::FSFile#get_stream} doesn't create the stream but only returns the pointer to it. In other words after 10 calls to {Wx::FSFile#get_stream} you will have obtained ten identical pointers.
   # 
-  # === 
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>Any pointer returned by a method of {Wx::FSFile} is valid only as long as the {Wx::FSFile} object exists. For example a call to {Wx::FSFile#get_stream} doesn't create the stream but only returns the pointer to it. In other words after 10 calls to {Wx::FSFile#get_stream} you will have obtained ten identical pointers.
+  # </p>
+  # </div>
   # 
   # Category:  Virtual File System, File Handling
   # @see Wx::FileSystemHandler
@@ -74,6 +80,7 @@ module Wx
   # @see  wxFileSystem Overview 
   # 
   # 
+  # @wxrb_require USE_FILESYSTEM
   class FSFile < Object
   
     # Constructor.
@@ -96,19 +103,19 @@ module Wx
     
     # Returns anchor (if present).
     # The term of <b>anchor</b> can be easily explained using few examples:
-    # index.htm#anchor                      // 'anchor' is anchor
+    # index.htm\#anchor                      // 'anchor' is anchor
     # index/{Wx::001}.htm                       // NO anchor here!
-    # archive/main.zip#zip:index.htm#global // 'global'
-    # archive/main.zip#zip:index.htm        // NO anchor here!
+    # archive/main.zip\#zip:index.htm\#global // 'global'
+    # archive/main.zip\#zip:index.htm        // NO anchor here!
     # 
-    # Usually an anchor is presented only if the MIME type is 'text/html'. But it may have some meaning with other files; for example myanim.avi#200 may refer to position in animation or reality.wrl::MyView may refer to a predefined view in VRML.
+    # Usually an anchor is presented only if the MIME type is 'text/html'. But it may have some meaning with other files; for example myanim.avi\#200 may refer to position in animation or reality.wrl::MyView may refer to a predefined view in VRML.
     # @return [Wx::String]
     def get_anchor; end
     alias_method :anchor, :get_anchor
     
     # Returns full location of the file, including path and protocol.
     # Examples: http://www.{Wx::widgets}.org
-    # http://www.ms.mff.cuni.cz/~vsla8348/{Wx::html}/archive.zip#zip:info.txt
+    # http://www.ms.mff.cuni.cz/~vsla8348/{Wx::html}/archive.zip\#zip:info.txt
     # file:/home/vasek/index.htm
     # relative-file.htm
     # @return [Wx::String]
@@ -136,7 +143,6 @@ module Wx
   
   # This class is the base class of most stream related classes in wxWidgets.
   # It must not be used directly.
-  # === 
   # 
   # Category:  {Wx::Streams}
   # @see Wx::StreamBuffer 
@@ -144,6 +150,7 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILESYSTEM
   class StreamBase < ::Object
   
     # Creates a dummy stream object.
@@ -193,12 +200,12 @@ module Wx
   # {Wx::InputStream} is an abstract base class which may not be used directly.
   # It is the base class of all streams which provide a {Wx::InputStream#read} function, i.e. which can be used to read data from a source (e.g. a file, a socket, etc).
   # If you want to create your own input stream, you'll need to derive from this class and implement the protected {Wx::InputStream#on_sys_read} function only.
-  # === 
   # 
   # Category:  {Wx::Streams}
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILESYSTEM
   class InputStream < StreamBase
   
     # Creates a dummy input stream.
@@ -259,12 +266,12 @@ module Wx
   # {Wx::OutputStream} is an abstract base class which may not be used directly.
   # It is the base class of all streams which provide a {Wx::OutputStream#write} function, i.e. which can be used to output data (e.g. to a file, to a socket, etc).
   # If you want to create your own output stream, you'll need to derive from this class and implement the protected {Wx::OutputStream#on_sys_write} function only.
-  # === 
   # 
   # Category:  {Wx::Streams}
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILESYSTEM
   class OutputStream < StreamBase
   
     # Creates a dummy {Wx::OutputStream} object.

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

@@ -26,7 +26,7 @@ module Wx
   # The first is the usual working mode (see {Wx::Gauge#set_value} and {Wx::Gauge#set_range}) while the second can be used when the program is doing some processing but you don't know how much progress is being done. In this case, you can periodically call the {Wx::Gauge#pulse} function to make the progress bar switch to indeterminate mode (graphically it's usually a set of blocks which move or bounce in the bar control).
   # {Wx::Gauge} supports dynamic switch between these two work modes.
   # There are no user commands for the gauge.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -40,16 +40,15 @@ module Wx
   # 
   # - {Wx::GA_PROGRESS}: Reflect the value of gauge in the application taskbar button under Windows 7 and later and the dock icon under macOS, ignored under the other platforms. This flag is only available in wxWidgets 3.1.0 and later. 
   # 
-  # === 
-  # 
-  # 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::Slider
   # @see  Wx::ScrollBar 
   # 
   # 
+  # @wxrb_require USE_GAUGE
   class Gauge < Control
   
     # @overload initialize()
@@ -103,13 +102,17 @@ module Wx
     alias_method :vertical?, :is_vertical
     
     # Switch the gauge to indeterminate mode (if required) and makes the gauge move a bit to indicate the user that some progress has been made.
-    # After calling this function the value returned by {Wx::Gauge#get_value} is undefined and thus you need to explicitly call {Wx::Gauge#set_value} if you want to restore the determinate mode.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>After calling this function the value returned by {Wx::Gauge#get_value} is undefined and thus you need to explicitly call {Wx::Gauge#set_value} if you want to restore the determinate mode. 
+    # </p>
+    # </div>
     # @return [void]
     def pulse; end
     
     # Sets the range (maximum value) of the gauge.
     # This function makes the gauge switch to determinate mode, if it's not already.
-    # When the gauge is in indeterminate mode, under wxMSW the gauge repeatedly goes from zero to range and back; under other ports when in indeterminate mode, the range setting is ignored.
+    # When the gauge is in indeterminate mode, under WXMSW the gauge repeatedly goes from zero to range and back; under other ports when in indeterminate mode, the range setting is ignored.
     # @see Wx::Gauge#get_range 
     # @param range [Integer] 
     # @return [void]

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

@@ -8,7 +8,6 @@ module Wx
 
   # The {Wx::GBSizerItem} class is used by the {Wx::GridBagSizer} for tracking the items in the sizer.
   # It adds grid position and spanning information to the normal {Wx::SizerItem} by adding {Wx::GBPosition} and {Wx::GBSpan} attributes. Most of the time you will not need to use a {Wx::GBSizerItem} directly in your code, but there are a couple of cases where it is handy.
-  # === 
   # 
   # Category:  Window Layout
   # 

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

@@ -15,8 +15,6 @@ module Wx
   # - Similarly, {Wx::RasterOperationMode} parameter of {Wx::GCDC#blit} and {Wx::GCDC#stretch_blit} can only be one of the supported logical functions listed above, using any other function will result in an assertion failure and not drawing anything.
   # - For Direct2D-based {Wx::GraphicsContext}, only true-type fonts can be used in the font-related functions.
   # 
-  # === 
-  # 
   # Category:  Device Contexts
   # @see Wx::DC
   # @see  Wx::GraphicsContext 
@@ -24,6 +22,7 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_GRAPHICS_CONTEXT
   class GCDC < DC
   
     # Retrieves associated {Wx::GraphicsContext}.