wxruby3 1.3.1 → 1.5.0

data/lib/wx/core.rb

@@ -38,6 +38,8 @@ require 'wx/global_const'
 # ctor syntax sweeteners support
 require 'wx/keyword_ctors'
 
+require 'wx/core/module_ext'
+
 # Load in all the class extension methods written in ruby
 # evthandler must be required first b/c it sets up methods modified elsewhere
 require 'wx/core/evthandler.rb'

data/lib/wx/doc/evthandler.rb

@@ -99,29 +99,6 @@ module Wx
     # @yieldparam [Wx::CommandEvent] event event to handle
     def evt_command_range(id1, id2, evt_id, meth = nil, &block) end
 
-    # Convenience evt_handler to listen to all mouse events.
-    # @yieldparam [Wx::MouseEvent] event event to handle
-    def evt_mouse_events(*args, &block) end
-
-    # Convenience evt handler to listen to all scrollwin events
-    # (from Wx::ScrolledWindow).
-    # @param [String,Symbol,Method,Proc] meth (name of) method or event handling proc
-    # @yieldparam [Wx::ScrollWinEvent] event event to handle
-    def evt_scrollwin(meth = nil, &block) end
-
-    # Convenience evt handler to listen to all scroll events
-    # (from Wx::Slider and Wx::ScrollBar).
-    # @param [String,Symbol,Method,Proc] meth (name of) method or event handling proc
-    # @yieldparam [Wx::ScrollWinEvent] event event to handle
-    def evt_scroll(meth = nil, &block) end
-
-    # Convenience evt handler to listen to all scroll events
-    # (from Wx::Slider and Wx::ScrollBar) with an id.
-    # @param [Integer] id window identifier
-    # @param [String,Symbol,Method,Proc] meth (name of) method or event handling proc
-    # @yieldparam [Wx::ScrollWinEvent] event event to handle
-    def evt_scroll_command(id, meth = nil, &block) end
-
     # Processes Wx::WindowDestroyEvent events.
     # In wxRuby Wx::Event#skipped will be forced to true after the provided
     # handler has finished to make sure the event is propagated as it is
@@ -143,6 +120,7 @@ module Wx
     def call_after(meth = nil, *args, &block) end
 
     # Process a {Wx::EVT_HOTKEY} event.
+    # @wxrb_require WXOSX|WXMSW
     # @param [Integer] id hotkey id
     # @param [String,Symbol,Method,Proc] meth (name of) method or handler proc
     # @yieldparam [Wx::KeyEvent] event the event to handle

data/lib/wx/doc/tip_window.rb

@@ -0,0 +1,22 @@
+# :stopdoc:
+# Copyright (c) 2023 M.J.N. Corino, The Netherlands
+#
+# This software is released under the MIT license.
+# :startdoc:
+
+
+module Wx
+
+  class TipWindow < Wx::Window
+
+    # Constructor.
+    #
+    # The tip is shown immediately after the window is constructed.
+    # @param [Wx::Window] parent The parent window, must be non-nil
+    # @param [String] text The text to show, may contain the new line characters
+    # @param [Integer] max_length The length of each line, in pixels. Set to a very large value to avoid wrapping lines.
+    def initialize(parent, text, max_length = 100); end
+
+  end
+
+end

data/lib/wx/grid/grid.rb

@@ -13,7 +13,7 @@ module Wx
       alias :table= :assign_table
 
       wx_each_selected_block = instance_method :each_selected_block
-      define_method :each_selected_block do
+      wx_redefine_method :each_selected_block do
         if block_given?
           wx_each_selected_block.bind(self).call
         else
@@ -27,7 +27,7 @@ module Wx
       alias :selected_blocks :get_selected_blocks
 
       wx_each_selected_row_block = instance_method :each_selected_row_block
-      define_method :each_selected_row_block do
+      wx_redefine_method :each_selected_row_block do
         if block_given?
           wx_each_selected_row_block.bind(self).call
         else
@@ -36,7 +36,7 @@ module Wx
       end
 
       wx_each_selected_col_block = instance_method :each_selected_col_block
-      define_method :each_selected_col_block do
+      wx_redefine_method :each_selected_col_block do
         if block_given?
           wx_each_selected_col_block.bind(self).call
         else

data/lib/wx/grid/require.rb

@@ -8,5 +8,3 @@
 require_relative './events/evt_list'
 require_relative './keyword_defs'
 require_relative './grid'
-
-Wx::Dialog.setup_dialog_functors(Wx::GRID)

data/lib/wx/html/htmlhelpcontroller.rb

@@ -14,7 +14,7 @@ module Wx
 
       # cache any explicitly assigned config for GC protection
       wx_use_config = instance_method(:use_config)
-      define_method :use_config do |cfg, *args|
+      wx_redefine_method :use_config do |cfg, *args|
         @configuration = cfg
         if get_help_window
           # also set config var for any associated help window (as wxWidgets propagates it too)

data/lib/wx/html/htmlwindow.rb

@@ -17,7 +17,7 @@ module Wx
         private :html_filters
 
         wx_add_filter = instance_method(:add_filter)
-        define_method(:add_filter) do |filter|
+        wx_redefine_method(:add_filter) do |filter|
           html_filters << filter
           wx_add_filter.bind(self).call(filter)
         end

data/lib/wx/html/require.rb

@@ -10,5 +10,3 @@ require_relative './keyword_defs'
 require_relative './htmlwindow'
 require_relative './htmlhelpcontroller'
 require_relative './simple_html_listbox'
-
-Wx::Dialog.setup_dialog_functors(Wx::HTML)

data/lib/wx/html/simple_html_listbox.rb

@@ -6,7 +6,7 @@ class Wx::HTML::SimpleHtmlListBox
 
   # make sure to honor the inherited common overloads
   wx_get_client_object = instance_method :get_client_object
-  define_method :get_client_object do |*args|
+  wx_redefine_method :get_client_object do |*args|
     if args.empty?
       super()
     else
@@ -14,7 +14,7 @@ class Wx::HTML::SimpleHtmlListBox
     end
   end
   wx_set_client_object = instance_method :set_client_object
-  define_method :set_client_object do |*args|
+  wx_redefine_method :set_client_object do |*args|
     if args.size < 2
       super(*args)
     else
@@ -30,7 +30,7 @@ class Wx::HTML::SimpleHtmlListBox
 
   # Overload to provide Enumerator without block
   wx_each_string = instance_method :each_string
-  define_method :each_string do |&block|
+  wx_redefine_method :each_string do |&block|
     if block
       wx_each_string.bind(self).call(&block)
     else

data/lib/wx/keyword_ctors.rb

@@ -70,6 +70,13 @@ module Wx
     # This module defines an inheritable class attribute like the ones defined
     # by the Rails #class_attribute method.
     module ParamSpec
+
+      if RUBY_VERSION < '2.7.0'
+        PARAM_SPEC_ARG = [:param_spec]
+      else
+        PARAM_SPEC_ARG = [:param_spec, false]
+      end
+
       def self.included(mod)
         mod.class_eval do
           def self.param_spec
@@ -82,9 +89,9 @@ module Wx
 
           def self.param_spec=(val)
             singleton_class.class_eval do
-              if method_defined?(:param_spec) || private_method_defined?(:param_spec)
+              if method_defined?(*PARAM_SPEC_ARG) || private_method_defined?(*PARAM_SPEC_ARG)
                 begin
-                  remove_method(:param_spec);
+                  remove_method(:param_spec)
                 rescue NameError;
                 end
               end
@@ -93,9 +100,9 @@ module Wx
 
             if singleton_class?
               class_eval do
-                if method_defined?(:param_spec) || private_method_defined?(:param_spec)
+                if method_defined?(*PARAM_SPEC_ARG) || private_method_defined?(*PARAM_SPEC_ARG)
                   begin
-                    remove_method(:param_spec);
+                    remove_method(:param_spec)
                   rescue NameError;
                   end
                 end
@@ -108,9 +115,9 @@ module Wx
             val
           end
 
-          if method_defined?(:param_spec) || private_method_defined?(:param_spec)
+          if method_defined?(*PARAM_SPEC_ARG) || private_method_defined?(*PARAM_SPEC_ARG)
             begin
-              remove_method(:param_spec);
+              remove_method(:param_spec)
             rescue NameError;
             end
           end
@@ -191,7 +198,7 @@ module Wx
         # The new definition of initialize; accepts a parent arg
         # mixed_args, which may zero or more position args, optionally
         # terminated with hash keyword args, and an optional block
-        def initialize(parent = :default_ctor, *mixed_args, &block)
+        wx_redefine_method :initialize do |parent = :default_ctor, *mixed_args, &block|
           # allow zero-args ctor for use with XRC
           if parent == :default_ctor
             pre_wx_kwctor_init

data/lib/wx/keyword_defs.rb

@@ -61,13 +61,13 @@ end
 # MISCELLANEOUS WINDOWS
 
 # OpenGL Canvas
-Wx::define_keyword_ctors('GLCanvas') do
-  wx_ctor_params :id
-  wx_ctor_params :pos, :size, :style => Wx::FULL_REPAINT_ON_RESIZE
-  wx_ctor_params :name => 'GLCanvas'
-  wx_ctor_params :attrib_list => [Wx::GL_RGBA, Wx::GL_DOUBLEBUFFER]
-  wx_ctor_params :palette => Wx::NULL_PALETTE
-end
+# Wx::define_keyword_ctors('GLCanvas') do
+#   wx_ctor_params :id
+#   wx_ctor_params :pos, :size, :style => Wx::FULL_REPAINT_ON_RESIZE
+#   wx_ctor_params :name => 'GLCanvas'
+#   wx_ctor_params :attrib_list => [Wx::GL_RGBA, Wx::GL_DOUBLEBUFFER]
+#   wx_ctor_params :palette => Wx::NULL_PALETTE
+# end
 
 # A window whose colour changes according to current user settings
 Wx::define_keyword_ctors(Wx::Panel) do

data/lib/wx/pg/pg_properties.rb

@@ -10,7 +10,7 @@ module Wx::PG
 
     # add some 'smart' conversions
     wx_initialize = instance_method :initialize
-    define_method :initialize do |label=Wx::PG_LABEL, name=Wx::PG_LABEL, value=Wx::PG::ColourPropertyValue.new|
+    wx_redefine_method :initialize do |label=Wx::PG_LABEL, name=Wx::PG_LABEL, value=Wx::PG::ColourPropertyValue.new|
       value = case value
               when Wx::Colour
                 Wx::PG::ColourPropertyValue.new(value)

data/lib/wx/pg/pg_property.rb

@@ -29,7 +29,7 @@ module Wx::PG
   class PGProperty
 
     wx_each_attribute = instance_method :each_attribute
-    define_method :each_attribute do
+    wx_redefine_method :each_attribute do
       if block_given?
         wx_each_attribute.bind(self).call
       else
@@ -52,7 +52,7 @@ module Wx::PG
   class PGChoices
 
     wx_each_label = instance_method :each_label
-    define_method :each_label do
+    wx_redefine_method :each_label do
       if block_given?
         wx_each_label.bind(self).call
       else
@@ -61,7 +61,7 @@ module Wx::PG
     end
 
     wx_each_entry = instance_method :each_entry
-    define_method :each_entry do
+    wx_redefine_method :each_entry do
       if block_given?
         wx_each_entry.bind(self).call
       else

data/lib/wx/pg/property_grid.rb

@@ -29,7 +29,7 @@ module Wx::PG
       private :property_editors
 
       wx_do_register_editor_class = self.instance_method(:do_register_editor_class)
-      define_method(:do_register_editor_class) do |editor_class, name|
+      wx_redefine_method(:do_register_editor_class) do |editor_class, name|
         editor = wx_do_register_editor_class.bind(self).call(editor_class, name)
         property_editors[name] = editor # keep safe from GC and for lookup
       end
@@ -44,7 +44,7 @@ module Wx::PG
     end
 
     wx_set_sorter = instance_method :set_sorter
-    define_method :set_sorter do |meth, &block|
+    wx_redefine_method :set_sorter do |meth, &block|
       h_sorter = if block and not meth
                    block
                  elsif meth and not block

data/lib/wx/pg/property_grid_interface.rb

@@ -20,7 +20,7 @@ module Wx::PG
   module PropertyGridInterface
 
     wx_each_property = instance_method :each_property
-    define_method :each_property do |flags = Wx::PG::PG_ITERATE_DEFAULT, start = nil, reverse: false, &block|
+    wx_redefine_method :each_property do |flags = Wx::PG::PG_ITERATE_DEFAULT, start = nil, reverse: false, &block|
       if block
         wx_each_property.bind(self).call(flags.to_int, start, reverse, &block)
       else
@@ -35,7 +35,7 @@ module Wx::PG
     alias :properties_reversed :reverse_each_property
 
     wx_each_property_attribute = instance_method :each_property_attribute
-    define_method :each_property_attribute do |id, &block|
+    wx_redefine_method :each_property_attribute do |id, &block|
       if block
         wx_each_property_attribute.bind(self).call(id, &block)
       else

data/lib/wx/pg/require.rb

@@ -11,5 +11,3 @@ require_relative './property_grid'
 require_relative './pg_property'
 require_relative './pg_properties'
 require_relative './pg_editor'
-
-Wx::Dialog.setup_dialog_functors(Wx::PG)

data/lib/wx/prt/previewframe.rb

@@ -11,7 +11,7 @@ class Wx::PRT::PreviewFrame
   # to assign it to an instance variable so it is marked correctly when
   # the frame displaying it is marked.
   wx_init = self.instance_method(:initialize)
-  define_method(:initialize) do | *args |
+  wx_redefine_method(:initialize) do | *args |
     wx_init.bind(self).call(*args)
     @__preview = args[0]
   end

data/lib/wx/prt/require.rb

@@ -7,5 +7,3 @@
 require_relative './keyword_defs'
 require_relative './previewframe'
 require_relative './page_setup_dialog'
-
-Wx::Dialog.setup_dialog_functors(Wx::PRT)

data/lib/wx/rbn/ribbon_control.rb

@@ -6,7 +6,7 @@ class Wx::RBN::RibbonControl
 
   # manage RibbonArtProvider for GC
   wx_set_art_provider = instance_method :set_art_provider
-  define_method :set_art_provider do |prov|
+  wx_redefine_method :set_art_provider do |prov|
     @art_provider = nil # clear any previously set
     wx_set_art_provider.bind(self).call(prov)
     if prov != get_ancestor_ribbon_bar.get_art_provider

data/lib/wx/rbn/ribbon_page.rb

@@ -6,7 +6,7 @@ class Wx::RBN::RibbonPage
 
   # manage RibbonArtProvider for GC
   wx_set_art_provider = instance_method :set_art_provider
-  define_method :set_art_provider do |prov|
+  wx_redefine_method :set_art_provider do |prov|
     @art_provider = nil # clear any previously set
     wx_set_art_provider.bind(self).call(prov)
     if prov != get_ancestor_ribbon_bar.get_art_provider

data/lib/wx/rbn/ribbon_panel.rb

@@ -6,7 +6,7 @@ class Wx::RBN::RibbonPanel
 
   # manage RibbonArtProvider for GC
   wx_set_art_provider = instance_method :set_art_provider
-  define_method :set_art_provider do |prov|
+  wx_redefine_method :set_art_provider do |prov|
     @art_provider = nil # clear any previously set
     wx_set_art_provider.bind(self).call(prov)
     if prov != get_ancestor_ribbon_bar.get_art_provider

data/lib/wx/rtc/require.rb

@@ -14,5 +14,3 @@ require_relative './rich_text_paragraph'
 require_relative './richtext_formatting_dialog'
 require_relative './symbol_picker_dialog'
 require_relative './richtext_style_organiser_dialog'
-
-Wx::Dialog.setup_dialog_functors(Wx::RTC)

data/lib/wx/rtc/rich_text_composite_object.rb

@@ -10,7 +10,7 @@ module Wx
 
       # Overload to provide Enumerator without block
       wx_each_child = instance_method :each_child
-      define_method :each_child do |&block|
+      wx_redefine_method :each_child do |&block|
         if block
           wx_each_child.bind(self).call(&block)
         else

data/lib/wx/rtc/rich_text_ctrl.rb

@@ -10,7 +10,7 @@ module Wx
 
       # Overload to provide Enumerator without block
       wx_each_line = instance_method :each_line
-      define_method :each_line do |&block|
+      wx_redefine_method :each_line do |&block|
         if block
           wx_each_line.bind(self).call(&block)
         else

data/lib/wx/rtc/rich_text_paragraph.rb

@@ -10,7 +10,7 @@ module Wx
 
       # Overload to provide Enumerator without block
       wx_each_line = instance_method :each_line
-      define_method :each_line do |&block|
+      wx_redefine_method :each_line do |&block|
         if block
           wx_each_line.bind(self).call(&block)
         else

data/lib/wx/rtc/richtext_buffer.rb

@@ -6,7 +6,7 @@ class Wx::RTC::RichTextBuffer
 
   class << self
     wx_each_handler = instance_method :each_handler
-    define_method :each_handler do |&block|
+    wx_redefine_method :each_handler do |&block|
       if block_given?
         wx_each_handler.bind(self).call(&block)
       else
@@ -15,7 +15,7 @@ class Wx::RTC::RichTextBuffer
     end
 
     wx_each_field_type = instance_method :each_field_type
-    define_method :each_field_type do |&block|
+    wx_redefine_method :each_field_type do |&block|
       if block_given?
         wx_each_field_type.bind(self).call(&block)
       else
@@ -24,7 +24,7 @@ class Wx::RTC::RichTextBuffer
     end
 
     wx_each_drawing_handler = instance_method :each_drawing_handler
-    define_method :each_drawing_handler do |&block|
+    wx_redefine_method :each_drawing_handler do |&block|
       if block_given?
         wx_each_drawing_handler.bind(self).call(&block)
       else

data/lib/wx/rtc/richtext_formatting_dialog.rb

@@ -8,7 +8,7 @@ module Wx::RTC
     class << self
 
       wx_set_formatting_dialog_factory = instance_method :set_formatting_dialog_factory
-      define_method :set_formatting_dialog_factory do |factory|
+      wx_redefine_method :set_formatting_dialog_factory do |factory|
         wx_set_formatting_dialog_factory.bind(self).call(factory)
         @factory = factory # cache here to prevent GC collection
       end
@@ -23,7 +23,7 @@ module Wx::RTC
     end
 
     # now redefine the overridden ctor to account for deviating arglist
-    def initialize(flags = nil, parent = nil, *mixed_args, &block)
+    wx_redefine_method :initialize do |flags = nil, parent = nil, *mixed_args, &block|
       # allow zero-args ctor for use with XRC
       if flags.nil?
         pre_wx_kwctor_init

data/lib/wx/rtc/richtext_style_organiser_dialog.rb

@@ -12,7 +12,7 @@ class Wx::RTC::RichTextStyleOrganiserDialog
   end
 
   # now redefine the overridden ctor to account for deviating arglist
-  def initialize(flags, sheet, ctrl, parent = nil, *mixed_args, &block)
+  wx_redefine_method :initialize do |flags, sheet, ctrl, parent = nil, *mixed_args, &block|
     real_args = begin
                   [ flags, sheet, ctrl, parent ] + self.class.args_as_list(*mixed_args)
                 rescue => err

data/lib/wx/rtc/symbol_picker_dialog.rb

@@ -13,7 +13,7 @@ class Wx::RTC::SymbolPickerDialog
   end
 
   # now redefine the overridden ctor to account for deviating arglist
-  def initialize(symbol, initialFont, normalTextFont, parent = nil, *mixed_args, &block)
+  wx_redefine_method :initialize do |symbol, initialFont, normalTextFont, parent = nil, *mixed_args, &block|
     real_args = begin
                   [ symbol, initialFont, normalTextFont, parent ] + self.class.args_as_list(*mixed_args)
                 rescue => err

data/lib/wx/stc/require.rb

@@ -7,5 +7,3 @@
 require_relative './events/evt_list'
 require_relative './keyword_defs'
 require_relative './styled_text_ctrl'
-
-Wx::Dialog.setup_dialog_functors(Wx::STC)

data/lib/wx/stc/styled_text_ctrl.rb

@@ -10,7 +10,7 @@ module Wx
 
       # Overload to provide Enumerator without block
       wx_each_line = instance_method :each_line
-      define_method :each_line do |&block|
+      wx_redefine_method :each_line do |&block|
         if block
           wx_each_line.bind(self).call(&block)
         else

data/lib/wx/version.rb

@@ -3,5 +3,5 @@
 # This software is released under the MIT license.
 
 module Wx
-  WXRUBY_VERSION    = '1.3.1'
+  WXRUBY_VERSION    = '1.5.0'
 end

data/lib/wx/wxruby/base.rb

@@ -55,6 +55,10 @@ module WxRuby
         puts
       end
 
+      def show_version
+        system(%Q[#{RUBY} -r wx -e 'puts "wxRuby3 v\#{Wx::WXRUBY_VERSION} (wxWidgets v\#{Wx::WXWIDGETS_VERSION})"' 2> /dev/null])
+      end
+
       def run(cmdid, args)
         commands[cmdid.to_s].call(args)
       end
@@ -65,9 +69,11 @@ module WxRuby
             "    COMMAND\t\t\t\tSpecifies wxruby command to execute."
         opts.separator ''
         opts.on('-v', '--verbose',
-                'Show verbose output') { |v| ::WxRuby::Commands.options[:verbose] = true }
+                'Show verbose output') { |_| ::WxRuby::Commands.options[:verbose] = true }
+        opts.on('-V', '--version',
+                'Show versions.') { |_| show_version } if setup_done?
         opts.on('-h', '--help',
-                 'Show this message.') do |v|
+                 'Show this message.') do |_|
           puts opts
           puts
           describe_all

data/lib/wx/wxruby/cmd/setup.rb

@@ -6,6 +6,7 @@
 #--------------------------------------------------------------------
 
 require 'fileutils'
+require 'json'
 
 module WxRuby
   module Commands
@@ -55,6 +56,16 @@ module WxRuby
         opts.parse!(args) rescue ($stderr.puts $!.message; exit(127))
       end
 
+      class << self
+
+        private
+
+        def check_wx_config
+          !(`which #{@wx_config} 2>/dev/null`).chomp.empty?
+        end
+
+      end
+
       def self.run(argv)
         return description if argv == :describe
 
@@ -74,48 +85,61 @@ module WxRuby
         cfg_cmd = 'rake configure'
         cfg_cmd << "[#{cfg_args.join(',')}]" unless cfg_args.empty?
 
-        result = false
-        FileUtils.chdir(WxRuby::ROOT) do
-          steps = 0
-          actions_txt = if Setup.options['autoinstall'] != false
-                          steps = 1
-                          '(possibly) install required software'
-                        else
-                          ''
-                        end
-          if Setup.options['with-wxwin'] || Setup.options['wxwin'].nil?
-            actions_txt << ', ' if steps>0
-            actions_txt << 'build the wxWidgets libraries (if needed), '
-            actions_txt << "\n" if steps>0
-            steps += 1
+        log_file = File.join(WxRuby::ROOT, 'setup.log')
+        if Setup.options['log']
+          if File.directory?(Setup.options['log']) && File.writable?(Setup.options['log'])
+            log_file = File.join(Setup.options['log'], 'setup.log')
           else
-            actions_txt << ',' if steps>0
+            $stderr.puts "ERROR: cannot write log to #{Setup.options['log']}. Log path must exist and be writable."
+            exit(1)
           end
-          actions_txt << 'build the native wxRuby3 extensions '
-          actions_txt << "\n" if steps==1
-          actions_txt << 'and generate the wxRuby3 reference documentation.'
-          $stdout.puts <<~__INFO_TXT
-
-            ---            
-            Now running wxRuby3 post-install setup.
-            This will #{actions_txt}
-            Please be patient as this may take quite a while depending on your system.
-            ---
-
-            __INFO_TXT
-          log_file = File.join(WxRuby::ROOT, 'setup.log')
-          if Setup.options['log']
-            if File.directory?(Setup.options['log']) && File.writable?(Setup.options['log'])
-              log_file = File.join(Setup.options['log'], 'setup.log')
+        end
+        run_env = {'WXRUBY_RUN_SILENT' => "#{log_file}"}
+        run_env['WXRUBY_VERBOSE'] = '1' if Setup.options[:verbose]
+
+        result = false
+
+        FileUtils.chdir(WxRuby::ROOT) do
+          # first run the configure command
+          result = system(run_env, "#{cfg_cmd}")
+
+          # if succeeded
+          if result
+            # load the wxRuby3 build config
+            build_cfg = ::JSON.load(File.read('.wxconfig'))
+
+            # now determine the steps to execute
+            steps = 0
+            actions_txt = if Setup.options['autoinstall'] != false
+                            steps = 1
+                            '(possibly) install required software'
+                          else
+                            ''
+                          end
+            if build_cfg['with-wxwin'] || (!build_cfg['wxwin'].to_s.empty? && build_cfg['wxwin'].to_s != '@system')
+              actions_txt << ', ' if steps>0
+              actions_txt << 'build the wxWidgets libraries, '
+              actions_txt << "\n" if steps>0
+              steps += 1
             else
-              $stderr.puts "ERROR: cannot write log to #{Setup.options['log']}. Log path must exist and be writable."
-              exit(1)
+              actions_txt << ',' if steps>0
             end
+            actions_txt << 'build the native wxRuby3 extensions '
+            actions_txt << "\n" if steps==1
+            actions_txt << 'and generate the wxRuby3 reference documentation.'
+            $stdout.puts <<~__INFO_TXT
+  
+              ---            
+              Now running wxRuby3 post-install setup.
+              This will #{actions_txt}
+              Please be patient as this may take quite a while depending on your system.
+              (#{steps >= 2 ? '10-15' : '5-10'} min on a modern PC with multicore CPU but longer with older/slower CPUs)
+              ---
+  
+              __INFO_TXT
+            # can't rely on FileUtils#chdir returning the block result (bug in older Rubies) so assign result here
+            result = system(run_env, "rake -m wxruby:gem:setup#{Setup.options['log'] ? '[:keep_log]' : ''} && gem rdoc wxruby3 --overwrite")
           end
-          run_env = {'WXRUBY_RUN_SILENT' => "#{log_file}"}
-          run_env['WXRUBY_VERBOSE'] = '1' if Setup.options[:verbose]
-          # can't rely on FileUtils#chdir returning the block result (bug in older Rubies) so assign result here
-          result = system(run_env, "#{cfg_cmd} && rake -m wxruby:gem:setup#{Setup.options['log'] ? '[:keep_log]' : ''} && gem rdoc wxruby3 --overwrite")
         end
         exit(result ? 0 : 1)
       end