wxruby3 0.9.0.pre.beta.14-x64-mingw-ucrt → 0.9.0.pre.rc.2-x64-mingw-ucrt

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

@@ -52,68 +52,71 @@ module Wx
   # This class represents the file chooser dialog.
   # The path and filename are distinct elements of a full file pathname. If path is {Wx::EmptyString}, the current directory will be used. If filename is {Wx::EmptyString}, no default filename will be supplied. The wildcard determines what files are displayed in the file selector, and file extension supplies a type extension for the required filename.
   # The typical usage for the open file dialog is: 
-  # 
-  #   void MyFrame::OnOpen(wxCommandEvent& WXUNUSED(event))
-  #   {
-  #       if (...current content has not been saved...)
-  #       {
-  #           if (wxMessageBox(_("Current content has not been saved! Proceed?"), _("Please confirm"),
-  #                            wxICON_QUESTION | wxYES_NO, this) == wxNO )
-  #               return;
-  #           //else: proceed asking to the user the new file to open
-  #       }
-  #   
-  #       wxFileDialog
-  #           openFileDialog(this, _("Open XYZ file"), "", "",
-  #                          "XYZ files (*.xyz)|*.xyz", wxFD_OPEN|wxFD_FILE_MUST_EXIST);
-  #   
-  #       if (openFileDialog.ShowModal() == wxID_CANCEL)
-  #           return;     // the user changed idea...
-  #   
-  #       // proceed loading the file chosen by the user;
-  #       // this can be done with e.g. wxWidgets input streams:
-  #       wxFileInputStream input_stream(openFileDialog.GetPath());
-  #       if (!input_stream.IsOk())
-  #       {
-  #           wxLogError("Cannot open file '%s'.", openFileDialog.GetPath());
-  #           return;
-  #       }
+  # ```ruby
+  # class MyFrame
+  #   ...
+  #   def on_open(event)
+  #     if (...current content has not been saved...)
+  #       if Wx.message_box('Current content has not been saved! Proceed?', 'Please confirm',
+  #                         Wx::ICON_QUESTION | Wx::YES_NO, self) == Wx::NO
+  #         return 
+  #       #else: proceed asking to the user the new file to open
+  #       end
+  #     end
   #   
+  #     Wx::FileDialog(self, "Open XYZ file", "", "",
+  #                         "XYZ files (*.xyz)|*.xyz", Wx::FD_OPEN|Wx::FD_FILE_MUST_EXIST) do |dlg|
+  #       return if dlg.show_modal == Wx::ID_CANCEL # the user changed idea...?
+  # 
+  #       # proceed loading the file chosen by the user
+  #       file = File.open(dlg.path, 'r') rescue nil
+  #       unless file
+  #          Wx.log_error("Cannot open file '#{dlg.path}'.")
+  #          return
+  #       end
   #       ...
-  #   }
+  #     end
+  #   end
   # 
-  # The typical usage for the save file dialog is instead somewhat simpler: 
+  # end
+  # ```
   # 
-  #   void MyFrame::OnSaveAs(wxCommandEvent& WXUNUSED(event))
-  #   {
-  #       wxFileDialog
-  #           saveFileDialog(this, _("Save XYZ file"), "", "",
-  #                          "XYZ files (*.xyz)|*.xyz", wxFD_SAVE|wxFD_OVERWRITE_PROMPT);
-  #   
-  #       if (saveFileDialog.ShowModal() == wxID_CANCEL)
-  #           return;     // the user changed idea...
-  #   
-  #       // save the current contents in the file;
-  #       // this can be done with e.g. wxWidgets output streams:
-  #       wxFileOutputStream output_stream(saveFileDialog.GetPath());
-  #       if (!output_stream.IsOk())
-  #       {
-  #           wxLogError("Cannot save current contents in file '%s'.", saveFileDialog.GetPath());
-  #           return;
-  #       }
+  # The typical usage for the save file dialog is instead somewhat simpler: 
+  # ```ruby
+  # class MyFrame
+  #   ...
+  #   def on_save_as(event)
+  #     Wx::FileDialog(self, "Save XYZ file", "", "",
+  #                         "XYZ files (*.xyz)|*.xyz", Wx::FD_SAVE|Wx::FD_OVERWRITE_PROMPT) do |dlg|
+  #       return if dlg.show_modal == Wx::ID_CANCEL # the user changed idea...?
   #   
-  #       ...
-  #   }
+  #       # save the current contents in the file
+  #       begin
+  #         File.open(dlg.path, 'w+') do |f|
+  #           # save to file
+  #         end
+  #       rescue 
+  #         Wx.log_error("Cannot save current contents in file '#{dlg.path}'.")
+  #         return
+  #       end
+  #     end
+  #     ...
+  #   end
+  # 
+  # end
+  # ```
   # 
   # == 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: 
-  # 
+  # ```
   #   "BMP and GIF files (*.bmp;*.gif)|*.bmp;*.gif|PNG files (*.png)|*.png"
+  # ```
   # 
   # On Mac macOS in the open file dialog the filter choice box is not shown by default. Instead all given wildcards are applied at the same time: So in the above example all bmp, gif and png files are displayed. To enforce the display of the filter choice set the corresponding {Wx::SystemOptions} before calling the file open dialog: 
-  # 
-  #   wxSystemOptions::SetOption(wxOSX_FILEDIALOG_ALWAYS_SHOW_TYPES, 1)
+  # ```ruby
+  #   Wx::SystemOptions.set_option(Wx::OSX_FILEDIALOG_ALWAYS_SHOW_TYPES, 1)
+  # ```
   #  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

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

@@ -34,7 +34,7 @@ module Wx
     def create(parent, data, title, style=0) end
     
     # Get the {Wx::FindReplaceData} object used by this dialog.
-    # @return [void]
+    # @return [Wx::FindReplaceData]
     def get_data; end
     alias_method :data, :get_data
     

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

@@ -657,6 +657,8 @@ module Wx
   # @see  Wx::SystemSettings 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class Font < GDIObject
   
     # Returns a font with the same face/size as the given one but with normal weight and style and not underlined nor stricken through.
@@ -914,6 +916,15 @@ module Wx
     def set_family(family) end
     alias_method :family=, :set_family
     
+    # Creates the font corresponding to the given native font description string which must have been previously returned by {Wx::Font#get_native_font_info_desc}.
+    # If the string is invalid, font is unchanged. This function is typically used for de-serializing a {Wx::Font} object previously saved in a string-form.
+    # true if the creation was successful.
+    # @see Wx::Font#set_native_font_info_user_desc 
+    # @param info [String] 
+    # @return [true,false]
+    def set_native_font_info(info) end
+    alias_method :native_font_info=, :set_native_font_info
+    
     # Creates the font corresponding to the given native font description string and returns true if the creation was successful.
     # Unlike {Wx::Font#set_native_font_info}, this function accepts strings which are user-friendly. Examples of accepted string formats are:
     # 
@@ -1082,16 +1093,19 @@ module Wx
     #   Creates a font object using the specified font description.
     #   This is the preferred way to create font objects as using this ctor results in more readable code and it is also extensible, e.g. it could continue to be used if support for more font attributes is added in the future. For example, this constructor provides the only way of creating fonts with strike-through style.
     #   Example of creating a font using this ctor: 
-    #   
+    #   ```
     #     wxFont font(wxFontInfo(10).Bold().Underlined());
+    #   ```
     #   @param fontInfo [Wx::FontInfo] 
     #   @return [Font]
     # @overload initialize(pointSize, family, style, weight, underline=false, faceName=(''), encoding=Wx::FontEncoding::FONTENCODING_DEFAULT)
     #   Creates a font object with the specified attributes and size in points.
     #   Notice that the use of this constructor is often more verbose and less readable than using wxFont(const wxFontInfo& font), e.g. the example in that constructor documentation would need to be written as:
     #   
+    #   ```
     #     wxFont font(10, wxFONTFAMILY_DEFAULT, wxFONTSTYLE_NORMAL,
     #                 wxFONTWEIGHT_BOLD, true);
+    #   ```
     #   
     #   If the desired font does not exist, the closest match will be chosen. Under Windows, only scalable TrueType fonts are used.
     #   @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.
@@ -1155,12 +1169,15 @@ module Wx
   
   # This class is a helper used for {Wx::Font} creation using named parameter idiom: it allows specifying various {Wx::Font} attributes using the chained calls to its clearly named methods instead of passing them in the fixed order to {Wx::Font} constructors.
   # For example, to create an italic font with the given face name and size you could use: 
-  # 
+  # ```
   #   wxFont font(wxFontInfo(12).FaceName("Helvetica").Italic());
+  # ```
   # 
   # Notice that all of the methods of this object return a reference to the object itself, allowing the calls to them to be chained as in the example above.
   # All methods taking boolean parameters can be used to turn the specified font attribute on or off and turn it on by default.
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class FontInfo < ::Object
   
     # @overload initialize()

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

@@ -15,6 +15,8 @@ module Wx
   # @see  Wx::FontDialog 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class FontData < Object
   
     # Constructor.

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

@@ -25,7 +25,7 @@ module Wx
   class FontDialog < Dialog
   
     # Returns the font data associated with the font dialog.
-    # @return [void]
+    # @return [Wx::FontData]
     def get_font_data; end
     alias_method :font_data, :get_font_data
     

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

@@ -50,7 +50,9 @@ module Wx
   # 
   # The default frame style is for normal, resizable frames. To create a frame which cannot be resized by user, you may use the following combination of styles:
   # 
+  # ```
   #   wxDEFAULT_FRAME_STYLE & ~(wxRESIZE_BORDER | wxMAXIMIZE_BOX)
+  # ```
   # 
   # See also the Window Styles.
   # 
@@ -238,8 +240,6 @@ module Wx
     
     # 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.
-    # 
-    # <b>{Wx::Perl} Note:</b> In {Wx::Perl} this method takes the field widths as parameters.
     # @param n [Integer]  The number of fields in the status bar. It must be the same used in CreateStatusBar.
     # @param widths_field [int]  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]
@@ -255,8 +255,9 @@ module Wx
     # 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 
-    # 
+    # ```
     #   #ifdef __WXMSW__ 
+    # ```
     #  preprocessor guards.
     # @return [Wx::TaskBarButton]
     def msw_get_task_bar_button; end

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

@@ -40,6 +40,7 @@ module Wx
     # You probably won't use it. See the Note for details.
     # It is seldom used by the application programmer but you will need it if you are writing your own virtual FS. For example you may need something similar to {Wx::MemoryInputStream}, but because {Wx::MemoryInputStream} doesn't free the memory when destroyed and thus passing a memory stream pointer into {Wx::FSFile} constructor would lead to memory leaks, you can write your own class derived from {Wx::FSFile}:
     # 
+    # ```
     #   class wxMyFSFile : public wxFSFile
     #   {
     #       private:
@@ -49,6 +50,7 @@ module Wx
     #           ~wxMyFSFile() {free(m_Mem);}
     #               // of course dtor is virtual ;-)
     #   };
+    # ```
     # 
     # If you are not sure of the meaning of these params, see the description of the GetXXXX() functions.
     # @param stream [IO]  The input stream that will be used to access data
@@ -113,6 +115,8 @@ module Wx
   # @see Wx::StreamBuffer 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class StreamBase < ::Object
   
     # Creates a dummy stream object.
@@ -166,6 +170,8 @@ module Wx
   # 
   # Category:  {Wx::Streams}
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class InputStream < StreamBase
   
     # Creates a dummy input stream.
@@ -230,6 +236,8 @@ module Wx
   # 
   # Category:  {Wx::Streams}
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class OutputStream < StreamBase
   
     # Creates a dummy {Wx::OutputStream} object.

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

@@ -18,30 +18,10 @@ module Wx
   # @see  Wx::GraphicsContext 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GCDC < DC
   
-    # @overload initialize(windowDC)
-    #   Constructs a {Wx::GCDC} from a {Wx::WindowDC}.
-    #   @param windowDC [Wx::WindowDC] 
-    #   @return [GCDC]
-    # @overload initialize(memoryDC)
-    #   Constructs a {Wx::GCDC} from a {Wx::MemoryDC}.
-    #   @param memoryDC [Wx::MemoryDC] 
-    #   @return [GCDC]
-    # @overload initialize(printerDC)
-    #   Constructs a {Wx::GCDC} from a {Wx::PRT::PrinterDC}.
-    #   @param printerDC [Wx::PrinterDC] 
-    #   @return [GCDC]
-    # @overload initialize(context)
-    #   Construct a {Wx::GCDC} from an existing graphics context.
-    #   Note that this object takes ownership of context and will delete it when it is destroyed or when {Wx::GCDC#set_graphics_context} is called with a different context object.
-    #   Also notice that context will continue using the same font, pen and brush as before until {Wx::GCDC#set_font}, {Wx::GCDC#set_pen} or {Wx::GCDC#set_brush} is explicitly called to change them. This means that the code can use this {Wx::DC}-derived object to work using pens and brushes with alpha component, for example (which normally isn't supported by {Wx::DC} API), but it also means that the return values of {Wx::GCDC#get_font}, {Wx::GCDC#get_pen} and {Wx::GCDC#get_brush} won't really correspond to the actually used objects because they simply can't represent them anyhow. If you wish to avoid such discrepancy, you need to call the setter methods to bring {Wx::DC} and {Wx::GraphicsContext} font, pen and brush in sync with each other.
-    #   @param context [Wx::GraphicsContext] 
-    #   @return [GCDC]
-    # @overload initialize()
-    #   @return [GCDC]
-    def initialize(*args) end
-    
     # Retrieves associated {Wx::GraphicsContext}.
     # @return [Wx::GraphicsContext]
     def get_graphics_context; end

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

@@ -352,6 +352,8 @@ module Wx
   # @see Wx::RealPoint 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class Point < ::Object
   
     # Returns true if neither of the point components is equal to {Wx::DEFAULT_COORD}.
@@ -363,10 +365,12 @@ module Wx
     # Combine this object with another one replacing the uninitialized values.
     # It is typically used like this:
     # 
+    # ```
     #   if ( !pos.IsFullySpecified() )
     #   {
     #       pos.SetDefaults(GetDefaultPosition());
     #   }
+    # ```
     # @see Wx::Point#is_fully_specified
     # @param pt [Array(Integer, Integer), Wx::Point] 
     # @return [void]
@@ -409,11 +413,12 @@ module Wx
     # @overload initialize(pt)
     #   Converts the given {Wx::RealPoint} (with floating point coordinates) to a {Wx::Point} instance.
     #   Notice that this truncates the floating point values of pt components, if you want to round them instead you need to do it manually, e.g. 
-    #   
+    #   ```
     #     #include <wx/math.h>    // for wxRound()
     #     
     #     wxRealPoint rp = ...;
     #     wxPoint p(wxRound(rp.x), wxRound(rp.y));
+    #   ```
     #   @param pt [Wx::RealPoint] 
     #   @return [Point]
     def initialize(*args) end
@@ -432,6 +437,8 @@ module Wx
   # @see  Wx::RealPoint 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class Size < ::Object
   
     # @overload dec_by(pt)
@@ -551,10 +558,12 @@ module Wx
     # Combine this size object with another one replacing the default (i.e. equal to -1) components of this object with those of the other.
     # It is typically used like this:
     # 
+    # ```
     #   if ( !size.IsFullySpecified() )
     #   {
     #       size.SetDefaults(GetDefaultSize());
     #   }
+    # ```
     # @see Wx::Size#is_fully_specified 
     # @param sizeDefault [Array(Integer, Integer), Wx::Size] 
     # @return [void]
@@ -577,9 +586,10 @@ module Wx
   
   # Represents a rectangle with integer coordinates.
   # x and y members specify the coordinates of the rectangle top-left corner and width and height specify its width and height respectively. The usual C++ semi-open interval convention is used: point p lies inside the rectangle if and only if both conditions below are satisfied: 
-  # 
+  # ```
   #   x <= p.x < x + width
   #   y <= p.y < y + height
+  # ```
   # 
   # In other words, the rectangle left and right boundaries are at x and <code>x+width-1</code> and its top and bottom boundaries are at y and <code>y+height-1</code> respectively.
   # Note that the x and y coordinates may be negative, but width and height are always strictly positive for non-empty rectangles.
@@ -590,6 +600,8 @@ module Wx
   # @see  Wx::Size 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class Rect < ::Object
   
     # Returns the rectangle having the same size as this one but centered relatively to the given rectangle r.
@@ -887,6 +899,8 @@ module Wx
   # @see Wx::Point 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class RealPoint < ::Object
   
     # X coordinate of this point.
@@ -1073,6 +1087,8 @@ module Wx
   # @see Wx::Colour 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class ColourDatabase < ::Object
   
     # Constructs the colour database.

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

@@ -17,6 +17,8 @@ module Wx
   # @see  Wx::Font 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GDIObject < Object
   
     # Default constructor.

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

@@ -165,6 +165,7 @@ module Wx
   # A {Wx::GraphicsContext} instance is the object that is drawn upon.
   # It is created by a renderer using Wx::GraphicsRenderer#create_context. This can be either directly using a renderer instance, or indirectly using the static convenience {Wx::GraphicsContext.create} functions of {Wx::GraphicsContext} that always delegate the task to the default renderer.
   # 
+  # ```
   #   void MyCanvas::OnPaint(wxPaintEvent &event)
   #   {
   #       // Create paint DC
@@ -191,6 +192,7 @@ module Wx
   #           delete gc;
   #       }
   #   }
+  # ```
   # 
   # For some renderers (like Direct2D or Cairo) processing of drawing operations may be deferred (Direct2D render target normally builds up a batch of rendering commands but defers processing of these commands, Cairo operates on a separate surface) so to make drawing results visible you need to update the content of the context by calling {Wx::GraphicsContext#flush} or by destroying the context.
   # 
@@ -202,51 +204,10 @@ module Wx
   # @see  Wx::DC 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GraphicsContext < GraphicsObject
   
-    # @overload self.create(window)
-    #   Creates a {Wx::GraphicsContext} from a {Wx::Window}.
-    #   
-    #   @see Wx::GraphicsRenderer#create_context 
-    #   @param window [Wx::Window] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create(windowDC)
-    #   Creates a {Wx::GraphicsContext} from a {Wx::WindowDC}.
-    #   
-    #   @see Wx::GraphicsRenderer#create_context 
-    #   @param windowDC [Wx::WindowDC] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create(memoryDC)
-    #   Creates a {Wx::GraphicsContext} from a {Wx::MemoryDC}.
-    #   
-    #   @see Wx::GraphicsRenderer#create_context 
-    #   @param memoryDC [Wx::MemoryDC] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create(printerDC)
-    #   Creates a {Wx::GraphicsContext} from a {Wx::PRT::PrinterDC}.
-    #   Under GTK+, this will only work when using the GtkPrint printing backend which is available since GTK+ 2.10.
-    #   @see Wx::GraphicsRenderer#create_context
-    #   @see  Printing Under Unix (GTK+) 
-    #   @param printerDC [Wx::PrinterDC] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create(image)
-    #   Creates a {Wx::GraphicsContext} associated with a {Wx::Image}.
-    #   The image specifies the size of the context as well as whether alpha is supported (if {Wx::Image#has_alpha}) or not and the initial contents of the context. The image object must have a life time greater than that of the new context as the context copies its contents back to the image when it is destroyed.
-    #   @param image [Wx::Image] 
-    #   @return [Wx::GraphicsContext]
-    # @overload self.create()
-    #   Create a lightweight context that can be used only for measuring text.
-    #   @return [Wx::GraphicsContext]
-    def self.create(*args) end
-    
-    # Creates a {Wx::GraphicsContext} from a DC of unknown specific type.
-    # Creates a {Wx::GraphicsContext} if dc is a supported type (i.e. has a corresponding {Wx::GraphicsContext.create} method, e.g. {Wx::WindowDC} or {Wx::MemoryDC}). Returns NULL if the DC is unsupported.
-    # This method is only useful as a helper in generic code that operates with {Wx::DC} and doesn't known its exact type. Use {Wx::GraphicsContext.create} instead if you know that the DC is e.g. {Wx::WindowDC}.
-    # @see Wx::GraphicsRenderer#create_context_from_unknown_dc
-    # @param dc [Wx::DC] 
-    # @return [Wx::GraphicsContext]
-    def self.create_from_unknown_dc(dc) end
-    
     # Resets the clipping to original shape.
     # @return [void]
     def reset_clip; end

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

@@ -407,7 +407,9 @@ module Wx
     # Concatenates the matrix passed with the current matrix.
     # The effect of the resulting transformation is to first apply the transformation in t to the coordinates and then apply the transformation in the current matrix to the coordinates.
     # 
+    # ```
     #   // matrix = t x matrix
+    # ```
     # @param t [Wx::GraphicsMatrix]  The parameter matrix is the multiplicand.
     # @return [void]
     def concat(t) end

data/lib/wx/doc/gen/grid/grid_cell_attr.rb

@@ -97,10 +97,11 @@ module Wx::GRID
     # Get the alignment defined by this attribute.
     # Unlike {Wx::GRID::GridCellAttr#get_alignment} this function only modifies hAlign and vAlign if this attribute does define a non-default alignment. This means that they must be initialized before calling this function and that their values will be preserved unchanged if they are different from {Wx::Alignment::ALIGN_INVALID}.
     # For example, the following fragment can be used to use the cell alignment if one is defined but right-align its contents by default (instead of left-aligning it by default) while still using the default vertical alignment: 
-    # 
+    # ```
     #   int hAlign = wxALIGN_RIGHT,
     #       vAlign = wxALIGN_INVALID;
     #   attr.GetNonDefaultAlignment(&hAlign, &vAlign);
+    # ```
     # @return [Array(Integer,Integer)]
     def get_non_default_alignment; end
     alias_method :non_default_alignment, :get_non_default_alignment

data/lib/wx/doc/gen/grid/grid_ctrl.rb

@@ -374,7 +374,7 @@ module Wx::GRID
     # Returns the pen used for horizontal grid lines.
     # This virtual function may be overridden in derived classes in order to change the appearance of individual grid line for the given row.
     # Example: 
-    # 
+    # ```
     #   // in a grid displaying music notation, use a solid black pen between
     #   // octaves (C0=row 127, C1=row 115 etc.)
     #   wxPen MidiGrid::GetRowGridLinePen(int row)
@@ -384,6 +384,7 @@ module Wx::GRID
     #       else
     #           return GetDefaultGridLinePen();
     #   }
+    # ```
     # @param row [Integer] 
     # @return [Wx::Pen]
     def get_row_grid_line_pen(row) end
@@ -1258,7 +1259,7 @@ module Wx::GRID
     #   For normal cells, the function fills both num_rows and num_cols with 1 and returns CellSpan_None. For cells which span multiple cells, i.e. for which {Wx::GRID::Grid#set_cell_size} had been called, the returned values are the same ones as were passed to {Wx::GRID::Grid#set_cell_size} call and the function return value is CellSpan_Main.
     #   More unexpectedly, perhaps, the returned values may be negative for the cells which are inside a span covered by a cell occupying multiple rows or columns. They correspond to the offset of the main cell of the span from the cell passed to this functions and the function returns CellSpan_Inside value to indicate this.
     #   As an example, consider a 3*3 grid with the cell (1, 1) (the one in the middle) having a span of 2 rows and 2 columns, i.e. the grid looks like 
-    #   
+    #   ```
     #     +----+----+----+
     #     |    |    |    |
     #     +----+----+----+
@@ -1266,6 +1267,7 @@ module Wx::GRID
     #     +----+         |
     #     |    |         |
     #     +----+----+----+
+    #   ```
     #    Then the function returns 2 and 2 in num_rows and num_cols for the cell (1, 1) itself and -1 and -1 for the cell (2, 2) as well as -1 and 0 for the cell (2, 1).
     #   
     #   The kind of this cell span (the return value is new in wxWidgets 2.9.1, this function was void in previous wxWidgets versions).

data/lib/wx/doc/gen/grid/grid_table_message.rb

@@ -9,6 +9,8 @@ module Wx::GRID
   # Message class used by the grid table to send requests and notifications to the grid view.
   # A message object of this class must be sent to the grid using {Wx::GRID::Grid#process_table_message} every time the table changes, e.g. rows are added/deleted. The messages are just notifications and don't result in any actual changes but just allow the view to react to changes to the model.
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GridTableMessage < ::Object
   
     # @overload initialize()

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

@@ -207,6 +207,8 @@ module Wx
   # 
   # Category:  Window Layout
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GBSpan < ::Object
   
     # @overload initialize()
@@ -253,6 +255,8 @@ module Wx
   # 
   # Category:  Window Layout
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class GBPosition < ::Object
   
     # @overload initialize()

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

@@ -34,8 +34,9 @@ module Wx
   # The remaining help controller classes need to be named explicitly by an application that wishes to make use of them.
   # The following help controller classes are defined:
   # - {Wx::WinHelpController}, for controlling Windows Help.- {Wx::CHMHelpController}, for controlling MS HTML Help. To use this, you need to set {Wx::Setup::USE_MS_HTML_HELP} to 1 in setup.h and have the htmlhelp.h header from Microsoft's HTML Help kit. (You don't need the VC++-specific htmlhelp.lib because wxWidgets loads necessary DLL at runtime and so it works with all compilers.)- {Wx::BestHelpController}, for controlling MS HTML Help or, if Microsoft's runtime is not available, {Wx::HTML::HtmlHelpController}. You need to provide <b>both</b> CHM and HTB versions of the help file. For {Wx::MSW} only.- {Wx::ExtHelpController}, for controlling external browsers under Unix. The default browser is Netscape Navigator. The 'help' sample shows its use.- {Wx::HTML::HtmlHelpController}, a sophisticated help controller using {Wx::HTML}, in a similar style to the Microsoft HTML Help viewer and using some of the same files. Although it has an API compatible with other help controllers, it has more advanced features, so it is recommended that you use the specific API for this class instead. Note that if you use .zip or .htb formats for your books, you must add this line to your application initialization: 
-  # 
+  # ```
   # wxFileSystem::AddHandler(new wxArchiveFSHandler); 
+  # ```
   # or nothing will be shown in your help window.
   # 
   # === 
@@ -119,9 +120,11 @@ module Wx
     # Sets detailed viewer information.
     # So far this is only relevant to {Wx::ExtHelpController}. Some examples of usage:
     # 
+    # ```
     #   m_help.SetViewer("kdehelp");
     #   m_help.SetViewer("gnome-help-browser");
     #   m_help.SetViewer("netscape", wxHELP_NETSCAPE);
+    # ```
     # 
     # Todomodernize this function with {Wx::LaunchDefaultBrowser}
     # @param viewer [String]  This defaults to "netscape" for {Wx::ExtHelpController}.

data/lib/wx/doc/gen/html/html_cell.rb

@@ -269,6 +269,8 @@ module Wx::HTML
   # 
   # Category:  {Wx::HTML}
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class HtmlLinkInfo < Object
   
     # @overload initialize()
@@ -420,8 +422,9 @@ module Wx::HTML
     #   Sets floating width adjustment.
     #   The normal behaviour of container is that its width is the same as the width of parent container (and thus you can have only one sub-container per line). You can change this by setting the floating width adjustment.
     #   @param w [Integer]  Width of the container. If the value is negative it means complement to full width of parent container. E.g. 
-    #     
+    #     ```
     #       SetWidthFloat(-50, wxHTML_UNITS_PIXELS) 
+    #     ```
     #      sets the width of container to parent's width minus 50 pixels. This is useful when creating tables - you can call SetWidthFloat(50) and SetWidthFloat(-50).
     #   @param units [Integer]  Units of w This parameter affects the interpretation of value.
     #     - {Wx::HTML::HTML_UNITS_PIXELS}: w is number of pixels- {Wx::HTML::HTML_UNITS_PERCENT}: w is interpreted as percents of width of parent container

data/lib/wx/doc/gen/html/html_help_controller.rb

@@ -73,8 +73,9 @@ module Wx::HTML
     #   Adds a book (i.e.
     #   a .hhp file; an HTML Help Workshop project file) into the list of loaded books.
     #   This must be called at least once before displaying any help. bookFile or bookUrl may be either <code>".hhp"</code> file or a ZIP archive that contains an arbitrary number of <code>".hhp"</code> files in its top-level directory. This ZIP archive must have <code>".zip"</code> or <code>".htb"</code> extension (the latter stands for "HTML book"). In other words, 
-    #   
+    #   ```
     #     AddBook(wxFileName("help.zip"))
+    #   ```
     #    is possible and is the recommended way.
     #   @param bookFile [Wx::FileName]  Help book filename. It is recommended to use this prototype instead of the one taking URL, because it is less error-prone.
     #   @param showWaitMsg [true,false]  If true then a decoration-less window with progress message is displayed.
@@ -239,9 +240,11 @@ module Wx::HTML
     # Sets detailed viewer information.
     # So far this is only relevant to {Wx::ExtHelpController}. Some examples of usage:
     # 
+    # ```
     #   m_help.SetViewer("kdehelp");
     #   m_help.SetViewer("gnome-help-browser");
     #   m_help.SetViewer("netscape", wxHELP_NETSCAPE);
+    # ```
     # 
     # Todomodernize this function with {Wx::LaunchDefaultBrowser}
     # @param viewer [String]  This defaults to "netscape" for {Wx::ExtHelpController}.