cast_off 0.3.7 → 0.4.0

data/lib/cast_off/compile/code_manager.rb

@@ -50,61 +50,12 @@ module CastOff
         dir
       end
 
-      def self.delete_from_compiled(entry)
-        compiled = load_autocompiled()
-        return false unless compiled
-        return false unless compiled.delete(entry)
-        dump_auto_compiled(compiled)
-        return true
-      end
-
       def self.compiled_method_exist?(filepath, line_no)
         return false unless filepath && line_no >= 0
         base_sign = generate_signiture("#{filepath}_#{line_no}")
         File.exist?("#{BaseDir}/#{@@program_sign}/#{base_sign}/loadable")
       end
 
-      @@compiled_methods_fetch_str = nil
-      @@compiled_methods_load_str  = nil
-      def self.load_autocompiled()
-        begin
-          dir = program_dir()
-          # fetch classes
-          path = "#{dir}/.compiled_methods"
-          return nil unless File.exist?(path)
-          if !@@compiled_methods_fetch_str
-            @@compiled_methods_fetch_str = File.open(path, 'rb:us-ascii').read() 
-            @@compiled_methods_fetch_str.untaint # FIXME
-          end
-          Marshal.load(@@compiled_methods_fetch_str)
-          # load compiled methods information
-          path = "#{dir}/compiled_methods"
-          return nil unless File.exist?(path)
-          if !@@compiled_methods_load_str
-            @@compiled_methods_load_str = File.open(path, 'rb:us-ascii').read() 
-            @@compiled_methods_load_str.untaint # FIXME
-          end
-          Marshal.load(@@compiled_methods_load_str)
-        rescue ArgumentError, NameError
-          false
-        end
-      end
-
-      def self.dump_auto_compiled(compiled)
-        dir = program_dir()
-        path = "#{dir}/.compiled_methods"
-        File.open("#{path}", 'wb:us-ascii') do |f|
-          Marshal.dump(compiled.map{|c| c.first}, f) # dump only classes
-        end
-        @@compiled_methods_fetch_str = nil
-        path = "#{dir}/compiled_methods"
-        File.open("#{path}", 'wb:us-ascii') do |f|
-          Marshal.dump(compiled, f)
-        end
-        @@compiled_methods_load_str = nil
-        load_autocompiled()
-      end
-
       def create_dstdir()
         FileUtils.mkdir(@dstdir) unless File.exist?(@dstdir)
         FileUtils.touch(@lockpath) unless File.exist?(@lockpath)

data/lib/cast_off/compile/configuration.rb

@@ -839,10 +839,10 @@ Currently, CastOff doesn't support object, which cannot marshal dump (e.g. STDIN
       [Kernel, :fail, :singleton],
       [Kernel, :global_variables, :module],
       [Kernel, :global_variables, :singleton],
-      [Kernel, :__method__, :module],
-      [Kernel, :__method__, :singleton],
-      [Kernel, :__callee__, :module],
-      [Kernel, :__callee__, :singleton],
+      #[Kernel, :__method__, :module], #rb_frame_caller()
+      #[Kernel, :__method__, :singleton], #rb_frame_caller()
+      #[Kernel, :__callee__, :module], #rb_frame_caller()
+      #[Kernel, :__callee__, :singleton], #rb_frame_caller()
       [Module, :append_features, :class],
       [Module, :extend_object, :class],
       [Module, :include, :class],
@@ -850,10 +850,10 @@ Currently, CastOff doesn't support object, which cannot marshal dump (e.g. STDIN
       [Kernel, :eval, :singleton],
       [Kernel, :local_variables, :module],
       [Kernel, :local_variables, :singleton],
-      [Kernel, :iterator?, :module],
-      [Kernel, :iterator?, :singleton],
-      [Kernel, :block_given?, :module],
-      [Kernel, :block_given?, :singleton],
+      #[Kernel, :iterator?, :module], #rb_f_block_given_p
+      #[Kernel, :iterator?, :singleton], #rb_f_block_given_p
+      #[Kernel, :block_given?, :module], #rb_f_block_given_p
+      #[Kernel, :block_given?, :singleton], #rb_f_block_given_p
       [Kernel, :catch, :module],
       [Kernel, :catch, :singleton],
       [Kernel, :throw, :module],

data/lib/cast_off/compile/hook_invocation.rb

@@ -0,0 +1 @@
+

data/lib/cast_off/compile/ir/call_ir.rb

@@ -1486,10 +1486,12 @@ Call site is (#{@insn}).
       attr_reader :method_id
 
       IncompatMethods = [
-        :eval,         # use vm_get_ruby_level_caller_cfp
-        :binding,      # use vm_get_ruby_level_caller_cfp
-        :block_given?, # use vm_get_ruby_level_caller_cfp
-        :iterator?,    # use vm_get_ruby_level_caller_cfp
+        :eval,          # use vm_get_ruby_level_caller_cfp
+        :binding,       # use vm_get_ruby_level_caller_cfp
+        :block_given?,  # use vm_get_ruby_level_caller_cfp
+        :iterator?,     # use vm_get_ruby_level_caller_cfp
+        :__method__,    # use rb_frame_caller()
+        :__callee__,    # use rb_frame_caller()
       ]
 
       def initialize(mid, flags, param, argc, return_value, insn, cfg)
@@ -1710,34 +1712,40 @@ You should not use #{@method_id} method in compilation target of CastOff.
         [MethodWrapper.new(ArrayWrapper,  :empty?), 1] => [['empty_p',      [], nil, [TrueClass,  FalseClass], false, false]],
         [MethodWrapper.new(ArrayWrapper,  :last), 1]   => [['last',         [], nil, nil, false, false]],
         [MethodWrapper.new(ArrayWrapper,  :first), 1]  => [['first',        [], nil, nil, false, false]],
-        [MethodWrapper.new(FixnumWrapper, :+), 2]      => [['fixnum_plus',  [Fixnum], nil, [Fixnum, Bignum], false, true], ['float_plus',   [Float],   nil, Float, true, true]], # FIXME
-        [MethodWrapper.new(FixnumWrapper, :-), 2]      => [['fixnum_minus', [Fixnum], nil, [Fixnum, Bignum], false, true], ['float_minus',  [Float],   nil, Float, true, true]], # FIXME
-        [MethodWrapper.new(FixnumWrapper, :*), 2]      => [['fixnum_mult',  [Fixnum], nil, [Fixnum, Bignum], false, true], ['float_mult',   [Float],   nil, Float, true, true]], # FIXME
-        [MethodWrapper.new(FixnumWrapper, :<=), 2]     => [['le',           [Fixnum], nil, [TrueClass,  FalseClass], false, false]],
-        [MethodWrapper.new(FixnumWrapper, :<), 2]      => [['lt',           [Fixnum], nil, [TrueClass,  FalseClass], false, false]],
-        [MethodWrapper.new(FixnumWrapper, :>=), 2]     => [['ge',           [Fixnum], nil, [TrueClass,  FalseClass], false, false]],
-        [MethodWrapper.new(FixnumWrapper, :>), 2]      => [['gt',           [Fixnum], nil, [TrueClass,  FalseClass], false, false]],
-        [MethodWrapper.new(FixnumWrapper, :==), 2]     => [['eq',           [Fixnum], nil, [TrueClass,  FalseClass], false, false]],
-        [MethodWrapper.new(FixnumWrapper, :===), 2]    => [['eqq',          [Fixnum], nil, [TrueClass,  FalseClass], false, false]],
         [MethodWrapper.new(FixnumWrapper, :&), 2]      => [['and',          [Fixnum], Fixnum, nil, false, false]], # FIXME
+        [MethodWrapper.new(FixnumWrapper, :+), 2]      => [['fixnum_plus',  [Fixnum],  nil, [Fixnum, Bignum], false, true], ['float_plus',   [Float],   nil, Float, true, true]],
         [MethodWrapper.new(FloatWrapper,  :+), 2]      => [['float_plus',   [Float],   nil, Float, true, true], ['fixnum_plus',   [Fixnum],  nil, Float, true, true]],
+        [MethodWrapper.new(FixnumWrapper, :-), 2]      => [['fixnum_minus', [Fixnum],  nil, [Fixnum, Bignum], false, true], ['float_minus',  [Float],   nil, Float, true, true]],
         [MethodWrapper.new(FloatWrapper,  :-), 2]      => [['float_minus',  [Float],   nil, Float, true, true], ['fixnum_minus',  [Fixnum],  nil, Float, true, true]],
+        [MethodWrapper.new(FixnumWrapper, :*), 2]      => [['fixnum_mult',  [Fixnum],  nil, [Fixnum, Bignum], false, true], ['float_mult',   [Float],   nil, Float, true, true]],
         [MethodWrapper.new(FloatWrapper,  :*), 2]      => [['float_mult',   [Float],   nil, Float, true, true], ['fixnum_mult',   [Fixnum],  nil, Float, true, true]],
         [MethodWrapper.new(FloatWrapper,  :/), 2]      => [['float_div',    [Float],   nil, Float, true, true], ['fixnum_div',    [Fixnum],  nil, Float, true, true]],
+        [MethodWrapper.new(FixnumWrapper, :<=), 2]     => [['fixnum_le',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true],
+                                                           ['float_le',     [Float],   nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FloatWrapper,  :<=), 2]     => [['float_le',     [Float],   nil, [TrueClass,  FalseClass], false, true],
                                                            ['fixnum_le',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true]],
+        [MethodWrapper.new(FixnumWrapper, :<), 2]      => [['fixnum_lt',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true],
+                                                           ['float_lt',     [Float],   nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FloatWrapper,  :<), 2]      => [['float_lt',     [Float],   nil, [TrueClass,  FalseClass], false, true],
                                                            ['fixnum_lt',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true]],
+        [MethodWrapper.new(FixnumWrapper, :>=), 2]     => [['fixnum_ge',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true],
+                                                           ['float_ge',     [Float],   nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FloatWrapper,  :>=), 2]     => [['float_ge',     [Float],   nil, [TrueClass,  FalseClass], false, true],
                                                            ['fixnum_ge',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true]],
+        [MethodWrapper.new(FixnumWrapper, :>), 2]      => [['fixnum_gt',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true],
+                                                           ['float_gt',     [Float],   nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FloatWrapper,  :>), 2]      => [['float_gt',     [Float],   nil, [TrueClass,  FalseClass], false, true],
                                                            ['fixnum_gt',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true]],
+        [MethodWrapper.new(FixnumWrapper, :==), 2]     => [['fixnum_eq',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true],
+                                                           ['float_eq',     [Float],   nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FloatWrapper,  :==), 2]     => [['float_eq',     [Float],   nil, [TrueClass,  FalseClass], false, true],
                                                            ['fixnum_eq',    [Fixnum],  nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FixnumWrapper, :!=), 2]     => [['fixnum_neq',   [Fixnum],  nil, [TrueClass,  FalseClass], false, true],
                                                            ['float_neq',    [Float],   nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FloatWrapper,  :!=), 2]     => [['float_neq',    [Float],   nil, [TrueClass,  FalseClass], false, true],
                                                            ['fixnum_neq',   [Fixnum],  nil, [TrueClass,  FalseClass], false, true]],
+        [MethodWrapper.new(FixnumWrapper, :===), 2]    => [['fixnum_eqq',   [Fixnum],  nil, [TrueClass,  FalseClass], false, true],
+                                                           ['float_eqq',    [Float],   nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FloatWrapper,  :===), 2]    => [['float_eqq',    [Float],   nil, [TrueClass,  FalseClass], false, true],
                                                            ['fixnum_eqq',   [Fixnum],  nil, [TrueClass,  FalseClass], false, true]],
         [MethodWrapper.new(FixnumWrapper, :-@), 1]     => [['uminus',       [], nil, [Fixnum, Bignum], false, true]],

data/lib/cast_off/compile/translator.rb

@@ -917,7 +917,7 @@ Source line is #{@root_iseq.source_line}.
       end
       key = [name, mid, klass.singleton?, convention, argc]
       entry = @fptr[key] || []
-      fptr.concat("_#{argc}_#{entry.size}")
+      fptr.concat("_#{convention.to_s.gsub(/-/, '_')}_#{argc}_#{entry.size}")
       entry << fptr
       @fptr[key] = entry
       fptr
@@ -1048,7 +1048,9 @@ Source line is #{@root_iseq.source_line}.
           rescue CompileError
             return nil
           end
-          return nil unless /^[\w:]+$/.match(path)
+          unless /^[\w:]+$/.match(path)
+            return nil
+          end
           if klass.singleton?
             name = allocate_name("singleton_class_#{path}")
             singleton_p = true
@@ -1066,17 +1068,14 @@ Source line is #{@root_iseq.source_line}.
     end
 
     # for suggestion
-    MSG_TYPE_NOT_RESOLVED  = "Reciever not resolved."
+    MSG_TYPE_NOT_RESOLVED  = "Unresolved receivers"
     COL_TYPE_NOT_RESOLVED  = ["<Reciever>", "<Method>", "<Line>", "<Source>"]
-    MSG_LITERAL_DUPLICATED = "These literals have duplicated."
+    MSG_LITERAL_DUPLICATED = "Duplicated literals"
     COL_LITERAL_DUPLICATED = ["<Literal>", "<Reason>", "<Line>", "<Source>"]
-    MSG_INLINEAPI_NOT_USED = "Some inline apis have not used."
-    COL_INLINEAPI_NOT_USED = ["<Method>", "<Reason>", "<Line>", "<Source>"]
 
     SUGGESTION_TABLE = [
       [MSG_TYPE_NOT_RESOLVED,  COL_TYPE_NOT_RESOLVED,  :@type_suggestion],
       [MSG_LITERAL_DUPLICATED, COL_LITERAL_DUPLICATED, :@literal_suggestion],
-      [MSG_INLINEAPI_NOT_USED, COL_INLINEAPI_NOT_USED, :@inlineapi_suggestion],
     ]
 
     SUGGESTION_TABLE.each do |(msg, col, ivar)|

data/lib/cast_off/suggestion.rb

@@ -81,7 +81,7 @@ module CastOff
         suggestion << "#{side}#{line.zip(l_titles).map{|c, l| pretty ? c.center(l) : c }.join(" | ")}#{side}"
       end
       suggestion << " #{sep} "
-      @suggestion << suggestion.join("\n")
+      @suggestion << suggestion.map{|s| s.force_encoding('ASCII-8BIT')}.join("\n")
     end
 
     private

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cast_off
 version: !ruby/object:Gem::Version
-  version: 0.3.7
+  version: 0.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,15 +9,12 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-04 00:00:00.000000000 Z
+date: 2011-12-07 00:00:00.000000000 Z
 dependencies: []
-description: ! 'CastOff is a compiler for Ruby1.9.3.
-
-  Command line tool cast_off is available after installation.
-
-  See ''cast_off --help'' for more information.
-
-'
+description: ! "CastOff is a compiler for Ruby1.9.3.\nCommand line tool cast_off is
+  available after installation.\nSee 'cast_off --help' for more information.\nCurrently,
+  CastOff supports Ruby1.9.3 only.\nSo, if you attempt to use CastOff, please install
+  CastOff under Ruby1.9.3 runtime. \n\n"
 email: shiba@rvm.jp
 executables:
 - cast_off
@@ -45,6 +42,7 @@ files:
 - lib/cast_off/compile/code_manager.rb
 - lib/cast_off/compile/stack.rb
 - lib/cast_off/compile/iseq.rb
+- lib/cast_off/compile/hook_invocation.rb
 - lib/cast_off/compile/configuration.rb
 - lib/cast_off/compile/method_information.rb
 - lib/cast_off/compile/basicblock.rb
@@ -97,8 +95,8 @@ files:
 - bin/cast_off
 - doc/about.pdf
 - cast_off.gemspec
-- README.en
 - README
+- README.ja
 homepage: http://github.com/soba1104/CastOff
 licenses: []
 post_install_message: 
@@ -108,9 +106,9 @@ require_paths:
 required_ruby_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>='
+  - - =
     - !ruby/object:Gem::Version
-      version: 1.9.2
+      version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/README.en

@@ -1,228 +0,0 @@
-* About CastOff
-CastOff is a compiler for Ruby1.9.3.
-CastOff compiles Ruby method (method written in Ruby) into C extension (method written in C)
-by using given information such as class information of variables.
-CastOff can reduce Ruby virtual machine overhead, so by use of CastOff,
-the performance of compilation target method can improve.
-
-This README document introduce basic functionality of CastOff.
-If you have any questions, comments, or suggestions please send email to shiba@rvm.jp,
-or use http://github.com/soba1104/CastOff/issues.
-
-
-
-* License
-Same as the license of Ruby1.9.3 runtime.
-
-
-
-* Installation
-$gem install cast_off
-
-Currently, CastOff supports Ruby1.9.3 only.
-So, if you attempt to use CastOff, please install CastOff under Ruby1.9.3 runtime. 
-
-
-
-* Attention
-
-** Incompatibility
--Continuation
-CastOff causes problem about capture of continuation (callcc).
-So, you should not use CastOff to your program which uses Continuation.
-
--Constant redefinition
-<<<Sorry, not yet documented.>>>
-
--Built-in functions related with Method and Proc
-CastOff compiles Ruby method and proc into C extension.
-So, built-in functions related with Method and Proc (such as Method#arity, Proc#arity)
-return different values.
-
-# example
-class Foo
-  def foo(a, b = :b, *c); end
-end
-f = Foo.new
-puts (f.method(:foo).arity) # => -2
-CastOff.compile(Foo, :foo)
-puts (f.method(:foo).arity) # => -1
-
-
-** Startup time
-<<<Sorry, not yet documented.>>>
-
-
-** Compilation time
-<<<Sorry, not yet documented.>>>
-
-
-** Load of compiled method
-CastOff needs definition of compilation target method to load compiled method.
-If compilation target method is not defined, CastOff cannot load compiled method.
-
-When you use CastOff from command line, CastOff hooks class definition statement
-to check method definition. And load compiled method if compilation target method is defined.
-So, if you want to compile method outer class definition statement (such as following bar method),
-you need call CastOff.autoload or CastOff.load after method definition explicitly.
-
------------------------------------------------------
-class Foo # Compiled Foo#foo is loaded after class definition of Foo
-  def foo
-    ...
-  end
-end
-
-def bar() # There are no class definition after definition of bar,
-          # so Compiled bar method is not loaded.
-  ...
-end
-# If you want to load compiled bar method,
-# you should call CastOff.autoload or CastOff.load after definition of bar method.
-
-...
------------------------------------------------------
-
-
-
-* Usage
-
-** Use CastOff from command line
-By use of command line tool cast_off, you can improve performance of your Ruby program easily.
-If you want to improve performance of your Ruby program, you should execute following command repeatedly.
-
------------------------------------------------------
-$cast_off PathOfTargetProgram ArgumentsOfTargetProgram
------------------------------------------------------
-
-For example, when you want to improve performance of Ruby program "foo.rb"
-(in this example, "foo.rb" recieves one argument "bar" or "baz"), you should execute following commands.
-
------------------------------------------------------
-$cast_off foo.rb bar
-$cast_off foo.rb baz
------------------------------------------------------
-
-When you execute these commands, CastOff does followings to compile foo.rb and related libraries.
-
-1: Executes "foo.rb" with argument "bar" to get profile information.
-2: Compiles "foo.rb" and related libraries.
-3: Executes "foo.rb" with argument "baz" to get and update profile information.
-4: Compiles "foo.rb" and related libraries.
-
-After CastOff finishes compilation, you can run target program with --run option.
-In above example, you can run target program with compiled codes by use of following command.
-
-$cast_off --run foo.rb bar
-
-
-*** Command line arguments
-
-cast_off [options] PathOfTargetProgram ArgumentsOfTargetProgram
-
-
-*** Command line options
---run
-Execute target program with compiled methods.
-
---clear
-Clear profile information and delete compiled methods.
-If you want to clear profile information and compiled methods of target name "foo",
-you should execute following command.
-$cast_off --clear --name=foo
-
---threshold=COUNT
-Compile method which is executed more than COUNT.
-Default value is 100.
-
---name=NAME
-Name compiled methods NAME.
-This name is used for search of compiled methods.
-If you don't use this option, CastOff uses File.basename([programfile]) as name.
-
---verbose
-Show compilation progress and internal information.
-
--h, --help
-Show help.
-
---version
-Show version number of CastOff.
-
-
-
-** Use CastOff from script
-<<<Sorry, not yet documented. >>>
-
-
-*** Specify class information to CastOff
-You can specify class information to CastOff by followings.
-
--Specify class of variables:
---local variables, arguments
-:local_variable_name => class_name
-:local_variable_name => [class_name1, class_name2, ...]
-[:local_variable_name1, :local_variable_name2, ...] => class_name
-[:local_variable_name1, :local_variable_name2, ...] => [class_name1, class_name2, ...]
-
---instance variables
-:@instance_variable_name => class_name
-:@instance_variable_name => [class_name1, class_name2, ...]
-[:@instance_variable_name1, :@instance_variable_name2, ...] => class_name
-[:@instance_variable_name1, :@instance_variable_name2, ...] => [class_name1, class_name2, ...]
-
---class variables
-:@@class_variable_name => class_name
-:@@class_variable_name => [class_name1, class_name2, ...]
-[:@@class_variable_name1, :@@class_variable_name2, ...] => class_name
-[:@@class_variable_name1, :@@class_variable_name2, ...] => [class_name1, class_name2, ...]
-
---global variables
-:$global_variable_name => class_name
-:$global_variable_name => [class_name1, class_name2, ...]
-[:$global_variable_name1, :$global_variable_name2, ...] => class_name
-[:$global_variable_name1, :$global_variable_name2, ...] => [class_name1, class_name2, ...]
-
--Specify class of method return values:
-class_name => {:method_name1 => class_of_return_value, :method_name2 => [class_of_return_value1, class_of_return_value2, ...], ...}
-
--Specify class of constants:
-<<<Sorry, not yet documented. >>>
-
-
-*** Compilation
-You can compile Ruby method into C extension by followings.
-
--Compile instance method
---API
-CastOff.compile(target(Class or Module), method_name(Symbol))
-CastOff.compile(target(Class or Module), method_name(Symbol), class_information(Hash))
-CastOff.compile(target(Class or Module), method_name(Symbol), binding(Binding))
-CastOff.compile(target(Class or Module), method_name(Symbol), binding(Binding), class_information(Hash))
---Notes
-This API compiles Ruby instance method into C extension and loads compiled method.
-You should specify method_name(second argument) by Symbol class.
-CastOff uses binding(third argument) to resolve Ruby constants.
-
--Compile singleton method
---API
-CastOff.compile_singleton_method(target(Any Object), method_name(Symbol))
-CastOff.compile_singleton_method(target(Any Object), method_name(Symbol), class_information(Hash))
-CastOff.compile_singleton_method(target(Any Object), method_name(Symbol), binding(Binding))
-CastOff.compile_singleton_method(target(Any Object), method_name(Symbol), binding(Binding), class_information(Hash))
---Notes
-This API compiles Ruby singleton method into C extension and loads compiled method.
-You should not use CastOff.compile when compile singleton method.
-You should specify method_name(second argument) by Symbol class.
-CastOff uses binding(third argument) to resolve Ruby constants.
-
--Compile Ruby code and execute
---API
-CastOff.execute(class_information(Hash)) { target code }
---Notes
-This API compiles passed block and executes.
-
-
-*** Compile options
-<<<Sorry, not yet documented. >>>
-