Mxx_ru 1.2.1 → 1.3.0

data/lib/mxx_ru/cpp/target.rb

@@ -33,7 +33,7 @@ require 'mxx_ru/cpp/obj_placement'
 require 'mxx_ru/cpp/analyzer'
 
 # Base class for all targets of C/C++ projects.
-module Mxx_ru
+module MxxRu
 
   module Cpp
     # Runtime mode types.
@@ -90,7 +90,7 @@ module Mxx_ru
     # Auxiliary class, intended to store objects like
     # runtime_mode, rtl_mode, etc, with information about
     # who has set this or that mode.
-    class Global_single_value_option
+    class GlobalSingleValueOption
       attr_reader :name
       attr_reader :default_value
       attr_reader :value
@@ -153,7 +153,7 @@ module Mxx_ru
             # Value is already changed. It is necessary to be convinced,
             # that values are the same. Otherwise there is a conflict.
             if a_value != @value
-              raise Mxx_ru::Global_option_conflict_ex.new(
+              raise MxxRu::GlobalOptionConflictEx.new(
                 @name, @value, @who, a_value, a_who )
             end
           end
@@ -165,33 +165,38 @@ module Mxx_ru
       # not found.
       def check_value( value, who )
         if !@available_values.include?( value )
-          raise Mxx_ru::Global_option_disallowed_value_ex.new(
+          raise MxxRu::GlobalOptionDisallowedValueEx.new(
             @name, @available_values, value, who )
         end
       end
-    end # class Global_single_value_option
+    end # class GlobalSingleValueOption
+
+    # For compatibility with previous versions.
+    Global_single_value_option = GlobalSingleValueOption
 
     # Auxiliary class for a storage of options, which can be broken on 3 groups:
     # global, local and upspread.
     # Examples of such options are: defines, include_paths,
     # compiler_options, linker_options, ...
-    class Spreadable_option
+    class SpreadableOption
       # A name of a method, which should be used for reception of all options.
       ALL_OPT_METHOD = "all"
-      # A name of a method, which should be used for reception of all upspread options.
+      # A name of a method, which should be used for reception of all upspread
+      # options.
       ALL_UPSPREAD_METHOD = "all_upspreads"
 
-      # The global tick counter which is used for check that cached values are still correct.
-      # Is increased at each reference to add.
+      # The global tick counter which is used for check that cached values are
+      # still correct.  Is increased at each reference to add.
       @@last_change_time = 1
-      # Global hash, in which the time of last change of options with a concrete name is fixed.
+      # Global hash, in which the time of last change of options with a
+      # concrete name is fixed.
       @@cache_times = Hash.new
 
-      # Set new time of change of value of an option.
-      # This method is intended for use at change of global options, which are stored
-      # separately from spreadable-options, but which values are included 
-      # in values of spreadable-options.
-      def Spreadable_option.refresh_option_change_time( a_option_name )
+      # Set new time of change of value of an option.  This method is intended
+      # for use at change of global options, which are stored separately from
+      # spreadable-options, but which values are included in values of
+      # spreadable-options.
+      def SpreadableOption.refresh_option_change_time( a_option_name )
         @@last_change_time = @@last_change_time + 1
         @@cache_times[ a_option_name ] = @@last_change_time
       end 
@@ -229,11 +234,11 @@ module Mxx_ru
       #
       # [_a_option_] Added value.
       # [_a_mode_] Local or upspread option.
-      #            Is set by values Mxx_ru::Cpp::Target::OPT_LOCAL,
-      #            Mxx_ru::Cpp::Target::OPT_UPSPEAD.
+      #            Is set by values MxxRu::Cpp::Target::OPT_LOCAL,
+      #            MxxRu::Cpp::Target::OPT_UPSPEAD.
       def add(
         a_option,
-        a_mode = Mxx_ru::Cpp::Target::OPT_LOCAL )
+        a_mode = MxxRu::Cpp::Target::OPT_LOCAL )
         add_unique_to( a_option, check_opt_mode( a_mode ) )
       end
 
@@ -244,11 +249,13 @@ module Mxx_ru
 
       # To generate the list of all options.
       #
-      # [_a_globals_] The storage of global options, from which is necessary to take values.
+      # [_a_globals_] The storage of global options, from which is necessary
+      #               to take values.
       # [_a_subprojects_] The list of all subordinated projects.
-      #                   Array of Mxx_ru::Abstract_target.
-      # [_a_upspreads_method_] The name of a method, which needs to be called from
-      #                        the subordinated project, to get it's list of all upspread options.
+      #                   Array of MxxRu::AbstractTarget.
+      # [_a_upspreads_method_] The name of a method, which needs to be called
+      #                        from the subordinated project, to get it's list
+      #                        of all upspread options.
       def all(
         a_globals,
         a_subprojects,
@@ -260,19 +267,7 @@ module Mxx_ru
           r << a_globals << @locals
 
           # At the same time it is possible to update cache of upspread-options.
-          if @all_upspread_cache_time < @@cache_times[ @name ]
-            u = Array.new
-            u << @upspreads
-            
-            a_subprojects.each { |p|
-              if p.kind_of?( Mxx_ru::Cpp::Target )
-                u << p.send( a_upspreads_method )
-              end
-            }
-
-            @all_upspread_cache_time = @@last_change_time
-            @all_upspread_cache_value = u.flatten.uniq
-          end
+          try_update_upspread_options( a_subprojects, a_upspreads_method )
 
           r << @all_upspread_cache_value
             
@@ -286,27 +281,15 @@ module Mxx_ru
       # To generate the list of all upspread options.
       #
       # [_a_subprojects_] The list of all subordinated projects.
-      #                   Array of Mxx_ru::Abstract_target.
-      # [_a_upspreads_method_] The name of a method, which needs to be called from
-      #                        the subordinated project, to get it's list of all upspread options.
+      #                   Array of MxxRu::AbstractTarget.
+      # [_a_upspreads_method_] The name of a method, which needs to be called
+      #                        from the subordinated project, to get it's list
+      #                        of all upspread options.
       def all_upspreads(
         a_subprojects,
         a_upspreads_method )
 
-        if @all_upspread_cache_time < @@cache_times[ @name ]
-          # It is necessary to calculate cache anew.
-          r = Array.new
-          r << @upspreads
-   
-          a_subprojects.each { |p|
-            if p.kind_of?( Mxx_ru::Cpp::Target )
-              r << p.send( a_upspreads_method )
-            end
-          }
-   
-          @all_upspread_cache_value = r.flatten.uniq
-          @all_upspread_cache_time = @@last_change_time
-        end
+        try_update_upspread_options( a_subprojects, a_upspreads_method )
 
         return @all_upspread_cache_value
       end
@@ -317,7 +300,7 @@ module Mxx_ru
         if !to.include?( what )
           to.push( what )
 
-          Spreadable_option::refresh_option_change_time( @name )
+          SpreadableOption::refresh_option_change_time( @name )
         end
       end
 
@@ -328,27 +311,53 @@ module Mxx_ru
       # [_a_mode_] mode parameter value for check.
       def check_opt_mode(
         a_mode )
-        if Mxx_ru::Cpp::Target::OPT_UPSPREAD == a_mode
+        if MxxRu::Cpp::Target::OPT_UPSPREAD == a_mode
           return @upspreads
-        elsif Mxx_ru::Cpp::Target::OPT_LOCAL == a_mode
+        elsif MxxRu::Cpp::Target::OPT_LOCAL == a_mode
           return @locals
         else
-          raise Mxx_ru::Invalid_value_ex.new(
+          raise MxxRu::InvalidValueEx.new(
             "invalid option mode #{a_mode}" )
         end
       end
-    end
+      
+      # Checks upspread options cache time and updates upspread
+      # options if needed.
+      def try_update_upspread_options( subprojects, upspreads_method )
+        if @all_upspread_cache_time < @@cache_times[ @name ]
+          # It is necessary to calculate cache anew.
+          r = Array.new
+          r << @upspreads
+   
+          subprojects.each { |p|
+            if p.kind_of?( MxxRu::Cpp::Target )
+              r << p.send( upspreads_method )
+            end
+          }
+   
+          @all_upspread_cache_value = r.flatten.uniq
+          @all_upspread_cache_time = @@last_change_time
+        end
+      end
+
+    end # class SpreadableOption
+
+    # For compatibility with previous versions.
+    Spreadable_option = SpreadableOption
 
     # Target type (exe, lib, dll, unittest, composite etc.).
     # The real type of the target is defined by a derivative class.
-    class Target_type
+    class TargetType
       def name
-        raise Abstract_method_ex.new( "Mxx_ru::Cpp::Target_type::name" )
+        raise AbstractMethodEx.new( "MxxRu::Cpp::TargetType::name" )
       end
     end
 
+    # For compatibility with previous versions.
+    Target_type = TargetType
+
     # Target type is application.
-    class Exe_target_type < Target_type
+    class ExeTargetType < TargetType
       TYPE = "exe"
 
       def name
@@ -356,8 +365,11 @@ module Mxx_ru
       end
     end
 
+    # For compatibility with previous versions.
+    Exe_target_type = ExeTargetType
+
     # Target type is static library (lib).
-    class Lib_target_type < Target_type
+    class LibTargetType < TargetType
       TYPE = "lib"
 
       def name
@@ -365,8 +377,11 @@ module Mxx_ru
       end
     end
 
+    # For compatibility with previous versions.
+    Lib_target_type = LibTargetType
+
     # Target type is shared library (dll).
-    class Dll_target_type < Target_type
+    class DllTargetType < TargetType
       TYPE = "dll"
 
       def name
@@ -374,11 +389,14 @@ module Mxx_ru
       end
     end
 
+    # For compatibility with previous versions.
+    Dll_target_type = DllTargetType
+
     # Base class for all targets of C/C++ projects.
-    class Target < Mxx_ru::Binary_target
+    class Target < MxxRu::BinaryTarget
       # Description of obj_placement object installed.
       # Used to store global obj_placement.
-      class Global_obj_placement_info
+      class GlobalObjPlacementInfo
         # Global obj_placement.
         attr_reader :placement
         # Who was set obj_placement.
@@ -393,7 +411,7 @@ module Mxx_ru
         # If placement already set, exception thrown.
         def change( a_placement, a_who )
           if nil != a_placement && nil != @placement
-            raise Mxx_ru::Global_option_conflict_ex.new(
+            raise MxxRu::GlobalOptionConflictEx.new(
               "global_obj_placement",
               @placement.class.name,
               @who,
@@ -404,14 +422,17 @@ module Mxx_ru
           @placement = a_placement
           @who = a_who
         end
-      end
+      end # class GlobalObjPlacementInfo
+
+      # For compatibility with previous versions.
+      Global_obj_placement_info = GlobalObjPlacementInfo
 
       # Action class to store option in Array.
-      class Global_option_inserter
+      class GlobalOptionInserter
 
         # [_a_option_name_] Name of option served. It is necessary for
         #                   referecne to 
-        #                   Spreadable_option.refresh_option_change_time
+        #                   SpreadableOption.refresh_option_change_time
         #                   method.
         # [_a_receiver_] Where to add value.
         def initialize(
@@ -424,12 +445,15 @@ module Mxx_ru
         def call( *args )
           @receiver.push( *args )
 
-          Spreadable_option::refresh_option_change_time( @option_name )
+          SpreadableOption::refresh_option_change_time( @option_name )
         end
-      end # class Global_option_inserter
+      end # class GlobalOptionInserter
+
+      # For compatibility with previous versions.
+      Global_option_inserter = GlobalOptionInserter
 
-      # Action class to store option in Spreadable_option object.
-      class Spreadable_option_inserter
+      # Action class to store option in SpreadableOption object.
+      class SpreadableOptionInserter
 
         # [_a_receiver_] Where to add value.
         def initialize(
@@ -438,13 +462,16 @@ module Mxx_ru
         end
 
         def call( *args )
-          @receiver.send( "add", *args )
+          @receiver.send( :add, *args )
         end
-      end # class Spreadable_option_inserter
+      end # class SpreadableOptionInserter
+
+      # For compatibility with previous versions.
+      Spreadable_option_inserter = SpreadableOptionInserter
 
       # Action class to get all option values (local, global and upspread)
-      # from Spreadable_option object.
-      class Spreadable_option_all_extractor
+      # from SpreadableOption object.
+      class SpreadableOptionAllExtractor
 
         # [_a_option_] In whom to call a "call" method.
         # [_a_globals_] Whence to take values of global options.
@@ -469,11 +496,14 @@ module Mxx_ru
           return @option.all( @globals, @target.mxx_required_prjs,
             @upspreads_only_method )
         end
-      end # class Spreadable_option_all_extractor
+      end # class SpreadableOptionAllExtractor
+
+      # For compatibility with previous versions.
+      Spreadable_option_all_extractor = SpreadableOptionAllExtractor
 
       # Action class to get upspreadable option values only
-      # from Spreadable_option object.
-      class Spreadable_option_upspread_extractor
+      # from SpreadableOption object.
+      class SpreadableOptionUpspreadExtractor
 
         # [_a_option_] In whom to call a "call" method.
         # [_a_target_] The target, from which is necessary to take the list
@@ -495,27 +525,30 @@ module Mxx_ru
           return @option.all_upspreads( @target.mxx_required_prjs,
             @upspreads_only_method )
         end
-      end # class Spreadable_option_all_extractor
+      end # class SpreadableOptionAllExtractor
+
+      # For compatibility with previous versions.
+      Spreadable_option_upspread_extractor = SpreadableOptionUpspreadExtractor
 
       # Runtime mode storage.
-      @@mxx_runtime_mode = Global_single_value_option.new(
+      @@mxx_runtime_mode = GlobalSingleValueOption.new(
         "runtime_mode", RUNTIME_DEFAULT,
         [ RUNTIME_RELEASE, RUNTIME_DEBUG ] )
       # RTTI mode storage.
-      @@mxx_rtti_mode = Global_single_value_option.new(
+      @@mxx_rtti_mode = GlobalSingleValueOption.new(
         "rtti_mode", RTTI_DEFAULT,
         [ RTTI_ENABLED, RTTI_DISABLED ] )
       # RTL mode storage.
-      @@mxx_rtl_mode = Global_single_value_option.new(
+      @@mxx_rtl_mode = GlobalSingleValueOption.new(
         "rtl_mode", RTL_DEFAULT,
         [ RTL_SHARED, RTL_STATIC ] )
       # Threading mode storage.
-      @@mxx_threading_mode = Global_single_value_option.new(
+      @@mxx_threading_mode = GlobalSingleValueOption.new(
         "threading_mode", THREADING_DEFAULT,
         [ THREADING_MULTI, THREADING_SINGLE ] )
 
       # The storage of global description of obj_placement.
-      @@mxx_global_obj_placement = Global_obj_placement_info.new
+      @@mxx_global_obj_placement = GlobalObjPlacementInfo.new
 
       # Global options storage.
       # The key is a String, the value is Array of String.
@@ -528,22 +561,26 @@ module Mxx_ru
 
       # Path, the name of result of a target is related to.
       # If contains an empty value, target should be defined using a full path.
-      # Otherwise the value of mxx_target_root is concatenated with a given target name.
+      # Otherwise the value of mxx_target_root is concatenated with a given
+      # target name.
       attr_reader :mxx_target_root
+      # Custom extension for target.
+      # NIL, if custom extension not defined.
+      attr_reader :mxx_target_ext
       # Path, the names of source files are related to.
       attr_reader :mxx_sources_root
       # Screen mode. Console by default.
       attr_reader :mxx_screen_mode
       # The list of source C-files.
-      # Array of Mxx_ru::Cpp::Cpp_source_file objects.
+      # Array of MxxRu::Cpp::CppSourceFile objects.
       attr_reader :mxx_c_files
       # The list of source C++-files.
-      # Array of Mxx_ru::Cpp::Cpp_source_file objects.
+      # Array of MxxRu::Cpp::CppSourceFile objects.
       attr_reader :mxx_cpp_files
       # Object files list.
       attr_reader :mxx_obj_files
       # Name of mswin resource file.
-      # Should be object of Mxx-ru::Cpp::Mswin_rc_file type.
+      # Should be object of MxxRu::Cpp::MswinRcFile type.
       # May contain nil value, if resources are not used.
       attr_reader :mxx_mswin_rc_file
       # The name of compiled mswin resource file.
@@ -595,6 +632,8 @@ module Mxx_ru
 
         @mxx_target_root = ""
 
+        @mxx_target_exe = nil
+
         @mxx_sources_root = File.dirname( a_prj_alias )
 
         @mxx_screen_mode = SCREEN_CONSOLE
@@ -608,7 +647,7 @@ module Mxx_ru
         @mxx_obj_files = Array.new
 
         # The storage of local options.
-        # The key is a String, the value is Spreadable_option.
+        # The key is a String, the value is SpreadableOption.
         @mxx_locals = Hash.new
 
         @mxx_implib_path = nil
@@ -660,11 +699,11 @@ module Mxx_ru
       end
 
       # A simple way to get access to the toolset.
-      # In a class, inherited from Mxx_ru::Cpp::Target is more convinient
-      # to call toolset method, instead of Mxx_ru::Cpp::toolset function.
-      # Just calling Mxx_ru::Cpp::toolset function.
+      # In a class, inherited from MxxRu::Cpp::Target is more convinient
+      # to call toolset method, instead of MxxRu::Cpp::toolset function.
+      # Just calling MxxRu::Cpp::toolset function.
       def toolset()
-        return Mxx_ru::Cpp::toolset()
+        return MxxRu::Cpp::toolset()
       end
 
       global_option_methods :runtime_mode, :nogetter
@@ -676,16 +715,16 @@ module Mxx_ru
         # is required (--mxx-cpp-release, --mxx-cpp-debug).
         result = @@mxx_runtime_mode.value
         if @@mxx_runtime_mode.default_value == result
-          if Mxx_ru::Cpp::Mode.instance.is_release &&
-            Mxx_ru::Cpp::Mode.instance.is_debug
+          if MxxRu::Cpp::Mode.instance.is_release &&
+            MxxRu::Cpp::Mode.instance.is_debug
             # This is an invalid combination of flags.
-            raise Mxx_ru::Invalid_value_ex.new(
-              "#{Mxx_ru::Cpp::MXXCPPARG_RELEASE} and " +
-              "#{Mxx_ru::Cpp::MXXCPPARG_DEBUG} cannot be used " +
+            raise MxxRu::InvalidValueEx.new(
+              "#{MxxRu::Cpp::MXXCPPARG_RELEASE} and " +
+              "#{MxxRu::Cpp::MXXCPPARG_DEBUG} cannot be used " +
               "together" )
-          elsif Mxx_ru::Cpp::Mode.instance.is_release
+          elsif MxxRu::Cpp::Mode.instance.is_release
             result = RUNTIME_RELEASE
-          elsif Mxx_ru::Cpp::Mode.instance.is_debug
+          elsif MxxRu::Cpp::Mode.instance.is_debug
             result = RUNTIME_DEBUG
           end
         end
@@ -715,12 +754,13 @@ module Mxx_ru
       #
       # If global or local obj_placement is defined, it is returned.
       #
-      # If nor global nor local obj_placement is set, local obj_placement is created
-      # with a help of Mxx_ru::Cpp::default_obj_placement function and it's returned.
+      # If nor global nor local obj_placement is set, local obj_placement is
+      # created with a help of MxxRu::Cpp::default_obj_placement function and
+      # it's returned.
       def mxx_obj_placement
         if nil != @mxx_obj_placement &&
           nil != @@mxx_global_obj_placement.placement
-          raise Mxx_ru::Invalid_value_ex.new(
+          raise MxxRu::InvalidValueEx.new(
             "Global and local obj_placement object exists! " +
             "Global created by: #{@@mxx_global_obj_placement.who}. " +
             "Local created by: #{prj_alias}" )
@@ -731,7 +771,7 @@ module Mxx_ru
         end
 
         if nil == @mxx_obj_placement
-          @mxx_obj_placement = Mxx_ru::Cpp::default_obj_placement
+          @mxx_obj_placement = MxxRu::Cpp::default_obj_placement
         end
 
         return @mxx_obj_placement
@@ -756,6 +796,11 @@ module Mxx_ru
         @mxx_target_name = create_full_target_file_name( a_target )
       end
 
+      # Set a custom extension for target.
+      def target_ext( ext )
+        @mxx_target_ext = ext
+      end
+
       # Change source files path.
       # If empty string is set, then full file names are required.
       # If block is defined, then path is changed only during a block
@@ -781,7 +826,7 @@ module Mxx_ru
         if SCREEN_CONSOLE == a_mode || SCREEN_WINDOW == a_mode
           @mxx_screen_mode = a_mode
         else
-          raise Mxx_ru::Unsupported_mode_ex.new(
+          raise MxxRu::UnsupportedModeEx.new(
             "Unsupported screen mode: #{a_mode}" )
         end
       end
@@ -790,12 +835,12 @@ module Mxx_ru
       #
       # Note: if a_file_name contains prefix equal to current sources_root
       # than mxx_ru does not add sources_root to name of file. For example:
-      #   Mxx_ru::Cpp::exe_target( 'some/module/prj.rb' ) {
+      #   MxxRu::Cpp::exe_target( 'some/module/prj.rb' ) {
       #     ...
       #     c_source 'f1.c' # become 'some/module/f1.c'
       #     c_source 'some/module/impl/f2.c' # remains 'some/module/impl/f2.c
       # This approach will be useful with Dir.glob:
-      #   Mxx_ru::Cpp::exe_target( 'some/module/prj.rb' ) {
+      #   MxxRu::Cpp::exe_target( 'some/module/prj.rb' ) {
       #     ...
       #     c_sources Dir.glob( 'some/module/**/*.c' )
       #   }
@@ -805,7 +850,7 @@ module Mxx_ru
       #               When command line would be created, this options would
       #               be concatenated with others.
       def c_source( a_file_name, a_options = nil )
-        @mxx_c_files.push( Cpp_source_file.new(
+        @mxx_c_files.push( CppSourceFile.new(
           create_full_src_file_name( a_file_name ), a_options ) )
       end
 
@@ -813,12 +858,12 @@ module Mxx_ru
       #
       # Note: if a_file_name contains prefix equal to current sources_root
       # than mxx_ru does not add sources_root to name of file. For example:
-      #   Mxx_ru::Cpp::exe_target( 'some/module/prj.rb' ) {
+      #   MxxRu::Cpp::exe_target( 'some/module/prj.rb' ) {
       #     ...
       #     cpp_source 'f1.cpp' # become 'some/module/f1.cpp'
       #     cpp_source 'some/module/impl/f2.cpp' # remains 'some/module/impl/f2.cpp
       # This approach will be useful with Dir.glob:
-      #   Mxx_ru::Cpp::exe_target( 'some/module/prj.rb' ) {
+      #   MxxRu::Cpp::exe_target( 'some/module/prj.rb' ) {
       #     ...
       #     cpp_sources Dir.glob( 'some/module/**/*.cpp' )
       #   }
@@ -828,7 +873,7 @@ module Mxx_ru
       #               When command line would be created, this options would
       #               be concatenated with others.
       def cpp_source( a_file_name, a_options = nil )
-        @mxx_cpp_files.push( Cpp_source_file.new(
+        @mxx_cpp_files.push( CppSourceFile.new(
           create_full_src_file_name( a_file_name ), a_options ) )
       end
 
@@ -845,7 +890,7 @@ module Mxx_ru
         a_rc_file,
         a_depends =nil )
 
-        @mxx_mswin_rc_file = Mswin_rc_file.new( a_rc_file, a_depends )
+        @mxx_mswin_rc_file = MswinRcFile.new( a_rc_file, a_depends )
       end
 
       # Set compiled mswin resource file name.
@@ -858,16 +903,6 @@ module Mxx_ru
         @mxx_obj_files.push( String.new( file_name ) )
       end
 
-      # Add the library required.
-      # If a_path is other then nil, then it's value is added to the list
-      # of a folders, the libraries should be searched in.
-      def lib( a_library, a_path = nil )
-        mxx_add_required_lib( a_library )
-        if a_path
-          mxx_add_required_lib_path( a_path )
-        end
-      end
-
       # Set import library location.
       def implib_path( name )
         @mxx_implib_path = name.clone
@@ -876,7 +911,7 @@ module Mxx_ru
       # Set optimization mode required.
       def optimization( a_mode )
         if OPTIM_SIZE != a_mode && OPTIM_SPEED != a_mode
-          raise Mxx_ru::Invalid_value_ex.new(
+          raise MxxRu::InvalidValueEx.new(
             "Unknown optimization mode: '#{a_mode}'" )
         else
           @mxx_optimization = a_mode.clone
@@ -887,33 +922,13 @@ module Mxx_ru
       def build
         if nil == @mxx_last_build_result
 
-          if !@mxx_all_options_defined
-            # It's necessary, that toolset has defined all the options
-            # taking all current modes into account.
-            Mxx_ru::Cpp::toolset.setup_mandatory_options( self )
-            @mxx_all_options_defined = true
-          end
-
-          Mxx_ru::Cpp::Mode.instance.before_subprj_processing
-          # The build of subordinated projects performed automatically
-          # taking dry-run mode into account.
-          required_prjs_state = build_required_projects
-          Mxx_ru::Cpp::Mode.instance.after_subprj_processing
-
-          run_generators
-          if !Mxx_ru::Cpp::Mode.instance.is_no_depends_analyzer
-            run_depends_analyzer
-          end
-          objs_state = compile_sources
-
-          res_state = compile_resources
-
-          link_state = link_target(
-            required_prjs_state,
-            objs_state, res_state )
+          check_all_options_definition
 
-          # The status of the target is determined by result of target linking.
-          @mxx_last_build_result = link_state
+          builder = self.method( :normal_mode_builder )
+          builder = self.method( :option_extraction_mode_builder ) \
+              if MxxRu::Cpp::Mode.instance.is_option_extraction
+            
+          @mxx_last_build_result = builder.call
         end
 
         return @mxx_last_build_result
@@ -923,34 +938,32 @@ module Mxx_ru
       def clean
         if nil == @mxx_last_build_result
 
-          if !@mxx_all_options_defined
-            # It's necessary, that toolset has defined all the options
-            # taking all current modes into account.
-            Mxx_ru::Cpp::toolset.setup_mandatory_options( self )
-            @mxx_all_options_defined = true
-          end
+          check_all_options_definition
 
-          Mxx_ru::Cpp::Mode.instance.before_subprj_processing
-          # The cleanup of subordinated projects performed automatically
-          # taking dry-run mode into account.
-          clean_required_prjs
-          Mxx_ru::Cpp::Mode.instance.after_subprj_processing
+          cleaner = self.method( :normal_mode_cleaner )
+          cleaner = self.method( :option_extraction_mode_cleaner ) \
+              if MxxRu::Cpp::Mode.instance.is_option_extraction
 
-          clean_generators
-          clean_objs
-          clean_resources
-          clean_target
+          cleaner.call
 
-          @mxx_last_build_result = Mxx_ru::Target_state.new(
-            Mxx_ru::Target_state::ABSENT )
+          @mxx_last_build_result = MxxRu::TargetState.new(
+            MxxRu::TargetState::ABSENT )
+        end
+      end
+
+      # Reset build status to enable rebuild.
+      def reset
+        if @mxx_last_build_result 
+          reset_required_projects
+          @mxx_last_build_result = nil
         end
       end
 
       # Get the target type.
       # Should be overloaded in child classes.
-      # Object, inherited from Mxx_ru::Cpp::Target_type is returned.
+      # Object, inherited from MxxRu::Cpp::TargetType is returned.
       def target_type
-        raise Abstract_method_ex.new( "Mxx_ru::Cpp::Target::target_type" )
+        raise AbstractMethodEx.new( "MxxRu::Cpp::Target::target_type" )
       end
 
       # Creation of a complete name of a resulting file
@@ -981,6 +994,90 @@ module Mxx_ru
       end
 
     protected
+      # Checks value of @mxx_all_options_defined and initiate
+      # options setup if it is nil.
+      def check_all_options_definition
+        if !@mxx_all_options_defined
+          # It's necessary, that toolset has defined all the options
+          # taking all current modes into account.
+          MxxRu::Cpp::toolset.setup_mandatory_options( self )
+          @mxx_all_options_defined = true
+        end
+      end
+
+      # Performs 'build' in normal mode.
+      def normal_mode_builder
+        MxxRu::Cpp::Mode.instance.before_subprj_processing
+        # The build of subordinated projects performed automatically
+        # taking dry-run mode into account.
+        required_prjs_state = build_required_projects
+        MxxRu::Cpp::Mode.instance.after_subprj_processing
+
+        run_generators
+        if !MxxRu::Cpp::Mode.instance.is_no_depends_analyzer
+          run_depends_analyzer
+        end
+        objs_state = compile_sources
+
+        res_state = compile_resources
+
+        link_state = link_target(
+          required_prjs_state,
+          objs_state, res_state )
+
+        # The status of the target is determined by result of target linking.
+        link_state
+      end
+
+      # Performs 'clean' in normal mode
+      def normal_mode_cleaner
+        MxxRu::Cpp::Mode.instance.before_subprj_processing
+        # The cleanup of subordinated projects performed automatically
+        # taking dry-run mode into account.
+        clean_required_prjs
+        MxxRu::Cpp::Mode.instance.after_subprj_processing
+
+        clean_generators
+        clean_objs
+        clean_resources
+        clean_target
+      end
+
+      # Performs 'build' in 'option extraction mode'
+      def option_extraction_mode_builder
+        options = {
+            'Compiler options' => :mxx_all_compiler_options,
+            'C++ Compiler Options' => :mxx_all_cpp_compiler_options,
+            'C Compiler Options' => :mxx_all_c_compiler_options,
+            'Linker Options' => :mxx_all_linker_options,
+            'Librarian Options' => :mxx_all_librarian_options,
+            'Defines' => :mxx_all_defines,
+            'Include Paths' => :mxx_all_include_paths
+            }
+        if 'mswin' == toolset.tag( 'target_os' )
+          options.merge!(
+            'MSWindows Resource Compiler Options' => :mxx_all_mswin_rc_options,
+            'MSWindows Resource Compiler Include Paths' =>
+                :mxx_all_mswin_rc_include_paths,
+            'MSWindows Resource Compiler Defines' => :mxx_all_mswin_rc_defines,
+            'MSWindows Resource Linker Options' => :mxx_all_mswin_rlink_options
+          )
+        end
+
+        options.keys.sort.each do |k|
+          opts = self.send( options[ k ] )
+
+          puts "#{k}:\n\t#{opts.join("\n\t")}\n"
+        end
+
+        return TargetState.new( TargetState::EXISTS )
+      end
+
+      # Performs 'clean' in 'option extraction mode'
+      def option_extraction_mode_cleaner
+        # Nothing to do!
+      end
+
       # Start of all generators of source files.
       def run_generators
         mxx_generators.each { |g| g.build( self ) }
@@ -988,7 +1085,7 @@ module Mxx_ru
 
       # Start of C++ dependencies analyzer.
       def run_depends_analyzer
-        analyzer = Analyzer::Cpp_analyzer.instance
+        analyzer = Analyzer::CppAnalyzer.instance
 
         # We prepare the analyzer to start.
         sources = Array.new
@@ -1016,9 +1113,9 @@ module Mxx_ru
       end
 
       # Start of source files compiler.
-      # Returns Mxx_ru::Target_state.
+      # Returns MxxRu::TargetState.
       def compile_sources
-        return Mxx_ru::Cpp::toolset().make_objs( self )
+        return MxxRu::Cpp::toolset().make_objs( self )
       end
 
       # Start of resource files compiler.
@@ -1027,38 +1124,38 @@ module Mxx_ru
         # We proceed from the assumption, that on one platform
         # some different types of resource files simultaneously can not be used.
         if @mxx_mswin_rc_file
-          return Mxx_ru::Cpp::toolset().make_mswin_res( self )
+          return MxxRu::Cpp::toolset().make_mswin_res( self )
         end
 
-        return Mxx_ru::Target_state.new( Target_state::EXISTS )
+        return MxxRu::TargetState.new( TargetState::EXISTS )
       end
 
       # Start of target linking.
       #
       # [_required_prjs_state_] Build results of all subprojects required.
-      #                         Object of Mxx_ru::Target_state type.
+      #                         Object of MxxRu::TargetState type.
       # [_objs_state_] Compilation results of all object files
-      #                Object of Mxx_ru::Target_state type.
+      #                Object of MxxRu::TargetState type.
       # [_res_state_] Compilation results of all resource files.
-      #               Object of Mxx_ru::Target_state type.
+      #               Object of MxxRu::TargetState type.
       def link_target(
         required_prjs_state,
         objs_state,
         res_state )
 
         state = nil
-        toolset = Mxx_ru::Cpp::toolset
+        toolset = MxxRu::Cpp::toolset
         if nil == target_type
-          raise Mxx_ru::Unsupported_target_type_ex.new(
+          raise MxxRu::UnsupportedTargetTypeEx.new(
             self.class.name, "nil" )
-        elsif target_type.name == Lib_target_type::TYPE
+        elsif target_type.name == LibTargetType::TYPE
           state = toolset.make_lib( self )
-        elsif target_type.name == Dll_target_type::TYPE
+        elsif target_type.name == DllTargetType::TYPE
           state = toolset.make_dll( self )
-        elsif target_type.name == Exe_target_type::TYPE
+        elsif target_type.name == ExeTargetType::TYPE
           state = toolset.make_exe( self )
         else
-          raise Mxx_ru::Unsupported_target_type_ex.new(
+          raise MxxRu::UnsupportedTargetTypeEx.new(
             self.class.name, target_type.name )
         end
 
@@ -1070,28 +1167,28 @@ module Mxx_ru
       end
 
       def clean_objs
-        Mxx_ru::Cpp::toolset().clean_objs( self )
+        MxxRu::Cpp::toolset().clean_objs( self )
       end
 
       def clean_resources
         if @mxx_mswin_rc_file
-          Mxx_ru::Cpp::toolset().clean_mswin_res( self )
+          MxxRu::Cpp::toolset().clean_mswin_res( self )
         end
       end
 
       def clean_target
-        toolset = Mxx_ru::Cpp::toolset
+        toolset = MxxRu::Cpp::toolset
         if nil == target_type
-          raise Mxx_ru::Unsupported_target_type_ex.new(
+          raise MxxRu::UnsupportedTargetTypeEx.new(
             self.class.name, "nil" )
-        elsif target_type.name == Lib_target_type::TYPE
+        elsif target_type.name == LibTargetType::TYPE
           state = toolset.clean_lib( self )
-        elsif target_type.name == Dll_target_type::TYPE
+        elsif target_type.name == DllTargetType::TYPE
           state = toolset.clean_dll( self )
-        elsif target_type.name == Exe_target_type::TYPE
+        elsif target_type.name == ExeTargetType::TYPE
           state = toolset.clean_exe( self )
         else
-          raise Mxx_ru::Unsupported_target_type_ex.new(
+          raise MxxRu::UnsupportedTargetTypeEx.new(
             self.class.name, target_type.name )
         end
       end
@@ -1108,7 +1205,7 @@ module Mxx_ru
           @@mxx_globals[ a_option_desc ] = globals = Array.new
         end
 
-        locals = Spreadable_option.new( a_option_desc )
+        locals = SpreadableOption.new( a_option_desc )
         @mxx_locals[ a_option_desc ] = locals
 
         meth_global = "global_#{a_option_desc}"
@@ -1117,14 +1214,14 @@ module Mxx_ru
         meth_upspreads = "mxx_upspread_#{a_option_desc}s"
 
         @mxx_missing_actions[ meth_global ] =
-          Global_option_inserter.new( a_option_desc, globals )
+          GlobalOptionInserter.new( a_option_desc, globals )
         @mxx_missing_actions[ meth_local ] =
-          Spreadable_option_inserter.new( locals )
+          SpreadableOptionInserter.new( locals )
         @mxx_missing_actions[ meth_all ] =
-          Spreadable_option_all_extractor.new( locals,
+          SpreadableOptionAllExtractor.new( locals,
             globals, self, meth_upspreads )
         @mxx_missing_actions[ meth_upspreads ] =
-          Spreadable_option_upspread_extractor.new(
+          SpreadableOptionUpspreadExtractor.new(
             locals, self, meth_upspreads )
       end
 
@@ -1147,18 +1244,18 @@ module Mxx_ru
     #
     # For example:
     #
-    #  class Prj < Mxx_ru::Cpp::Lib_or_dll_target
+    #  class Prj < MxxRu::Cpp::LibOrDllTarget
     #    TAG = "threads_1/prj.rb"
     #    def initialize( a_alias = TAG )
     #      super( a_alias, TAG )
     # 
     #      target( "threads.1.3" )
     # 
-    #      threading_mode( Mxx_ru::Cpp::THREADING_MULTI )
+    #      threading_mode( MxxRu::Cpp::THREADING_MULTI )
     # 
     #      init_dll_block(
     #        Proc.new {
-    #          rtl_mode( Mxx_ru::Cpp::RTL_SHARED )
+    #          rtl_mode( MxxRu::Cpp::RTL_SHARED )
     #          implib_path( "lib" )
     #          define( "THREADS_1__DLL", OPT_UPSPREAD )
     #        })
@@ -1182,11 +1279,11 @@ module Mxx_ru
     #
     # == Manual execution of as_lib, as_dll methods
     #
-    # If project defines one class only, inherited from Lib_or_dll_target,
+    # If project defines one class only, inherited from LibOrDllTarget,
     # then all clients of that project should explicitly call as_lib or as_dll
     # method during a reference to required_prj:
     #
-    #  class My_prj < Mxx_ru::Cpp::Exe_target
+    #  class MyPrj < MxxRu::Cpp::ExeTarget
     #    def initialize( a_alias = "my_prj.rb" )
     #      super( a_alias )
     #      required_prj( "threads_1/prj.rb" ).as_dll( self )
@@ -1204,7 +1301,7 @@ module Mxx_ru
     # define two auxiliary classes, which would call methods as_lib and as_dll
     # inside their constructors:
     #
-    #  class Prj < Mxx_ru::Cpp::Lib_or_dll_target
+    #  class Prj < MxxRu::Cpp::LibOrDllTarget
     #    def initialize( a_alias = "threads_1/prj.rb" )
     #      super( a_alias, "threads_1" )
     #      ...
@@ -1224,24 +1321,27 @@ module Mxx_ru
     #  end
     #
     # Then for using the target it would be enough to do that:
-    #  class My_prj < Mxx_ru::Cpp::Exe_target
+    #  class MyPrj < MxxRu::Cpp::ExeTarget
     #    def initialize( a_alias = "my_prj.rb" )
     #      super( a_alias )
     #      required_prj( "threads_1/dll.rb" )
     #    end
     #  end
     #
-    class Lib_or_dll_target < Target
+    class LibOrDllTarget < Target
       # Exception type, which is thrown if target type is undefined.
-      class Type_not_defined_ex < Mxx_ru::Ex
+      class TypeNotDefinedEx < MxxRu::Ex
         # [_a_prj_alias_] Project alias, for which target type should be defined.
         def initialize( a_prj_alias )
           super( "#{a_prj_alias}: type of target not defined yet" )
         end
       end
 
+      # For compatibility with previous versions.
+      Type_not_defined_ex = TypeNotDefinedEx
+
       # Exception type, which is thrown if target type was already defined.
-      class Type_already_defined_ex < Mxx_ru::Ex
+      class TypeAlreadyDefinedEx < MxxRu::Ex
         # [_a_prj_tag_] Target identifier, for which type is established.
         # [_a_type_] Already defined target type.
         def initialize( a_prj_alias, a_type )
@@ -1250,9 +1350,12 @@ module Mxx_ru
         end
       end
 
+      # For compatibility with previous versions.
+      Type_already_defined_ex = TypeAlreadyDefinedEx
+
       # Map describing unique target identifiers and their types.
-      # Used to avoid conflicts, when the same target is inside composite project
-      # as both lib and dll.
+      # Used to avoid conflicts, when the same target is inside composite
+      # project as both lib and dll.
       @@mxx_tags = Hash.new
 
       # Constructor.
@@ -1260,22 +1363,22 @@ module Mxx_ru
       # [_a_prj_alias_] Project alias.
       # [_a_prj_tag_] Unique value, which identifies target given.
       #               This value used to avoid conflicts in the next situations:
-      #  class Prj < Mxx_ru::Cpp::Lib_or_dll_target ... end
+      #  class Prj < MxxRu::Cpp::LibOrDllTarget ... end
       #  class Lib < Prj ... end
       #  class Dll < Prj ... end
-      #  class My_exe < Mxx_ru::Cpp::Exe_target
+      #  class MyExe < MxxRu::Cpp::ExeTarget
       #    def initialize( a_alias = "my_exe.rb" )
       #      super( a_alias )
       #      required_prj( "threads_1/dll.rb" )
       #    end
       #  end
-      #  class My_dll < Mxx_ru::Cpp::Dll_target
+      #  class MyDll < MxxRu::Cpp::DllTarget
       #    def initialize( a_alias = "my_dll.rb" )
       #      super( a_alias )
       #      required_prj( "threads_1/lib.rb" )
       #    end
       #  end
-      # If both My_exe and My_dll are used in one composite project,
+      # If both MyExe and MyDll are used in one composite project,
       # then it's a conflict of usage of threads_1/dll.rb and threads_1/lib.rb.
       def initialize( a_prj_alias, a_prj_tag )
         super( a_prj_alias )
@@ -1293,8 +1396,8 @@ module Mxx_ru
 
       # Set lib as target type.
       def as_lib
-        if ensure_type_not_set_yet( Lib_target_type::TYPE )
-          @mxx_target_type = Lib_target_type.new
+        if ensure_type_not_set_yet( LibTargetType::TYPE )
+          @mxx_target_type = LibTargetType.new
           if nil != @mxx_init_lib_block
             @mxx_init_lib_block.call
           end
@@ -1303,8 +1406,8 @@ module Mxx_ru
 
       # Set dll as target type.
       def as_dll
-        if ensure_type_not_set_yet( Dll_target_type::TYPE )
-          @mxx_target_type = Dll_target_type.new
+        if ensure_type_not_set_yet( DllTargetType::TYPE )
+          @mxx_target_type = DllTargetType.new
           if nil != @mxx_init_dll_block
             @mxx_init_dll_block.call
           end
@@ -1314,7 +1417,7 @@ module Mxx_ru
       # Return current value of mxx_target_type.
       def target_type
         if nil == @mxx_target_type
-          raise Type_not_defined_ex.new( prj_alias )
+          raise TypeNotDefinedEx.new( prj_alias )
         end
 
         return @mxx_target_type
@@ -1342,7 +1445,7 @@ module Mxx_ru
       def ensure_type_not_set_yet( a_type_name )
         if @@mxx_tags.key?( @mxx_prj_tag ) &&
           @@mxx_tags[ @mxx_prj_tag ] != a_type_name
-          raise Type_already_defined_ex.new(
+          raise TypeAlreadyDefinedEx.new(
             @mxx_prj_tag, a_type_name )
         end
 
@@ -1350,10 +1453,13 @@ module Mxx_ru
 
         return ( nil == @mxx_target_type )
       end
-    end # class Lib_or_dll_target
+    end # class LibOrDllTarget
+
+    # For compatibility with previous versions.
+    Lib_or_dll_target = LibOrDllTarget
 
     # Lib is a target type.
-    class Lib_target < Lib_or_dll_target
+    class LibTarget < LibOrDllTarget
       def initialize( a_prj_alias, &block )
         super( a_prj_alias, a_prj_alias )
 
@@ -1363,8 +1469,11 @@ module Mxx_ru
       end
     end
 
+    # For compatibility with previous versions.
+    Lib_target = LibTarget
+
     # Dll is a target type.
-    class Dll_target < Lib_or_dll_target
+    class DllTarget < LibOrDllTarget
       def initialize( a_prj_alias, &block )
         super( a_prj_alias, a_prj_alias )
 
@@ -1374,8 +1483,11 @@ module Mxx_ru
       end
     end
 
+    # For compatibility with previous versions.
+    Dll_target = DllTarget
+
     # Exe is a target type.
-    class Exe_target < Target
+    class ExeTarget < Target
 
       def initialize( a_alias, &block )
         super( a_alias )
@@ -1384,17 +1496,20 @@ module Mxx_ru
       end
 
       def target_type
-        return Exe_target_type.new
+        return ExeTargetType.new
       end
     end
 
+    # For compatibility with previous versions.
+    Exe_target = ExeTarget
+
     # Generator for generating method for simple way of describing targets.
     def Cpp.generate_simple_target_method( target_type )
       target_class_name = target_type.to_s.capitalize
       class_eval %Q{
         def Cpp.#{target_type}( prj_alias = nil, &block )
-          prj_alias = Mxx_ru::Util::prj_alias_form_caller( caller ) unless prj_alias
-          Mxx_ru::setup_target #{target_class_name}.new( prj_alias, &block )
+          prj_alias = MxxRu::Util::prj_alias_form_caller( caller ) unless prj_alias
+          MxxRu::setup_target #{target_class_name}.new( prj_alias, &block )
         end
       }
     end
@@ -1404,5 +1519,5 @@ module Mxx_ru
     generate_simple_target_method :exe_target
 
   end # module Cpp
-end # module Mxx_ru
+end # module MxxRu