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

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

@@ -95,7 +95,7 @@ module Wx
     # Returns true if the mask is one of allowed masks for {log_trace}.
     # See also: {Wx::Log.add_trace_mask}, {Wx::Log.remove_trace_mask}
     # @param mask [String] 
-    # @return [true,false]
+    # @return [Boolean]
     def self.is_allowed_trace_mask(mask) end
     
     # Remove the mask from the list of allowed masks for {log_trace}.
@@ -112,7 +112,7 @@ module Wx
     def self.dont_create_on_demand; end
     
     # Returns the pointer to the active log target (may be NULL).
-    # Notice that if {Wx::Log.set_active_target} hadn't been previously explicitly called, this function will by default try to create a log target by calling Wx::AppTraits#create_log_target which may be overridden in a user-defined traits class to change the default behaviour. You may also call {Wx::Log.dont_create_on_demand} to disable this behaviour.
+    # Notice that if {Wx::Log.set_active_target} hadn't been previously explicitly called, this function will by default try to create a log target by calling {Wx::AppTraits#create_log_target} which may be overridden in a user-defined traits class to change the default behaviour. You may also call {Wx::Log.dont_create_on_demand} to disable this behaviour.
     # When this function is called from threads other than main one, auto-creation doesn't happen. But if the thread has a thread-specific log target previously set by {Wx::Log.set_thread_active_target}, it is returned instead of the global one. Otherwise, the global log target is returned.
     # @return [Wx::Log]
     def self.get_active_target; end
@@ -157,13 +157,13 @@ module Wx
     # @see  Wx::Log.set_component_level
     # @param level [Wx::LogLevel] 
     # @param component [String] 
-    # @return [true,false]
+    # @return [Boolean]
     def self.is_level_enabled(level, component) end
     
     # Sets the log level for the given component.
     # For example, to disable all but error messages from wxWidgets network classes you may use 
-    # ```
-    #   wxLog::SetComponentLevel("wx/net", wxLOG_Error);
+    # ```ruby
+    #   wxLog.set_component_level("wx/net", Wx::LOG_Error)
     # ```
     # 
     # {Wx::Log.set_log_level} may be used to set the global log level.
@@ -185,23 +185,23 @@ module Wx
     # The old state, i.e. true if logging was previously enabled and false if it was disabled.
     # @see Wx::LogNull
     # @see  Wx::Log.is_enabled
-    # @param enable [true,false] 
-    # @return [true,false]
+    # @param enable [Boolean] 
+    # @return [Boolean]
     def self.enable_logging(enable=true) end
     
     # Returns true if logging is enabled at all now.
     # 
     # @see Wx::Log.is_level_enabled
     # @see  Wx::Log.enable_logging 
-    # @return [true,false]
+    # @return [Boolean]
     def self.is_enabled; end
     
     # Returns whether the repetition counting mode is enabled.
-    # @return [true,false]
+    # @return [Boolean]
     def self.get_repetition_counting; end
     
     # Enables logging mode in which a log message is logged once, and in case exactly the same message successively repeats one or more times, only the number of repetitions is logged.
-    # @param repetCounting [true,false] 
+    # @param repetCounting [Boolean] 
     # @return [void]
     def self.set_repetition_counting(repetCounting=true) end
     
@@ -223,23 +223,16 @@ module Wx
     def self.disable_timestamp; end
     
     # Returns whether the verbose mode is currently active.
-    # @return [true,false]
+    # @return [Boolean]
     def self.get_verbose; end
     
     # Activates or deactivates verbose mode in which the verbose messages are logged as the normal ones instead of being silently dropped.
     # The verbose messages are the trace messages which are not disabled in the release mode and are generated by {log_verbose}.
     # @see Logging Overview 
-    # @param verbose [true,false] 
+    # @param verbose [Boolean] 
     # @return [void]
     def self.set_verbose(verbose=true) end
     
-    # Sets the specified formatter as the active one.
-    # Returns the pointer to the previous formatter. You must delete it if you don't plan to attach it again to a {Wx::Log} object later.
-    # @param formatter [Wx::LogFormatter]  The new formatter. If NULL, reset to the default formatter.
-    # @return [Wx::LogFormatter]
-    def set_formatter(formatter) end
-    alias_method :formatter=, :set_formatter
-    
     # Show all pending output and clear the buffer.
     # Some of {Wx::Log} implementations, most notably the standard {Wx::LogGui} class, buffer the messages (for example, to avoid showing the user a zillion of modal message boxes one after another  which would be really annoying). This function shows them all and clears the buffer contents. If the buffer is already empty, nothing happens.
     # If you override this method in a derived class, call the base class version first, before doing anything else.
@@ -249,19 +242,20 @@ module Wx
     # Log the given record.
     # This function should only be called from the DoLog() implementations in the derived classes if they need to call {Wx::Log#do_log_record} on another log object (they can, of course, just use {Wx::Log#do_log_record} call syntax to call it on the object itself). It should not be used for logging new messages which can be only sent to the currently active logger using OnLog() which also checks if the logging (for this level) is enabled while this method just directly calls DoLog().
     # Example of use of this class from {Wx::LogChain}: 
-    # ```
-    #   void wxLogChain::DoLogRecord(wxLogLevel level,
-    #                                const wxString& msg,
-    #                                const wxLogRecordInfo& info)
-    #   {
-    #       // let the previous logger show it
-    #       if ( m_logOld && IsPassingMessages() )
-    #           m_logOld->LogRecord(level, msg, info);
-    #   
-    #       // and also send it to the new one
-    #       if ( m_logNew && m_logNew != this )
-    #           m_logNew->LogRecord(level, msg, info);
-    #   }
+    # ```ruby
+    #   class Wx::LogChain
+    # 
+    #     def do_log_record(level, msg, info)
+    #        # let the previous logger show it
+    #        if m_logOld && is_passing_messages
+    #            m_logOld.log_record(level, msg, info)
+    #     
+    #        # and also send it to the new one
+    #        if m_logNew && m_logNew != self
+    #            m_logNew.log_record(level, msg, info)
+    #     end
+    # 
+    #   end
     # ```
     # @param level [Wx::LogLevel] 
     # @param msg [String] 
@@ -269,6 +263,32 @@ module Wx
     # @return [void]
     def log_record(level, msg, info) end
     
+    
+    protected
+    
+    # Called to log a new record.
+    # Any log message created by {log_xxx}, the corresponding prefix to msg and passes it to {Wx::Log#do_log_text_at_level}.
+    # You may override this method to implement custom formatting of the log messages or to implement custom filtering of log messages (e.g. you could discard all log messages coming from the given source file).
+    # @param level [Wx::LogLevel] 
+    # @param msg [String] 
+    # @param info [Wx::LogRecordInfo] 
+    # @return [void]
+    def do_log_record(level, msg, info) end
+    
+    # Called to log the specified string at given level.
+    # The base class versions logs debug and trace messages on the system default debug output channel and passes all the other messages to {Wx::Log#do_log_text}.
+    # @param level [Wx::LogLevel] 
+    # @param msg [String] 
+    # @return [void]
+    def do_log_text_at_level(level, msg) end
+    
+    # Called to log the specified string.
+    # A simple implementation might just send the string to stdout or stderr or save it in a file (of course, the already existing {Wx::LogStderr} can be used for this).
+    # The base class version of this function asserts so it must be overridden if you don't override {Wx::Log#do_log_record} or {Wx::Log#do_log_text_at_level}.
+    # @param msg [String] 
+    # @return [void]
+    def do_log_text(msg) end
+    
   end # Log
   
   # {Wx::LogBuffer} is a very simple implementation of log sink which simply collects all the logged messages in a string (except the debug messages which are output in the usual way immediately as we're presumably not interested in collecting them for later).
@@ -278,10 +298,12 @@ module Wx
   # 
   # Category:  {Wx::Logging}
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class LogBuffer < Log
   
     # The default ctor does nothing.
-    # @return [LogBuffer]
+    # @return [Wx::LogBuffer]
     def initialize; end
     
     # Returns the current buffer contains.
@@ -296,15 +318,11 @@ module Wx
   # It is especially useful when you want to divert the logs somewhere (for example to a file or a log window) but also keep showing the error messages using the standard dialogs as {Wx::LogGui} does by default.
   # Example of usage:
   # 
-  # ```
-  #   wxLogChain *logChain = new wxLogChain(new wxLogStderr);
+  # ```ruby
+  #   logChain = Wx::LogChain.new(Wx::LogStderr.new)
   #   
-  #   // all the log messages are sent to stderr and also processed as usually
+  #   # all the log messages are sent to stderr and also processed as usually
   #   ...
-  #   
-  #   // don't delete logChain directly as this would leave a dangling
-  #   // pointer as active log target, use SetActiveTarget() instead
-  #   delete wxLog::SetActiveTarget(...something else or NULL...);
   # ```
   # 
   # === 
@@ -315,36 +333,35 @@ module Wx
   
     # Sets the specified logger (which may be NULL) as the default log target but the log messages are also passed to the previous log target if any.
     # @param logger [Wx::Log] 
-    # @return [LogChain]
+    # @return [Wx::LogChain]
     def initialize(logger) end
     
-    # Detaches the old log target so it won't be destroyed when the {Wx::LogChain} object is destroyed.
-    # @return [void]
-    def detach_old_log; end
-    
     # Returns the pointer to the previously active log target (which may be NULL).
     # @return [Wx::Log]
     def get_old_log; end
     alias_method :old_log, :get_old_log
     
     # Returns true if the messages are passed to the previously active log target (default) or false if {Wx::LogChain#pass_messages} had been called.
-    # @return [true,false]
+    # @return [Boolean]
     def is_passing_messages; end
     alias_method :passing_messages?, :is_passing_messages
     
     # By default, the log messages are passed to the previously active log target.
     # Calling this function with false parameter disables this behaviour (presumably temporarily, as you shouldn't use {Wx::LogChain} at all otherwise) and it can be re-enabled by calling it again with passMessages set to true.
-    # @param passMessages [true,false] 
+    # @param passMessages [Boolean] 
     # @return [void]
     def pass_messages(passMessages) end
     
     # Sets another log target to use (may be NULL).
-    # The log target specified in the {Wx::LogChain#log_chain(wxLog)} constructor or in a previous call to this function is deleted. This doesn't change the old log target value (the one the messages are forwarded to) which still remains the same as was active when {Wx::LogChain} object was created.
+    # The log target specified in the {Wx::LogChain#initialize(wxLog)} constructor or in a previous call to this function is deleted. This doesn't change the old log target value (the one the messages are forwarded to) which still remains the same as was active when {Wx::LogChain} object was created.
     # @param logger [Wx::Log] 
     # @return [void]
     def set_log(logger) end
     alias_method :log=, :set_log
     
+    
+    protected
+    
   end # LogChain
   
   # This is the default log target for the GUI wxWidgets applications.
@@ -357,10 +374,12 @@ module Wx
   # 
   # Category:  {Wx::Logging}
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class LogGui < Log
   
     # Default constructor.
-    # @return [LogGui]
+    # @return [Wx::LogGui]
     def initialize; end
     
   end # LogGui
@@ -373,45 +392,12 @@ module Wx
   # @see Wx::LogStream 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class LogStderr < Log
   
-    # Constructs a log target which sends all the log messages to the given FILE.
-    # If it is NULL, the messages are sent to stderr. The messages will be written in the encoding specified by the given {Wx::MBConv}.
-    # The conv argument is only available in wxWidgets 3.1.1 and later.
-    # In practice, it is only advisable to specify {Wx::ConvUTF8} as the conv. If using <code>mb_conv_utf16</code>, the file should be opened in <code>"wb"</code> mode.
-    # 
-    # If a log message contains any characters that cannot be converted to the character set given by conv, that message will be silently ignored, i.e. it will not be written at all.
-    # @param fp [FILE] 
-    # @param conv [Wx::MBConv] 
-    # @return [LogStderr]
-    def initialize(fp=nil, conv=Wx::ConvWhateverWorks) end
-    
   end # LogStderr
   
-  # This class can be used to redirect the log messages to a C++ stream.
-  # Please note that this class is only available if wxWidgets was compiled with the standard iostream library support ({Wx::Setup::USE_STD_IOSTREAM} must be on).
-  # === 
-  # 
-  # Category:  {Wx::Logging}
-  # @see Wx::LogStderr
-  # @see  Wx::StreamToTextRedirector 
-  # 
-  # 
-  class LogStream < Log
-  
-    # Constructs a log target which sends all the log messages to the given output stream.
-    # If it is NULL, the messages are sent to cerr. The messages will be written in the encoding specified by the given {Wx::MBConv}.
-    # The conv argument is only available in wxWidgets 3.1.1 and later.
-    # In practice, it is only advisable to specify {Wx::ConvUTF8} as the conv. If using <code>mb_conv_utf16</code>, the file should be opened in std::ios::binary mode.
-    # 
-    # If a log message contains any characters that cannot be converted to the character set given by conv, that message will be silently ignored, i.e. it will not be written at all.
-    # @param ostr [std::ostream] 
-    # @param conv [Wx::MBConv] 
-    # @return [LogStream]
-    def initialize(ostr=nil, conv=Wx::ConvWhateverWorks) end
-    
-  end # LogStream
-  
   # Using these target all the log messages can be redirected to a text control.
   # The text control must have been created with {Wx::TE_MULTILINE} style by the caller previously.
   # === 
@@ -421,12 +407,14 @@ module Wx
   # @see  Wx::StreamToTextRedirector 
   # 
   # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
   class LogTextCtrl < Log
   
     # Constructs a log target which sends all the log messages to the given text control.
     # The textctrl parameter cannot be NULL.
     # @param pTextCtrl [Wx::TextCtrl] 
-    # @return [LogTextCtrl]
+    # @return [Wx::LogTextCtrl]
     def initialize(pTextCtrl) end
     
   end # LogTextCtrl
@@ -442,26 +430,11 @@ module Wx
   class LogInterposer < LogChain
   
     # The default constructor installs this object as the current active log target.
-    # @return [LogInterposer]
+    # @return [Wx::LogInterposer]
     def initialize; end
     
   end # LogInterposer
   
-  # A special version of {Wx::LogChain} which uses itself as the new log target.
-  # It forwards log messages to the previously installed one in addition to processing them itself. Unlike {Wx::LogInterposer}, it doesn't delete the old target which means it can be used to temporarily redirect log output.
-  # As per {Wx::LogInterposer}, this class must be derived from to implement {Wx::Log::DoLog} and/or {Wx::Log::DoLogString} methods.
-  # === 
-  # 
-  # Category:  {Wx::Logging}
-  # 
-  class LogInterposerTemp < LogChain
-  
-    # The default constructor installs this object as the current active log target.
-    # @return [LogInterposerTemp]
-    def initialize; end
-    
-  end # LogInterposerTemp
-  
   # This class represents a background log window: to be precise, it collects all log messages in the log frame which it manages but also passes them on to the log target which was active at the moment of its creation.
   # This allows you, for example, to show all the log messages in a frame but still continue to process them normally by showing the standard log dialog.
   # === 
@@ -475,9 +448,9 @@ module Wx
     # Creates the log frame window and starts collecting the messages in it.
     # @param pParent [Wx::Window]  The parent window for the log frame, may be NULL
     # @param szTitle [String]  The title for the log frame
-    # @param show [true,false]  true to show the frame initially (default), otherwise {Wx::LogWindow#show} must be called later.
-    # @param passToOld [true,false]  true to process the log messages normally in addition to logging them in the log frame (default), false to only log them in the log frame. Note that if no targets were set using {Wx::Log.set_active_target} then {Wx::LogWindow} simply becomes the active one and messages won't be passed to other targets.
-    # @return [LogWindow]
+    # @param show [Boolean]  true to show the frame initially (default), otherwise {Wx::LogWindow#show} must be called later.
+    # @param passToOld [Boolean]  true to process the log messages normally in addition to logging them in the log frame (default), false to only log them in the log frame. Note that if no targets were set using {Wx::Log.set_active_target} then {Wx::LogWindow} simply becomes the active one and messages won't be passed to other targets.
+    # @return [Wx::LogWindow]
     def initialize(pParent, szTitle, show=true, passToOld=true) end
     
     # Returns the associated log frame window.
@@ -490,7 +463,7 @@ module Wx
     # Return true from here to allow the frame to close, false to prevent this from happening.
     # @see Wx::LogWindow#on_frame_delete 
     # @param frame [Wx::Frame] 
-    # @return [true,false]
+    # @return [Boolean]
     def on_frame_close(frame) end
     
     # Called right before the log frame is going to be deleted: will always be called unlike {Wx::LogWindow#on_frame_close}.
@@ -499,11 +472,65 @@ module Wx
     def on_frame_delete(frame) end
     
     # Shows or hides the frame.
-    # @param show [true,false] 
+    # @param show [Boolean] 
     # @return [void]
     def show(show=true) end
     
   end # LogWindow
   
+  # This class allows you to temporarily suspend logging.
+  # All calls to the log functions during the life time of an object of this class are just ignored.
+  # In particular, it can be used to suppress the log messages given by wxWidgets itself but it should be noted that it is rarely the best way to cope with this problem as <b>all</b> log messages are suppressed, even if they indicate a completely different error than the one the programmer wanted to suppress.
+  # For instance, the example of the overview:
+  # 
+  # ```ruby
+  #   mime_type = ... # retrieved from somewhere
+  #   img = Wx::Image.new
+  #   Wx::LogNull.no_log do     # suspend logging 
+  # 
+  #     # Wx::Image#load_stream will complain if there is no handler for the given mimetype and fail
+  #     if !img.load_stream(File.open('file.img'), mime_type)
+  #       # handle problem
+  #     end
+  # 
+  #   end # old log sink restored
+  #   
+  #   Wx.log_message('...') # ok
+  # ```
+  # 
+  # would be better written as:
+  # 
+  # ```ruby
+  #   mime_type = ... # retrieved from somewhere
+  # 
+  #   # check the condition that makes your code complain
+  #   if Wx::Image.mime_types.include?(mime_type)
+  #     img.load_stream(File.open('file.img'), mime_type)
+  #     ...
+  #   else
+  #     # do something else
+  #     ...
+  #   end
+  # ```
+  # 
+  # === 
+  # 
+  # Category:  {Wx::Logging}
+  # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  class LogNull < ::Object
+  
+  end # LogNull
+  
+  # Information about a log record (unit of the log output).
+  # 
+  # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  class LogRecordInfo < ::Object
+  
+  end # LogRecordInfo
+  
 
 end

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

@@ -9,7 +9,7 @@ module Wx
   # An MDI client window is a child of {Wx::MDIParentFrame}, and manages zero or more {Wx::MDIChildFrame} objects.
   # The client window is the area where MDI child windows exist. It doesn't have to cover the whole parent frame; other windows such as toolbars and a help window might coexist with it. There can be scrollbars on a client window, which are controlled by the parent window style.
   # The {Wx::MDIClientWindow} class is usually adequate without further derivation, and it is created automatically when the MDI parent frame is created. If the application needs to derive a new class, the function {Wx::MDIParentFrame#on_create_client} must be overridden in order to give an opportunity to use a different class of client window.
-  # Under {Wx::MSW}, the client window will automatically have a sunken border style when the active child is not maximized, and no border style when a child is maximized.
+  # Under wxMSW, the client window will automatically have a sunken border style when the active child is not maximized, and no border style when a child is maximized.
   # === 
   # 
   # Category:  Managed Windows
@@ -22,14 +22,14 @@ module Wx
   
     # Default constructor.
     # Objects of this class are only created by {Wx::MDIParentFrame} which uses the default constructor and calls {Wx::MDIClientWindow#create_client} immediately afterwards.
-    # @return [MDIClientWindow]
+    # @return [Wx::MDIClientWindow]
     def initialize; end
     
     # Called by {Wx::MDIParentFrame} immediately after creating the client window.
     # This function may be overridden in the derived class but the base class version must usually be called first to really create the window.
     # @param parent [Wx::MDIParentFrame]  The window parent.
     # @param style [Integer]  The window style. Only {Wx::HSCROLL} and {Wx::VSCROLL} bits are meaningful here.
-    # @return [true,false]
+    # @return [Boolean]
     def create_client(parent, style=0) end
     
   end # MDIClientWindow

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

@@ -32,12 +32,12 @@ module Wx
     # @overload initialize()
     #   Default constructor.
     #   Use {Wx::MDIParentFrame#create} for the objects created using this constructor.
-    #   @return [MDIParentFrame]
+    #   @return [Wx::MDIParentFrame]
     # @overload initialize(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::DEFAULT_FRAME_STYLE|Wx::VSCROLL|Wx::HSCROLL), name=Wx::FrameNameStr)
     #   Constructor, creating the window.
     #   Notice that if you override virtual {Wx::MDIParentFrame#on_create_client} method you shouldn't be using this constructor but the default constructor and {Wx::MDIParentFrame#create} as otherwise your overridden method is never going to be called because of the usual C++ virtual call resolution rules.
     #   
-    #   Under {Wx::MSW}, the client window will automatically have a sunken border style when the active child is not maximized, and no border style when a child is maximized.
+    #   Under wxMSW, the client window will automatically have a sunken border style when the active child is not maximized, and no border style when a child is maximized.
     #   @see Wx::MDIParentFrame#create
     #   @see  Wx::MDIParentFrame#on_create_client 
     #   @param parent [Wx::Window]  The window parent. Usually is NULL.
@@ -47,7 +47,7 @@ module Wx
     #   @param size [Array(Integer, Integer), Wx::Size]  The window size. The value {Wx::DEFAULT_SIZE} indicates a default size, chosen by either the windowing system or wxWidgets, depending on platform.
     #   @param style [Integer]  The window style. Default value includes {Wx::HSCROLL} and {Wx::VSCROLL} styles.
     #   @param name [String]  The name of the window. This parameter is used to associate a name with the item, allowing the application user to set Motif resource values for individual windows.
-    #   @return [MDIParentFrame]
+    #   @return [Wx::MDIParentFrame]
     def initialize(*args) end
     
     # Activates the MDI child following the currently active one.
@@ -77,7 +77,7 @@ module Wx
     def cascade; end
     
     # Used in two-step frame construction.
-    # See {Wx::MDIParentFrame#mdi_parent_frame} for further details.
+    # See {Wx::MDIParentFrame#initialize} for further details.
     # @param parent [Wx::Window] 
     # @param id [Integer] 
     # @param title [String] 
@@ -85,7 +85,7 @@ module Wx
     # @param size [Array(Integer, Integer), Wx::Size] 
     # @param style [Integer] 
     # @param name [String] 
-    # @return [true,false]
+    # @return [Boolean]
     def create(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::DEFAULT_FRAME_STYLE|Wx::VSCROLL|Wx::HSCROLL), name=Wx::FrameNameStr) end
     
     # Returns a pointer to the active MDI child, if there is one.
@@ -112,9 +112,9 @@ module Wx
     # Override this to return a different kind of client window.
     # If you override this function, you must create your parent frame in two stages, or your function will never be called, due to the way C++ treats virtual functions called from constructors. For example:
     # 
-    # ```
-    #   frame = new MyParentFrame;
-    #   frame->Create(parent, myParentFrameId, "My Parent Frame");
+    # ```ruby
+    #   frame = MyParentFrame.new
+    #   frame.create(parent, myParentFrameId, 'My Parent Frame')
     # ```
     # 
     # You might wish to derive from {Wx::MDIClientWindow} in order to implement different erase behaviour, for example, such as painting a bitmap on the background.
@@ -128,7 +128,13 @@ module Wx
     # Ownership of the menu object passes to the frame when you call this function, i.e. the menu will be deleted by it when it's no longer needed (usually when the frame itself is deleted or when {Wx::MDIParentFrame#set_window_menu} is called again).
     # To remove the window completely, you can use the {Wx::FRAME_NO_WINDOW_MENU} window style but this function also allows doing it by passing NULL pointer as menu.
     # The menu may include the items with the following standard identifiers (but may use arbitrary text and help strings and bitmaps for them):
-    # - {Wx::StandardID::ID_MDI_WINDOW_CASCADE} - {Wx::StandardID::ID_MDI_WINDOW_TILE_HORZ} - {Wx::StandardID::ID_MDI_WINDOW_TILE_VERT} - {Wx::StandardID::ID_MDI_WINDOW_ARRANGE_ICONS} - {Wx::StandardID::ID_MDI_WINDOW_PREV} - {Wx::StandardID::ID_MDI_WINDOW_NEXT} All of which are handled by {Wx::MDIParentFrame} itself. If any other commands are used in the menu, the derived frame should handle them.
+    # 
+    # - {Wx::StandardID::ID_MDI_WINDOW_CASCADE} 
+    # - {Wx::StandardID::ID_MDI_WINDOW_TILE_HORZ} 
+    # - {Wx::StandardID::ID_MDI_WINDOW_TILE_VERT} 
+    # - {Wx::StandardID::ID_MDI_WINDOW_ARRANGE_ICONS} 
+    # - {Wx::StandardID::ID_MDI_WINDOW_PREV} 
+    # - {Wx::StandardID::ID_MDI_WINDOW_NEXT} All of which are handled by {Wx::MDIParentFrame} itself. If any other commands are used in the menu, the derived frame should handle them.
     # 
     # This function is currently not available under macOS.
     # @param menu [Wx::Menu]  The menu to be used instead of the standard MDI Window menu or NULL.
@@ -138,14 +144,14 @@ module Wx
     
     # Tiles the MDI child windows either horizontally or vertically depending on whether orient is {Wx::Orientation::HORIZONTAL} or {Wx::Orientation::VERTICAL}.
     # This method is only implemented in MSW MDI implementation and does nothing under the other platforms.
-    # @param orient [Orientation] 
+    # @param orient [Wx::Orientation] 
     # @return [void]
     def tile(orient=Wx::Orientation::HORIZONTAL) end
     
     # Returns whether the MDI implementation is tab-based.
     # Currently only the MSW port uses the real MDI. In Mac ports the usual SDI is used, as common under this platforms, and all the other ports use TDI implementation.
     # TDI-based MDI applications have different appearance and functionality (e.g. child frames can't be minimized and only one of them is visible at any given time) so the application may need to adapt its interface somewhat depending on the return value of this function.
-    # @return [true,false]
+    # @return [Boolean]
     def self.is_tdi; end
     
   end # MDIParentFrame
@@ -169,7 +175,7 @@ module Wx
   
     # @overload initialize()
     #   Default constructor.
-    #   @return [MDIChildFrame]
+    #   @return [Wx::MDIChildFrame]
     # @overload initialize(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_FRAME_STYLE, name=Wx::FrameNameStr)
     #   Constructor, creating the window.
     #   
@@ -181,7 +187,7 @@ module Wx
     #   @param size [Array(Integer, Integer), Wx::Size]  The window size. The value {Wx::DEFAULT_SIZE} indicates a default size, chosen by either the windowing system or wxWidgets, depending on platform.
     #   @param style [Integer]  The window style. See {Wx::MDIChildFrame}.
     #   @param name [String]  The name of the window. This parameter is used to associate a name with the item, allowing the application user to set Motif resource values for individual windows.
-    #   @return [MDIChildFrame]
+    #   @return [Wx::MDIChildFrame]
     def initialize(*args) end
     
     # Activates this MDI child frame.
@@ -192,7 +198,7 @@ module Wx
     def activate; end
     
     # Used in two-step frame construction.
-    # See {Wx::MDIChildFrame#mdi_child_frame} for further details.
+    # See {Wx::MDIChildFrame#initialize} for further details.
     # @param parent [Wx::MDIParentFrame] 
     # @param id [Integer] 
     # @param title [String] 
@@ -200,7 +206,7 @@ module Wx
     # @param size [Array(Integer, Integer), Wx::Size] 
     # @param style [Integer] 
     # @param name [String] 
-    # @return [true,false]
+    # @return [Boolean]
     def create(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_FRAME_STYLE, name=Wx::FrameNameStr) end
     
     # Returns the MDI parent frame containing this child.
@@ -212,7 +218,7 @@ module Wx
     # Returns true for MDI children in TDI implementations.
     # TDI-based implementations represent MDI children as pages in a {Wx::Notebook} and so they are always maximized and can't be restored or iconized.
     # @see Wx::MDIParentFrame.is_tdi. 
-    # @return [true,false]
+    # @return [Boolean]
     def is_always_maximized; end
     alias_method :always_maximized?, :is_always_maximized
     
@@ -220,7 +226,7 @@ module Wx
     # This function doesn't do anything if {Wx::MDIChildFrame#is_always_maximized} returns true.
     # @see Wx::MDIChildFrame#activate
     # @see  Wx::MDIChildFrame#restore 
-    # @param maximize [true,false] 
+    # @param maximize [Boolean] 
     # @return [void]
     def maximize(maximize=true) end