From: tonytonyjan@...
Date: 2017-09-20T13:39:55+00:00
Subject: [ruby-core:82896] [Ruby trunk Feature#13924] Add a headings/hints to RubyVM::InstructionSequence#disasm

Issue #13924 has been reported by tonytonyjan (Wei-Hang Jian).

----------------------------------------
Feature #13924: Add a headings/hints to RubyVM::InstructionSequence#disasm
https://bugs.ruby-lang.org/issues/13924

* Author: tonytonyjan (Wei-Hang Jian)
* Status: Open
* Priority: Normal
* Assignee: 
* Target version: 
----------------------------------------
As the official document mentions, this method will return a String with the human readable instructions. However, it is quite hard to read since we can not understand the definition of each column, for example:

~~~ ruby
puts RubyVM::InstructionSequence.compile("[4, 5].max").disasm
== disasm: #<ISeq:<compiled>@<compiled>>================================
0000 trace            1                                               (   1)
0002 duparray         [4, 5]
0004 opt_send_without_block <callinfo!mid:max, argc:0, ARGS_SIMPLE>, <callcache>
0007 leave
~~~

There is no clue can inform us that "(  1)" stands for the line number, is it possible to either improve documentation or add some hints to the output string?



-- 
https://bugs.ruby-lang.org/

Unsubscribe: <mailto:ruby-core-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>