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

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

@@ -9,7 +9,6 @@ module Wx
   # A class that can handle events from the windowing system.
   # {Wx::Window} is (and therefore all window classes are) derived from this class.
   # When events are received, {Wx::EvtHandler} invokes the method listed in the event table using itself as the object. When using multiple inheritance <b>it is imperative that the {Wx::EvtHandler}(-derived) class is the first class inherited</b> such that the this pointer for the overall object will be identical to the this pointer of the {Wx::EvtHandler} portion.
-  # === 
   # 
   # Category:  {Wx::Events}
   # @see How Events are Processed
@@ -94,7 +93,11 @@ module Wx
     alias_method :previous_handler, :get_previous_handler
     
     # Enables or disables the event handler.
-    # You can use this function to avoid having to remove the event handler from the chain, for example when implementing a dialog editor and changing from edit to test mode.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>You can use this function to avoid having to remove the event handler from the chain, for example when implementing a dialog editor and changing from edit to test mode.
+    # </p>
+    # </div>>
     # @see Wx::EvtHandler#get_evt_handler_enabled 
     # @param enabled [Boolean]  true if the event handler is to be enabled, false if it is to be disabled.
     # @return [void]
@@ -102,11 +105,16 @@ module Wx
     alias_method :evt_handler_enabled=, :set_evt_handler_enabled
     
     # Sets the pointer to the next handler.
-    # See {Wx::EvtHandler#process_event} for more info about how the chains of event handlers are internally used. Also remember that {Wx::EvtHandler} uses double-linked lists and thus if you use this function, you should also call {Wx::EvtHandler#set_previous_handler} on the argument passed to this function: 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>See {Wx::EvtHandler#process_event} for more info about how the chains of event handlers are internally used. Also remember that {Wx::EvtHandler} uses double-linked lists and thus if you use this function, you should also call {Wx::EvtHandler#set_previous_handler} on the argument passed to this function: 
     # ```ruby
     #   handlerA.set_next_handler(handlerB)
     #   handlerB.set_previous_handler(handlerA)
     # ```
+    # 
+    # </p>
+    # </div>>
     # @see How Events are Processed 
     # @param handler [Wx::EvtHandler]  The event handler to be set as the next handler. Cannot be NULL.
     # @return [void]

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

@@ -11,12 +11,12 @@ module Wx
   # The map file contains two or three fields per line: numeric_id relative_URL [; comment/documentation]
   # The numeric_id is the id used to look up the entry in {Wx::ExtHelpController#display_section}/DisplayBlock(). The relative_URL is a filename of an html file, relative to the help directory. The optional comment/documentation field (after a ';') is used for keyword searches, so some meaningful text here does not hurt. If the documentation itself contains a ';', only the part before that will be displayed in the listbox, but all of it used for search.
   # Lines starting with ';' will be ignored.
-  # === 
   # 
   # Category:  {Wx::HELP}
   # @see Wx::HelpController 
   # 
   # 
+  # @wxrb_require USE_HELP
   class ExtHelpController < Object
   
     # @param parentWindow [Wx::Window] 

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

@@ -44,7 +44,7 @@ module Wx
   # This control allows the user to select a file.
   # Two implementations of this class exist, one for Gtk and another generic one for all the other ports.
   # This class is only available if {Wx::Setup::USE_FILECTRL} is set to 1.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -58,7 +58,7 @@ module Wx
   # 
   # - {Wx::FC_NOSHOWHIDDEN}: Hides the "Show Hidden Files" checkbox (Generic only) 
   # 
-  # === 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::FileCtrlEvent} events.
   # Event handler methods for events emitted by this class:
@@ -71,16 +71,15 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_filectrl_filterchanged}(id, meth = nil, &block): The current file filter of the file control has been changed. 
   # 
-  # === 
-  # 
-  # 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 port; a generic implementation is used elsewhere.
+  # Implementations:  native under WXGTK port; a generic implementation is used elsewhere.
   # @see Wx::GenericDirCtrl 
   # 
   # 
+  # @wxrb_require USE_FILECTRL
   class FileCtrl < Control
   
     # @overload initialize()
@@ -127,7 +126,12 @@ module Wx
     
     # Fills the array filenames with the filenames only of selected items.
     # This function should only be used with the controls having the {Wx::FC_MULTIPLE} style, use {Wx::FileCtrl#get_filename} for the others.
-    # filenames is emptied first.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>filenames is emptied first. 
+    # </p>
+    # </div>>
     # @return [Array<String>]
     def get_filenames; end
     alias_method :filenames, :get_filenames
@@ -145,7 +149,12 @@ module Wx
     
     # Fills the array paths with the full paths of the files chosen.
     # This function should be used with the controls having the {Wx::FC_MULTIPLE} style, use {Wx::FileCtrl#get_path} otherwise.
-    # paths is emptied first.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>paths is emptied first. 
+    # </p>
+    # </div>>
     # @return [Array<String>]
     def get_paths; end
     alias_method :paths, :get_paths

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

@@ -7,7 +7,7 @@
 module Wx
 
   # A file control event holds information about events associated with {Wx::FileCtrl} objects.
-  # === Events using this class
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::FileCtrlEvent} events.
   # Event handler methods:
@@ -20,14 +20,13 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_filectrl_filterchanged}(id, meth = nil, &block): The current file filter of the file control has been changed 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # 
+  # @wxrb_require USE_FILECTRL
   class FileCtrlEvent < CommandEvent
   
     # Constructor.
-    # @param type [Wx::CommandLinkButton::EventType] 
+    # @param type [Wx::Slider::EventType] 
     # @param evtObject [Wx::Object] 
     # @param id [Integer] 
     # @return [Wx::FileCtrlEvent]

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

@@ -106,7 +106,7 @@ module Wx
   # end
   # ```
   # 
-  # == Wildcard Filters
+  # ## Wildcard Filters
   # 
   # All implementations of the {Wx::FileDialog} provide a wildcard filter. Typing a filename containing wildcards (*, ?) in the filename text item, and clicking on Ok, will result in only those files matching the pattern being displayed. The wildcard may be a specification for multiple types of file with a description for each, such as: 
   # ```
@@ -119,14 +119,19 @@ module Wx
   # ```
   #  But in contrast to Windows and Unix, where the file type choice filters only the selected files, on Mac macOS even in this case the dialog shows all files matching all file types. The files which does not match the currently selected file type are greyed out and are not selectable.
   # 
-  # == Dialog Customization
+  # ## Dialog Customization
   # 
   # Uniquely among the other standard dialogs, {Wx::FileDialog} can be customized by adding extra controls to it. Moreover, there are two ways to do it: the first one is to define a callback function and use {Wx::FileDialog#set_extra_control_creator} to tell the dialog to call it, while the second one requires defining a class inheriting from {Wx::FileDialogCustomizeHook} and implementing its virtual functions, notably {Wx::FileDialogCustomizeHook#add_custom_controls} where the extra controls have to be created, and finally calling {Wx::FileDialog#set_customize_hook} with this custom hook object.
-  # The first approach is somewhat simpler and more flexible, as it allows to create any kind of custom controls, but is not supported by the "new style" (where "new" means used since Windows Vista, i.e. circa 2007) file dialogs under MSW. Because of this, calling {Wx::FileDialog#set_extra_control_creator} in wxMSW forces the use of old style (Windows XP) dialogs, that may look out of place. The second approach is implemented by the MSW dialogs natively and doesn't suffer from this limitation, so its use is recommended, especially if the few simple control types supported by it (see {Wx::FileDialogCustomize} for more information about the supported controls) are sufficient for your needs.
+  # The first approach is somewhat simpler and more flexible, as it allows to create any kind of custom controls, but is not supported by the "new style" (where "new" means used since Windows Vista, i.e. circa 2007) file dialogs under MSW. Because of this, calling {Wx::FileDialog#set_extra_control_creator} in WXMSW forces the use of old style (Windows XP) dialogs, that may look out of place. The second approach is implemented by the MSW dialogs natively and doesn't suffer from this limitation, so its use is recommended, especially if the few simple control types supported by it (see {Wx::FileDialogCustomize} for more information about the supported controls) are sufficient for your needs.
   # Both of the approaches to the dialog customization are demonstrated in the Dialogs Sample, please check it for more details.
-  # New style file dialogs can only be used in wxMSW when the apartment, COM threading model is used. This is the case by default, but if the application initializes COM on its own using multi-threaded model, old style dialogs are used, at least when they must have a parent, as the new style dialog doesn't support this threading model.
   # 
-  # === Styles
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>New style file dialogs can only be used in WXMSW when the apartment, COM threading model is used. This is the case by default, but if the application initializes COM on its own using multi-threaded model, old style dialogs are used, at least when they must have a parent, as the new style dialog doesn't support this threading model.
+  # </p>
+  # </div>
+  # 
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -136,9 +141,9 @@ module Wx
   # 
   # - {Wx::FD_SAVE}: This is a save dialog; usually this means that the default button's label of the dialog is "Save". Cannot be combined with {Wx::FD_OPEN}. 
   # 
-  # - {Wx::FD_OVERWRITE_PROMPT}: For save dialog only: prompt for a confirmation if a file will be overwritten. This style is always enabled on wxOSX and cannot be disabled. 
+  # - {Wx::FD_OVERWRITE_PROMPT}: For save dialog only: prompt for a confirmation if a file will be overwritten. This style is always enabled on WXOSX and cannot be disabled. 
   # 
-  # - {Wx::FD_NO_FOLLOW}: Directs the dialog to return the path and file name of the selected shortcut file, not its target as it does by default. Currently this flag is only implemented in wxMSW and wxOSX (where it prevents aliases from being resolved). The non-dereferenced link path is always returned, even without this flag, under Unix and so using it there doesn't do anything. This flag was added in wxWidgets 3.1.0. 
+  # - {Wx::FD_NO_FOLLOW}: Directs the dialog to return the path and file name of the selected shortcut file, not its target as it does by default. Currently this flag is only implemented in WXMSW and WXOSX (where it prevents aliases from being resolved). The non-dereferenced link path is always returned, even without this flag, under Unix and so using it there doesn't do anything. This flag was added in wxWidgets 3.1.0. 
   # 
   # - {Wx::FD_FILE_MUST_EXIST}: For open dialog only: the user may only select files that actually exist. Notice that under macOS the file dialog with {Wx::FD_OPEN} style always behaves as if this style was specified, because it is impossible to choose a file that doesn't exist from a standard macOS file dialog. 
   # 
@@ -146,17 +151,16 @@ module Wx
   # 
   # - {Wx::FD_CHANGE_DIR}: Change the current working directory (when the dialog is dismissed) to the directory where the file(s) chosen by the user are. 
   # 
-  # - {Wx::FD_PREVIEW}: Show the preview of the selected files (currently only supported by wxGTK). 
+  # - {Wx::FD_PREVIEW}: Show the preview of the selected files (currently only supported by WXGTK). 
   # 
   # - {Wx::FD_SHOW_HIDDEN}: Show hidden files. This flag was added in wxWidgets 3.1.3 
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see wxFileDialog Overview
   # @see  file_selector 
   # 
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialog < Dialog
   
     # Constructor.
@@ -209,7 +213,11 @@ module Wx
     alias_method :extra_control, :get_extra_control
     
     # Returns the default filename.
-    # This function can't be used with dialogs which have the {Wx::FD_MULTIPLE} style, use {Wx::FileDialog#get_filenames} instead.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function can't be used with dialogs which have the {Wx::FD_MULTIPLE} style, use {Wx::FileDialog#get_filenames} instead. 
+    # </p>
+    # </div>
     # @return [String]
     def get_filename; end
     alias_method :filename, :get_filename
@@ -234,7 +242,11 @@ module Wx
     alias_method :message, :get_message
     
     # Returns the full path (directory and filename) of the selected file.
-    # This function can't be used with dialogs which have the {Wx::FD_MULTIPLE} style, use {Wx::FileDialog#get_paths} instead.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function can't be used with dialogs which have the {Wx::FD_MULTIPLE} style, use {Wx::FileDialog#get_paths} instead. 
+    # </p>
+    # </div>
     # @return [String]
     def get_path; end
     alias_method :path, :get_path
@@ -252,7 +264,12 @@ module Wx
     
     # Set the hook to be used for customizing the dialog contents.
     # This function can be called before calling {Wx::FileDialog#show_modal} to specify that the dialog contents should be customized using the provided hook. See {Wx::FileDialogCustomizeHook} documentation and Dialogs Sample for the examples of using it.
-    # In order to define a custom hook object, <code>Wx::/filedlgcustomize.h</code> must be included in addition to the usual <code>Wx::/filedlg.h</code> header.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>In order to define a custom hook object, <code>Wx::/filedlgcustomize.h</code> must be included in addition to the usual <code>Wx::/filedlg.h</code> header.
+    # </p>
+    # </div>
     # 
     # true if the hook was successfully set or false if customizing the file dialog is not supported by the current platform.
     # @param customizeHook [Wx::FileDialogCustomizeHook]  The hook object that will be used by the dialog. This object must remain valid at least until {Wx::FileDialog#show_modal} returns.
@@ -267,7 +284,7 @@ module Wx
     alias_method :directory=, :set_directory
     
     # Sets the default filename.
-    # In wxGTK this will have little effect unless a default directory has previously been set.
+    # In WXGTK this will have little effect unless a default directory has previously been set.
     # @param setfilename [String] 
     # @return [void]
     def set_filename(setfilename) end

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

@@ -11,6 +11,7 @@ module Wx
   # Also, similarly to the normal windows, objects of this and derived classes belong to wxWidgets and must not be deleted by the application code.
   # Unlike windows, custom controls cannot be created directly, but can only be returned from {Wx::FileDialogCustomize} functions that are specifically provided for creating them.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogCustomControl < EvtHandler
   
     # Show or hide this control.
@@ -40,6 +41,7 @@ module Wx
   # It is possible to bind to {Wx::EVT_BUTTON} events on this object, which will be generated when the button is clicked.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogButton < FileDialogCustomControl
   
   end # FileDialogButton
@@ -49,6 +51,7 @@ module Wx
   # It is possible to bind to {Wx::EVT_CHECKBOX} events on this object, which will be generated when the checkbox is clicked.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogCheckBox < FileDialogCustomControl
   
     # Return true if the checkbox is checked.
@@ -69,6 +72,7 @@ module Wx
   # It is possible to bind to {Wx::EVT_RADIOBUTTON} events on this object, which will be generated when the radio button is selected.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogRadioButton < FileDialogCustomControl
   
     # Return true if the radio button is selected.
@@ -90,6 +94,7 @@ module Wx
   # It is possible to bind to {Wx::EVT_CHOICE} events on this object, which will be generated when the selection in the combobox changes.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogChoice < FileDialogCustomControl
   
     # Return the index of the selected item, possibly {Wx::NOT_FOUND}.
@@ -111,6 +116,7 @@ module Wx
   # Objects of this class don't generate any events currently.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogTextCtrl < FileDialogCustomControl
   
     # Get the current value entered into the control.
@@ -131,6 +137,7 @@ module Wx
   # Objects of this class don't generate any events.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogStaticText < FileDialogCustomControl
   
     # Set the text shown in the label.

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

@@ -72,14 +72,13 @@ module Wx
   #   }
   # ```
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see Wx::FileDialog
   # 
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILEDLG
   class FileDialogCustomizeHook < ::Object
   
     # Must be overridden to add custom controls to the dialog using the provided customizer object.
@@ -108,12 +107,12 @@ module Wx
   # Used with {Wx::FileDialogCustomizeHook} to add custom controls to {Wx::FileDialog}.
   # An object of this class is passed to {Wx::FileDialogCustomizeHook#add_custom_controls} to allow it to actually add controls to the dialog.
   # The pointers returned by the functions of this class belong to wxWidgets and should not be deleted by the application, just as {Wx::Window}-derived objects (even if these controls do not inherit from {Wx::Window}). These pointers become invalid when {Wx::FileDialog#show_modal} returns, and the dialog containing them is destroyed, and the latest point at which they can be still used is when {Wx::FileDialogCustomizeHook#transfer_data_from_custom_controls} is called.
-  # === 
   # 
   # Category:  Common Dialogs
   # @see Wx::FileDialog
   # 
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogCustomize < ::Object
   
     # Add a button with the specified label.

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

@@ -54,7 +54,7 @@ module Wx
   EVT_DIRPICKER_CHANGED = 10172
   
   # This event class is used for the events generated by {Wx::FilePickerCtrl} and by {Wx::DirPickerCtrl}.
-  # === Events using this class
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::FileDirPickerEvent} events.
   # Event handler methods:
@@ -63,20 +63,19 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_dirpicker_changed}(id, meth = nil, &block): Generated whenever the selected directory changes. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # @see Wx::FilePickerCtrl
   # @see  Wx::DirPickerCtrl 
   # 
   # 
+  # @wxrb_require USE_DIRDLG&USE_DIRPICKERCTRL|USE_FILEDLG&USE_FILEPICKERCTRL
   class FileDirPickerEvent < CommandEvent
   
     # @overload initialize()
     #   @return [Wx::FileDirPickerEvent]
     # @overload initialize(type, generator, id, path)
     #   The constructor is not normally used by the user code.
-    #   @param type [Wx::CommandLinkButton::EventType] 
+    #   @param type [Wx::Slider::EventType] 
     #   @param generator [Wx::Object] 
     #   @param id [Integer] 
     #   @param path [String] 

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

@@ -8,11 +8,11 @@ module Wx
 
   # This control allows the user to select a file.
   # The generic implementation is a button which brings up a {Wx::FileDialog} when clicked. Native implementation may differ but this is usually a (small) widget which give access to the file-chooser dialog. It is only available if {Wx::Setup::USE_FILEPICKERCTRL} is set to 1 (the default).
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
-  # - {Wx::FLP_DEFAULT_STYLE}: The default style: includes {Wx::FLP_OPEN} | {Wx::FLP_FILE_MUST_EXIST} and, under wxMSW and wxOSX, {Wx::FLP_USE_TEXTCTRL}. 
+  # - {Wx::FLP_DEFAULT_STYLE}: The default style: includes {Wx::FLP_OPEN} | {Wx::FLP_FILE_MUST_EXIST} and, under WXMSW and WXOSX, {Wx::FLP_USE_TEXTCTRL}. 
   # 
   # - {Wx::FLP_USE_TEXTCTRL}: Creates a text control to the left of the picker button which is completely managed by the {Wx::FilePickerCtrl} and which can be used by the user to specify a path (see SetPath). The text control is automatically synchronized with button's value. Use functions defined in {Wx::PickerBase} to modify the text control. 
   # 
@@ -28,23 +28,22 @@ module Wx
   # 
   # - {Wx::FLP_SMALL}: Use smaller version of the control with a small "..." button instead of the normal "Browse" one. This flag is new since wxWidgets 2.9.3. 
   # 
-  # === 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::FileDirPickerEvent} events.
   # Event handler methods for events emitted by this class:
   # 
   # - {Wx::EvtHandler#evt_filepicker_changed}(id, meth = nil, &block): The user changed the file selected in the control either using the button or using text control (see {Wx::FLP_USE_TEXTCTRL}; note that in this case the event is fired only if the user's input is valid, e.g. an existing file path if {Wx::FLP_FILE_MUST_EXIST} was given). 
   # 
-  # === 
-  # 
-  # 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::FileDialog
   # @see  Wx::FileDirPickerEvent 
   # 
   # 
+  # @wxrb_require USE_FILEDLG,USE_FILEPICKERCTRL
   class FilePickerCtrl < PickerBase
   
     # @overload initialize()
@@ -103,7 +102,7 @@ module Wx
     alias_method :initial_directory=, :set_initial_directory
     
     # Sets the absolute path of the currently selected file.
-    # If the control uses {Wx::FLP_FILE_MUST_EXIST} and does not use {Wx::FLP_USE_TEXTCTRL} style, the filename must be a name of an existing file and will be simply ignored by the native wxGTK implementation if this is not the case (the generic implementation used under the other platforms accepts even invalid file names currently, but this is subject to change in the future, don't rely on being able to use non-existent paths with it).
+    # If the control uses {Wx::FLP_FILE_MUST_EXIST} and does not use {Wx::FLP_USE_TEXTCTRL} style, the filename must be a name of an existing file and will be simply ignored by the native WXGTK implementation if this is not the case (the generic implementation used under the other platforms accepts even invalid file names currently, but this is subject to change in the future, don't rely on being able to use non-existent paths with it).
     # @param filename [String] 
     # @return [void]
     def set_path(filename) end

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

@@ -9,7 +9,6 @@ module Wx
   # This class provides an interface for opening files on different file systems.
   # It can handle absolute and/or local filenames.
   # It uses a system of handlers (see {Wx::FileSystemHandler}) to provide access to user-defined virtual file systems.
-  # === 
   # 
   # Category:  Virtual File System
   # @see Wx::FileSystemHandler
@@ -19,6 +18,7 @@ module Wx
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILESYSTEM
   class FileSystem < Object
   
     # Constructor.
@@ -58,11 +58,18 @@ module Wx
   # Please have a look at overview (see {Wx::FileSystem}) if you don't know how locations are constructed.
   # Also consult the list of available handlers.
   # Note that the handlers are shared by all instances of {Wx::FileSystem}.
-  # {Wx::HTML} library provides handlers for local files and HTTP or FTP protocol.
   # 
-  # The location parameter passed to {Wx::FileSystemHandler#open_file} or {Wx::FileSystemHandler#can_open} methods is always an absolute path. You don't need to check the FS's current path.
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>{Wx::HTML} library provides handlers for local files and HTTP or FTP protocol.
+  # </p>
+  # </div>>
   # 
-  # === 
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>The location parameter passed to {Wx::FileSystemHandler#open_file} or {Wx::FileSystemHandler#can_open} methods is always an absolute path. You don't need to check the FS's current path.
+  # </p>
+  # </div>
   # 
   # Category:  Virtual File System
   # @see Wx::FileSystem
@@ -70,6 +77,7 @@ module Wx
   # @see  wxFileSystem Overview 
   # 
   # 
+  # @wxrb_require USE_FILESYSTEM
   class FileSystemHandler < Object
   
     # Constructor.
@@ -127,6 +135,7 @@ module Wx
   # A file system handler for accessing files inside of archives.
   # 
   # 
+  # @wxrb_require USE_FILESYSTEM
   class ArchiveFSHandler < FileSystemHandler
   
     # @return [Wx::ArchiveFSHandler]
@@ -143,9 +152,9 @@ module Wx
   # Example:
   # 
   # ```
-  #   #ifndef __WXMSW__
-  #   #include "logo.xpm"
-  #   #endif
+  #   \#ifndef __WXMSW__
+  #   \#include "logo.xpm"
+  #   \#endif
   #   
   #   void MyFrame::OnAbout(wxCommandEvent&)
   #   {
@@ -158,12 +167,12 @@ module Wx
   #       wxDialog dlg(this, -1, wxString(_("About")));
   #       wxBoxSizer *topsizer;
   #       topsizer = new wxBoxSizer(wxVERTICAL);
-  #   #ifdef USE_WEBVIEW
+  #   \#ifdef USE_WEBVIEW
   #       wxWebView* browser = wxWebView::New(&dlg, wxID_ANY, wxWebViewDefaultURLStr,
   #                                wxDefaultPosition, wxSize(380, 160));
   #       browser->RegisterHandler(wxSharedPtr<wxWebViewHandler>(new wxWebViewFSHandler("memory")));
   #       browser->LoadURL("memory:about.htm");
-  #   #else // Use wxHtml
+  #   \#else // Use wxHtml
   #       wxHtmlWindow *browser;
   #       browser = new wxHtmlWindow(&dlg, -1, wxDefaultPosition,
   #                                  wxSize(380, 160), wxHW_SCROLLBAR_NEVER);
@@ -171,7 +180,7 @@ module Wx
   #       browser->LoadPage("memory:about.htm");
   #       browser->SetSize(browser->GetInternalRepresentation()->GetWidth(),
   #                   browser->GetInternalRepresentation()->GetHeight());
-  #   #endif
+  #   \#endif
   #       topsizer->Add(browser, 1, wxALL, 10);
   #       topsizer->Add(new wxStaticLine(&dlg, -1), 0, wxEXPAND | wxLEFT | wxRIGHT, 10);
   #       topsizer->Add(new wxButton(&dlg, wxID_OK, "Ok"),
@@ -187,19 +196,23 @@ module Wx
   #   }
   # ```
   # 
-  # === 
-  # 
   # Category:  Virtual File System
   # @see Wx::MemoryFSHandler.add_file_with_mime_type 
   # 
   # 
+  # @wxrb_require USE_FILESYSTEM
   class MemoryFSHandler < FileSystemHandler
   
     # @overload self.add_file(filename, image, type)
     #   Adds a file to the list of the files stored in memory.
     #   Stored data (bitmap, text or raw data) will be copied into private memory stream and available under name <code>"memory:"</code> + filename.
     #   When using the overload taking {Wx::String} data, if the string contains only Latin-1 characters (which includes strings created using Wx::String#from8bit_data), its data is used as is. Otherwise, the UTF-8 representation of the string is stored as the data associated with the given filename.
-    #   you must use a type value (aka image format) that wxWidgets can save (e.g. JPG, PNG, see {Wx::Image} documentation)!
+    #   
+    #   <div class="wxrb-note">
+    #   <b>Note:</b>
+    #   <p>you must use a type value (aka image format) that wxWidgets can save (e.g. JPG, PNG, see {Wx::Image} documentation)!
+    #   </p>
+    #   </div>
     #   @see Wx::MemoryFSHandler.add_file_with_mime_type 
     #   @param filename [String] 
     #   @param image [Wx::Image] 
@@ -209,7 +222,12 @@ module Wx
     #   Adds a file to the list of the files stored in memory.
     #   Stored data (bitmap, text or raw data) will be copied into private memory stream and available under name <code>"memory:"</code> + filename.
     #   When using the overload taking {Wx::String} data, if the string contains only Latin-1 characters (which includes strings created using Wx::String#from8bit_data), its data is used as is. Otherwise, the UTF-8 representation of the string is stored as the data associated with the given filename.
-    #   you must use a type value (aka image format) that wxWidgets can save (e.g. JPG, PNG, see {Wx::Image} documentation)!
+    #   
+    #   <div class="wxrb-note">
+    #   <b>Note:</b>
+    #   <p>you must use a type value (aka image format) that wxWidgets can save (e.g. JPG, PNG, see {Wx::Image} documentation)!
+    #   </p>
+    #   </div>
     #   @see Wx::MemoryFSHandler.add_file_with_mime_type 
     #   @param filename [String] 
     #   @param bitmap [Wx::Bitmap] 
@@ -219,7 +237,12 @@ module Wx
     #   Adds a file to the list of the files stored in memory.
     #   Stored data (bitmap, text or raw data) will be copied into private memory stream and available under name <code>"memory:"</code> + filename.
     #   When using the overload taking {Wx::String} data, if the string contains only Latin-1 characters (which includes strings created using Wx::String#from8bit_data), its data is used as is. Otherwise, the UTF-8 representation of the string is stored as the data associated with the given filename.
-    #   you must use a type value (aka image format) that wxWidgets can save (e.g. JPG, PNG, see {Wx::Image} documentation)!
+    #   
+    #   <div class="wxrb-note">
+    #   <b>Note:</b>
+    #   <p>you must use a type value (aka image format) that wxWidgets can save (e.g. JPG, PNG, see {Wx::Image} documentation)!
+    #   </p>
+    #   </div>
     #   @see Wx::MemoryFSHandler.add_file_with_mime_type 
     #   @param filename [String] 
     #   @param textdata [String] 

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

@@ -10,6 +10,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_FINDREPLDLG
   class FindReplaceFlags < Wx::Enum
   
     # downward search/replace selected (otherwise - upwards)
@@ -30,6 +31,7 @@ module Wx
   # 
   # 
   # 
+  # @wxrb_require USE_FINDREPLDLG
   class FindReplaceDialogStyles < Wx::Enum
   
     # replace dialog (otherwise find dialog)
@@ -71,7 +73,7 @@ module Wx
   EVT_FIND_CLOSE = 10181
   
   # {Wx::FindReplaceDialog} events.
-  # === Events using this class
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::FindDialogEvent} events.
   # Event handler methods:
@@ -86,14 +88,13 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_find_close}(id, meth = nil, &block): The dialog is being destroyed, any pointers to it cannot be used any longer. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # 
+  # @wxrb_require USE_FINDREPLDLG
   class FindDialogEvent < CommandEvent
   
     # Constructor used by wxWidgets only.
-    # @param commandType [Wx::CommandLinkButton::EventType] 
+    # @param commandType [Wx::Slider::EventType] 
     # @param id [Integer] 
     # @return [Wx::FindDialogEvent]
     def initialize(commandType=Wx::EVT_NULL, id=0) end

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

@@ -9,10 +9,10 @@ module Wx
   # {Wx::FindReplaceData} holds the data for {Wx::FindReplaceDialog}.
   # It is used to initialize the dialog with the default values and will keep the last values from the dialog when it is closed. It is also updated each time a {Wx::FindDialogEvent} is generated so instead of using the {Wx::FindDialogEvent} methods you can also directly query this object.
   # Note that all <code>SetXXX()</code> methods may only be called before showing the dialog and calling them has no effect later.
-  # === 
   # 
   # Category:  Common Dialogs, Data Structures
   # 
+  # @wxrb_require USE_FINDREPLDLG
   class FindReplaceData < Object
   
     # Constructor initializes the flags to default value (0).

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

@@ -9,10 +9,10 @@ module Wx
   # {Wx::FindReplaceDialog} is a standard modeless dialog which is used to allow the user to search for some text (and possibly replace it with something else).
   # The actual searching is supposed to be done in the owner window which is the parent of this dialog. Note that it means that unlike for the other standard dialogs this one <b>must</b> have a parent window. Also note that there is no way to use this dialog in a modal way; it is always, by design and implementation, modeless.
   # Please see the Dialogs Sample sample for an example of using it.
-  # === 
   # 
   # Category:  Common Dialogs
   # 
+  # @wxrb_require USE_FINDREPLDLG
   class FindReplaceDialog < Dialog
   
     # After using default constructor {Wx::FindReplaceDialog#create} must be called.

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

@@ -8,7 +8,6 @@ module Wx
 
   # A flex grid sizer is a sizer which lays out its children in a two-dimensional table with all table fields in one row having the same height and all fields in one column having the same width, but all rows or all columns are not necessarily the same height or width as in the {Wx::GridSizer}.
   # Since wxWidgets 2.5.0, {Wx::FlexGridSizer} can also size items equally in one direction but unequally ("flexibly") in the other. If the sizer is only flexible in one direction (this can be changed using {Wx::FlexGridSizer#set_flexible_direction}), it needs to be decided how the sizer should grow in the other ("non-flexible") direction in order to fill the available space. The {Wx::FlexGridSizer#set_non_flexible_grow_mode} method serves this purpose.
-  # === 
   # 
   # Category:  Window Layout
   # @see Wx::Sizer