wxruby3 0.9.1-x64-mingw-ucrt → 0.9.3-x64-mingw-ucrt

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

@@ -7,9 +7,10 @@
 module Wx
 
   # A menu item represents an item in a menu.
+  # 
   # Note that you usually don't have to deal with it directly as {Wx::Menu} methods usually construct an object of this class for you.
   # Also please note that the methods related to fonts and bitmaps are currently only implemented for Windows, Mac and GTK+.
-  # === 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::MenuEvent} events.
   # Event handler methods for events emitted by this class:
@@ -26,28 +27,31 @@ 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. This type of event is sent as {Wx::MenuEvent}. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Menus}
   # @see Wx::MenuBar
   # @see  Wx::Menu 
   # 
   # 
+  # @wxrb_require USE_MENUS
   class MenuItem < Object
   
     # Returns the background colour associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @return [Wx::Colour]
+    # @wxrb_require WXMSW
     def get_background_colour; end
     alias_method :background_colour, :get_background_colour
     
     # Returns the item bitmap.
+    # 
     # This method exists only for compatibility, please use {Wx::MenuItem#get_bitmap_bundle} in the new code.
     # @return [Wx::Bitmap]
     def get_bitmap; end
     alias_method :bitmap, :get_bitmap
     
     # Returns the bitmap bundle containing the bitmap used for this item.
+    # 
     # The returned bundle is invalid, i.e. empty, if no bitmap is associated with the item.
     # @see Wx::MenuItem#set_bitmap
     # @return [Wx::BitmapBundle]
@@ -55,14 +59,18 @@ module Wx
     alias_method :bitmap_bundle, :get_bitmap_bundle
     
     # Returns the bitmap used for disabled items.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @return [Wx::Bitmap]
+    # @wxrb_require WXMSW
     def get_disabled_bitmap; end
     alias_method :disabled_bitmap, :get_disabled_bitmap
     
     # Returns the font associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @return [Wx::Font]
+    # @wxrb_require WXMSW
     def get_font; end
     alias_method :font, :get_font
     
@@ -78,6 +86,7 @@ module Wx
     
     # Returns the text associated with the menu item including any accelerator characters that were passed to the constructor or {Wx::MenuItem#set_item_label}.
     # 
+    # 
     # @see Wx::MenuItem#get_item_label_text
     # @see  Wx::MenuItem.get_label_text 
     # @return [String]
@@ -86,6 +95,7 @@ module Wx
     
     # Returns the text associated with the menu item, without any accelerator characters.
     # 
+    # 
     # @see Wx::MenuItem#get_item_label
     # @see  Wx::MenuItem.get_label_text 
     # @return [String]
@@ -98,8 +108,10 @@ module Wx
     alias_method :kind, :get_kind
     
     # Gets the width of the menu item checkmark bitmap.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @return [Integer]
+    # @wxrb_require WXMSW
     def get_margin_width; end
     alias_method :margin_width, :get_margin_width
     
@@ -114,23 +126,28 @@ module Wx
     alias_method :sub_menu, :get_sub_menu
     
     # Returns the text colour associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @return [Wx::Colour]
+    # @wxrb_require WXMSW
     def get_text_colour; end
     alias_method :text_colour, :get_text_colour
     
     # Get our accelerator or NULL (caller must delete the pointer)
     # @return [Wx::AcceleratorEntry]
+    # @wxrb_require USE_ACCEL
     def get_accel; end
     alias_method :accel, :get_accel
     
     # Returns true if the item is a check item.
+    # 
     # Unlike {Wx::MenuItem#is_checkable} this doesn't return true for the radio buttons.
     # @return [Boolean]
     def is_check; end
     alias_method :check?, :is_check
     
     # Returns true if the item is checkable.
+    # 
     # Notice that the radio buttons are considered to be checkable as well, so this method returns true for them too. Use {Wx::MenuItem#is_check} if you want to test for the check items only.
     # @return [Boolean]
     def is_checkable; end
@@ -162,48 +179,59 @@ module Wx
     alias_method :sub_menu?, :is_sub_menu
     
     # Sets the background colour associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @param colour [Wx::Colour,String,Symbol] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_background_colour(colour) end
     alias_method :background_colour=, :set_background_colour
     
     # @overload set_bitmap(bmp)
     #   Sets the bitmap for the menu item.
+    #   
     #   Notice that GTK+ uses a global setting called <code>gtk-menu-images</code> to determine if the images should be shown in the menus 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.
     #   @param bmp [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     #   @return [void]
     # @overload set_bitmap(bmp, checked)
     #   Sets the checked or unchecked bitmap for the menu item.
+    #   
     #   It is equivalent to {Wx::MenuItem#set_bitmaps(bmp,wxNullBitmap)} if checked is true or SetBitmaps({Wx::NULL_BITMAP}, bmp) otherwise.
     #   Note that different bitmaps for checked and unchecked item states are not supported in most ports, while setting just a single bitmap using the overload above is supported in all of them.
-    #   Availability:  only available for the wxMSW port.  {Wx::msw}
+    #   Availability:  only available for the WXMSW port.
     #   @param bmp [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     #   @param checked [Boolean] 
     #   @return [void]
+    #   @wxrb_require WXMSW
     def set_bitmap(*args) end
     alias_method :bitmap=, :set_bitmap
     
     # Sets the checked/unchecked bitmaps for the menu item.
+    # 
     # The first bitmap is also used as the single bitmap for uncheckable menu items.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # Availability:  only available for the WXMSW port.
     # @param checked [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     # @param unchecked [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_bitmaps(checked, unchecked=Wx::NULL_BITMAP) end
     alias_method :bitmaps=, :set_bitmaps
     
     # Sets the to be used for disabled menu items.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @param disabled [Wx::BitmapBundle,Wx::Bitmap,Wx::Icon,Wx::Image] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_disabled_bitmap(disabled) end
     alias_method :disabled_bitmap=, :set_disabled_bitmap
     
     # Sets the font associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @param font [Wx::Font,Wx::FontInfo] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_font(font) end
     alias_method :font=, :set_font
     
@@ -214,6 +242,7 @@ module Wx
     alias_method :help=, :set_help
     
     # Sets the label associated with the menu item.
+    # 
     # Note that if the ID of this menu item corresponds to a stock ID, then it is not necessary to specify a label: wxWidgets will automatically use the stock item label associated with that ID. See the {Wx::constructor} for more info.
     # The label string for the normal menu items (not separators) may include the accelerator which can be used to activate the menu item from keyboard. An accelerator key can be specified using the ampersand <code>&</code> character. In order to embed an ampersand character in the menu item text, the ampersand must be doubled.
     # Optionally you can specify also an accelerator string appending a tab character <code>\t</code> followed by a valid key combination (e.g. <code>CTRL+V</code>). Its general syntax is any combination of <code>"CTRL"</code>, <code>"RAWCTRL"</code>, <code>"ALT"</code> and <code>"SHIFT"</code> strings (case doesn't matter) separated by either <code>'-'</code> or <code>'+'</code> characters and followed by the accelerator itself. Notice that CTRL corresponds to the "Ctrl" key on most platforms but not under macOS where it is mapped to "Cmd" key on Mac keyboard. Usually this is exactly what you want in portable code but if you really need to use the (rarely used for this purpose) "Ctrl" key even under Mac, you may use RAWCTRL to prevent this mapping. Under the other platforms RAWCTRL is the same as plain CTRL.
@@ -288,9 +317,15 @@ module Wx
     #   @my_menu_item4.set_item_label("Item with &accelerator")
     # ```
     # 
-    # In wxGTK using <code>"SHIFT"</code> with non-alphabetic characters currently doesn't work, even in combination with other modifiers, due to GTK+ limitation. E.g. <code>Shift+Ctrl+A</code> works but <code>Shift+Ctrl+1</code> or <code>Shift+/</code> do not, so avoid using accelerators of this form in portable code.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>In WXGTK using <code>"SHIFT"</code> with non-alphabetic characters currently doesn't work, even in combination with other modifiers, due to GTK+ limitation. E.g. <code>Shift+Ctrl+A</code> works but <code>Shift+Ctrl+1</code> or <code>Shift+/</code> do not, so avoid using accelerators of this form in portable code.
+    # </p>
+    # </div>
     # 
-    # In {Wx::GTk}, the left/right/up/down arrow keys do not work as accelerator keys for a menu item unless a modifier key is used. Additionally, the following keycodes are not supported as menu accelerator keys:
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>In {Wx::GTk}, the left/right/up/down arrow keys do not work as accelerator keys for a menu item unless a modifier key is used. Additionally, the following keycodes are not supported as menu accelerator keys:
     # 
     # - {Wx::KeyCode::K_COMMAND}/{Wx::KeyCode::K_CONTROL}
     # - {Wx::KeyCode::K_SHIFT}
@@ -308,6 +343,9 @@ module Wx
     # - {Wx::KeyCode::K_DECIMAL}
     # - {Wx::KeyCode::K_DIVIDE}
     # - {Wx::KeyCode::K_SNAPSHOT}
+    # 
+    # </p>
+    # </div>
     # @see Wx::MenuItem#get_item_label
     # @see  Wx::MenuItem#get_item_label_text 
     # @param label [String] 
@@ -316,9 +354,11 @@ module Wx
     alias_method :item_label=, :set_item_label
     
     # Sets the width of the menu item checkmark bitmap.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @param width [Integer] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_margin_width(width) end
     alias_method :margin_width=, :set_margin_width
     
@@ -335,9 +375,11 @@ module Wx
     alias_method :sub_menu=, :set_sub_menu
     
     # Sets the text colour associated with the menu item.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @param colour [Wx::Colour,String,Symbol] 
     # @return [void]
+    # @wxrb_require WXMSW
     def set_text_colour(colour) end
     alias_method :text_colour=, :set_text_colour
     
@@ -348,20 +390,24 @@ module Wx
     alias_method :accel=, :set_accel
     
     # Add an extra accelerator for this menu item.
+    # 
     # Additional accelerators are not shown in the item's label, but still will trigger the menu command when pressed.
     # They can be useful to let multiple keys be used as accelerators for the same command, e.g. {Wx::KeyCode::K_ADD} and {Wx::KeyCode::K_NUMPAD}_ADD.
-    # Availability:  only available for the wxMSW, wxGTK ports.  {Wx::msw},{Wx::gtk}
+    # Availability:  only available for the WXMSW, WXGTK ports.
     # @param accel [Wx::AcceleratorEntry] 
     # @return [void]
+    # @wxrb_require WXMSW|WXGTK
     def add_extra_accel(accel) end
     
     # Clear the extra accelerators list.
+    # 
     # This doesn't affect the main item accelerator (if any).
     # @return [void]
     def clear_extra_accels; end
     
     # Constructs a {Wx::MenuItem} object.
-    # Menu items can be standard, or "stock menu items", or custom. For the standard menu items (such as commands to open a file, exit the program and so on, see Stock Items for the full list) it is enough to specify just the stock ID and leave text and helpString empty. Some platforms (currently wxGTK only, and see the remark in {Wx::MenuItem#set_bitmap} documentation) will also show standard bitmaps for stock menu items.
+    # 
+    # Menu items can be standard, or "stock menu items", or custom. For the standard menu items (such as commands to open a file, exit the program and so on, see Stock Items for the full list) it is enough to specify just the stock ID and leave text and helpString empty. Some platforms (currently WXGTK only, and see the remark in {Wx::MenuItem#set_bitmap} documentation) will also show standard bitmaps for stock menu items.
     # Leaving at least text empty for the stock menu items is actually strongly recommended as they will have appearance and keyboard interface (including standard accelerators) familiar to the user.
     # For the custom (non-stock) menu items, text must be specified and while helpString may be left empty, it's recommended to pass the item description (which is automatically shown by the library in the status bar when the menu item is selected) in this parameter.
     # Finally note that you can e.g. use a stock menu label without using its stock help string:
@@ -390,6 +436,7 @@ module Wx
     def initialize(parentMenu=nil, id=Wx::StandardID::ID_SEPARATOR, text=(''), helpString=(''), kind=Wx::ItemKind::ITEM_NORMAL, subMenu=nil) end
     
     # Checks or unchecks the menu item.
+    # 
     # Note that this only works when the item is already appended to a menu.
     # @param check [Boolean] 
     # @return [void]
@@ -401,6 +448,7 @@ module Wx
     def enable(enable=true) end
     
     # Strips all accelerator characters and mnemonics from the given text.
+    # 
     # For example:
     # 
     # ```ruby

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

@@ -11,6 +11,7 @@ module Wx
   MESSAGE_BOX_CAPTION_STR = "Message"
   
   # Show a general purpose message dialog.
+  # 
   # This is a convenient function which is usually used instead of using {Wx::MessageDialog} directly. Notice however that some of the features, such as extended text and custom labels for the message box buttons, are not provided by this function but only by {Wx::MessageDialog}.
   # The return value is one of: {Wx::YES}, {Wx::NO}, {Wx::CANCEL}, {Wx::OK} or {Wx::HELP} (notice that this return value is <b>different</b> from the return value of {Wx::MessageDialog#show_modal}).
   # For example: 
@@ -31,7 +32,8 @@ module Wx
   def self.message_box(message, caption=Wx::MESSAGE_BOX_CAPTION_STR, style=(Wx::OK|Wx::GeometryCentre::CENTRE), parent=nil, x=Wx::DEFAULT_COORD, y=Wx::DEFAULT_COORD) end
   
   # This class represents a dialog that shows a single or multi-line message, with a choice of OK, Yes, No and Cancel buttons.
-  # === Styles
+  # 
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -39,13 +41,13 @@ module Wx
   # 
   # - {Wx::CANCEL}: Puts a Cancel button in the message box. Must be combined with either {Wx::OK} or {Wx::YES_NO}. 
   # 
-  # - {Wx::YES_NO}: Puts Yes and No buttons in the message box. It is recommended to always use {Wx::CANCEL} with this style as otherwise the message box won't have a close button under wxMSW and the user will be forced to answer it. 
+  # - {Wx::YES_NO}: Puts Yes and No buttons in the message box. It is recommended to always use {Wx::CANCEL} with this style as otherwise the message box won't have a close button under WXMSW and the user will be forced to answer it. 
   # 
-  # - {Wx::HELP}: Puts a Help button to the message box. This button can have special appearance or be specially positioned if its label is not changed from the default one. Notice that using this button is not supported when showing a message box from non-main thread in wxOSX/Cocoa. Available since wxWidgets 2.9.3. 
+  # - {Wx::HELP}: Puts a Help button to the message box. This button can have special appearance or be specially positioned if its label is not changed from the default one. Notice that using this button is not supported when showing a message box from non-main thread in WXOSX/Cocoa. Available since wxWidgets 2.9.3. 
   # 
   # - {Wx::NO_DEFAULT}: Makes the "No" button default, can only be used with {Wx::YES_NO}. 
   # 
-  # - {Wx::CANCEL_DEFAULT}: Makes the "Cancel" button default, can only be used with {Wx::CANCEL}. This style is currently not supported (and ignored) in wxOSX. 
+  # - {Wx::CANCEL_DEFAULT}: Makes the "Cancel" button default, can only be used with {Wx::CANCEL}. This style is currently not supported (and ignored) in WXOSX. 
   # 
   # - {Wx::YES_DEFAULT}: Makes the "Yes" button default, this is the default behaviour and this flag exists solely for symmetry with {Wx::NO_DEFAULT}. 
   # 
@@ -57,7 +59,7 @@ module Wx
   # 
   # - {Wx::ICON_WARNING}: Displays a warning icon in the dialog. This style should be used for informative warnings or, in combination with {Wx::YES_NO} or {Wx::CANCEL}, for questions that have potentially serious consequences (caution icon is used on macOS in this case). 
   # 
-  # - {Wx::ICON_QUESTION}: Displays a question mark symbol. This icon is automatically used with {Wx::YES_NO} so it's usually unnecessary to specify it explicitly. This style is not supported for message dialogs under wxMSW when a task dialog is used to implement them (i.e. when running under Windows Vista or later) because Microsoft guidelines indicate that no icon should be used for routine confirmations. If it is specified, no icon will be displayed. 
+  # - {Wx::ICON_QUESTION}: Displays a question mark symbol. This icon is automatically used with {Wx::YES_NO} so it's usually unnecessary to specify it explicitly. This style is not supported for message dialogs under WXMSW when a task dialog is used to implement them (i.e. when running under Windows Vista or later) because Microsoft guidelines indicate that no icon should be used for routine confirmations. If it is specified, no icon will be displayed. 
   # 
   # - {Wx::ICON_INFORMATION}: Displays an information symbol. This icon is used by default if {Wx::YES_NO} is not given so it is usually unnecessary to specify it explicitly. 
   # 
@@ -65,23 +67,23 @@ module Wx
   # 
   # - {Wx::ICON_HAND}: Alias for {Wx::ICON_ERROR}. 
   # 
-  # - {Wx::ICON_AUTH_NEEDED}: Displays an authentication needed symbol. This style is only supported for message dialogs under wxMSW when a task dialog is used to implement them (i.e. when running under Windows Vista or later). In other cases the default icon selection logic will be used. Note this can be combined with other styles to provide a fallback. For instance, using {Wx::ICON_AUTH_NEEDED} | {Wx::ICON_QUESTION} will show a shield symbol on Windows Vista or above and a question symbol on other platforms. Available since wxWidgets 2.9.5 
+  # - {Wx::ICON_AUTH_NEEDED}: Displays an authentication needed symbol. This style is only supported for message dialogs under WXMSW when a task dialog is used to implement them (i.e. when running under Windows Vista or later). In other cases the default icon selection logic will be used. Note this can be combined with other styles to provide a fallback. For instance, using {Wx::ICON_AUTH_NEEDED} | {Wx::ICON_QUESTION} will show a shield symbol on Windows Vista or above and a question symbol on other platforms. Available since wxWidgets 2.9.5 
   # 
   # - {Wx::STAY_ON_TOP}: Makes the message box stay on top of all other windows and not only just its parent (currently implemented only under MSW and GTK). 
   # 
   # - {Wx::GeometryCentre::CENTRE}: Centre the message box on its parent or on the screen if parent is not specified. Setting this style under MSW makes no differences as the dialog is always centered on the parent. 
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see wxMessageDialog Overview 
   # 
   # @see Wx::RichMessageDialog 
   # 
   # 
+  # @wxrb_require USE_MSGDLG
   class MessageDialog < Dialog
   
     # Constructor specifying the message box properties.
+    # 
     # Use {Wx::MessageDialog#show_modal} to show the dialog.
     # style may be a bit list of the identifiers described above.
     # Notice that not all styles are compatible: only one of {Wx::OK} and {Wx::YES_NO} may be specified (and one of them must be specified) and at most one default button style can be used and it is only valid if the corresponding button is shown in the message box.
@@ -94,6 +96,7 @@ module Wx
     def initialize(parent, message, caption=Wx::MESSAGE_BOX_CAPTION_STR, style=(Wx::OK|Wx::GeometryCentre::CENTRE), pos=Wx::DEFAULT_POSITION) end
     
     # Sets the extended message for the dialog: this message is usually an extension of the short message specified in the constructor or set with {Wx::MessageDialog#set_message}.
+    # 
     # If it is set, the main message appears highlighted  if supported  and this message appears beneath it in normal font. On the platforms which don't support extended messages, it is simply appended to the normal message with an empty line separating them.
     # @param extendedMessage [String] 
     # @return [void]
@@ -101,6 +104,7 @@ module Wx
     alias_method :extended_message=, :set_extended_message
     
     # Sets the label for the Help button.
+    # 
     # Please see the remarks in {Wx::MessageDialog#set_yes_no_labels} documentation.
     # Notice that changing the label of the help button resets its special status (if any, this depends on the platform) and it will be treated just like another button in this case.
     # @param help [String,Integer] 
@@ -115,6 +119,7 @@ module Wx
     alias_method :message=, :set_message
     
     # Overrides the default labels of the OK and Cancel buttons.
+    # 
     # Please see the remarks in {Wx::MessageDialog#set_yes_no_labels} documentation.
     # @param ok [String,Integer] 
     # @param cancel [String,Integer] 
@@ -122,6 +127,7 @@ module Wx
     def set_ok_cancel_labels(ok, cancel) end
     
     # Overrides the default label of the OK button.
+    # 
     # Please see the remarks in {Wx::MessageDialog#set_yes_no_labels} documentation.
     # @param ok [String,Integer] 
     # @return [Boolean]
@@ -129,6 +135,7 @@ module Wx
     alias_method :ok_label=, :set_ok_label
     
     # Overrides the default labels of the Yes, No and Cancel buttons.
+    # 
     # Please see the remarks in {Wx::MessageDialog#set_yes_no_labels} documentation.
     # @param yes [String,Integer] 
     # @param no [String,Integer] 
@@ -137,6 +144,7 @@ module Wx
     def set_yes_no_cancel_labels(yes, no, cancel) end
     
     # Overrides the default labels of the Yes and No buttons.
+    # 
     # The arguments of this function can be either strings or one of the standard identifiers, such as {Wx::StandardID::ID_APPLY} or {Wx::StandardID::ID_OPEN}. Notice that even if the label is specified as an identifier, the return value of the dialog {Wx::MessageDialog#show_modal} method still remains one of {Wx::StandardID::ID_OK}, {Wx::StandardID::ID_CANCEL}, {Wx::StandardID::ID_YES} or {Wx::StandardID::ID_NO} values, i.e. this identifier changes only the label appearance but not the return code generated by the button. It is possible to mix stock identifiers and string labels in the same function call, for example: 
     # ```ruby
     #   Wx.MessageDialog(...) do |dlg|
@@ -160,6 +168,7 @@ module Wx
     def set_yes_no_labels(yes, no) end
     
     # Shows the dialog, returning one of {Wx::StandardID::ID_OK}, {Wx::StandardID::ID_CANCEL}, {Wx::StandardID::ID_YES}, {Wx::StandardID::ID_NO} or {Wx::StandardID::ID_HELP}.
+    # 
     # Notice that this method returns the identifier of the button which was clicked unlike {message_box} function.
     # @return [Integer]
     def show_modal; end

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

@@ -7,9 +7,10 @@
 module Wx
 
   # A miniframe is a frame with a small title bar.
+  # 
   # It is suitable for floating toolbars that must not take up too much screen area.
   # An example of mini frame can be seen in the Dialogs Sample using the "Mini frame" command of the "Generic dialogs" submenu.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -33,9 +34,11 @@ module Wx
   # 
   # - {Wx::RESIZE_BORDER}: Displays a resizable border around the window. 
   # 
-  # This class has miniframe functionality under Windows and GTK, i.e. the presence of mini frame will not be noted in the task bar and focus behaviour is different. On other platforms, it behaves like a normal frame.
-  # 
-  # === 
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>This class has miniframe functionality under Windows and GTK, i.e. the presence of mini frame will not be noted in the task bar and focus behaviour is different. On other platforms, it behaves like a normal frame.
+  # </p>
+  # </div>
   # 
   # Category:  Managed Windows
   # @see Wx::MDIParentFrame
@@ -51,7 +54,12 @@ module Wx
     #   @return [Wx::MiniFrame]
     # @overload initialize(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::CAPTION|Wx::RESIZE_BORDER), name=Wx::FRAME_NAME_STR)
     #   Constructor, creating the window.
-    #   The frame behaves like a normal frame on non-Windows platforms.
+    #   
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>The frame behaves like a normal frame on non-Windows platforms.
+    #   </p>
+    #   </div>
     #   @see Wx::MiniFrame#create 
     #   @param parent [Wx::Window]  The window parent. This may be NULL. If it is non-NULL, the frame will always be displayed on top of the parent window on Windows.
     #   @param id [Integer]  The window identifier. It may take a value of -1 to indicate a default value.
@@ -64,6 +72,7 @@ module Wx
     def initialize(*args) end
     
     # Used in two-step frame construction.
+    # 
     # See {Wx::MiniFrame#initialize} for further details.
     # @param parent [Wx::Window] 
     # @param id [Integer] 

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

@@ -7,9 +7,8 @@
 module Wx
 
   # {Wx::MirrorDC} is a simple wrapper class which is always associated with a real {Wx::DC} object and either forwards all of its operations to it without changes (no mirroring takes place) or exchanges x and y coordinates which makes it possible to reuse the same code to draw a figure and its mirror  i.e.
-  # reflection related to the diagonal line x == y.
   # 
-  # === 
+  # reflection related to the diagonal line x == y.
   # 
   # Category:  Device Contexts
   # 

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

@@ -47,9 +47,9 @@ module Wx
   end # MouseButton
   
   # Represents the mouse state.
+  # 
   # This class is used as a base class by {Wx::MouseEvent} and so its methods may be used to obtain information about the mouse state for the mouse events. It also inherits from {Wx::KeyboardState} and so carries information about the keyboard state and not only the mouse one.
   # This class is implemented entirely inline in <{Wx::/mousestate.h}> and thus has no linking requirements.
-  # === 
   # 
   # Category:  {Wx::Events}
   # @see get_mouse_state

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

@@ -7,7 +7,8 @@
 module Wx
 
   # This class represents a dialog that shows a list of strings, and allows the user to select one or more.
-  # === Styles
+  # 
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -17,17 +18,21 @@ module Wx
   # 
   # - {Wx::GeometryCentre::CENTRE}: Centre the message. 
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see wxMultiChoiceDialog Overview
   # @see  Wx::SingleChoiceDialog 
   # 
   # 
+  # @wxrb_require USE_CHOICEDLG
   class MultiChoiceDialog < Dialog
   
     # Constructor taking an array of {Wx::String} choices.
-    # Use {Wx::MultiChoiceDialog#show_modal} to show the dialog.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use {Wx::MultiChoiceDialog#show_modal} to show the dialog.
+    # </p>
+    # </div>
     # @param parent [Wx::Window]  Parent window.
     # @param message [String]  Message to show on the dialog.
     # @param caption [String]  The dialog caption.

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

@@ -10,6 +10,7 @@ module Wx
   FRAME_SHAPED = 16
   
   # Common base class for all non-child windows.
+  # 
   # This is the common base class of {Wx::TopLevelWindow} and {Wx::PopupWindow} and is not used directly.
   # Currently the only additional functionality it provides, compared to base {Wx::Window} class, is the ability to set the window shape.
   # 
@@ -17,6 +18,7 @@ module Wx
   
     # @overload set_shape(region)
     #   If the platform supports it, sets the shape of the window to that depicted by region.
+    #   
     #   The system will not display or respond to any mouse event for the pixels that lie outside of the region. To reset the window to the normal rectangular shape simply call {Wx::NonOwnedWindow#set_shape} again with an empty {Wx::Region}. Returns true if the operation is successful.
     #   This method is available in this class only since wxWidgets 2.9.3, previous versions only provided it in {Wx::TopLevelWindow}.
     #   Note that windows with non default shape have a fixed size and can't be resized using {Wx::NonOwnedWindow#set_size}.
@@ -24,6 +26,7 @@ module Wx
     #   @return [Boolean]
     # @overload set_shape(path)
     #   Set the window shape to the given path.
+    #   
     #   Set the window shape to the interior of the given path and also draw the window border along the specified path.
     #   For example, to make a clock-like circular window you could use 
     #   ```ruby
@@ -34,7 +37,7 @@ module Wx
     #   ```
     #   
     #   Note that windows with non default shape have a fixed size and can't be resized using {Wx::NonOwnedWindow#set_size}.
-    #   As the overload above, this method is not guaranteed to work on all platforms but currently does work in wxMSW, wxOSX/Cocoa and wxGTK (with the appropriate but almost always present X11 extensions) ports.
+    #   As the overload above, this method is not guaranteed to work on all platforms but currently does work in WXMSW, WXOSX/Cocoa and WXGTK (with the appropriate but almost always present X11 extensions) ports.
     #   @param path [Wx::GraphicsPath] 
     #   @return [Boolean]
     def set_shape(*args) end