kotovalexarian-likes-github/ruby--ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
Code Releases Activity

[ci skip] Improve man page docs around --dump options

Browse source
This commit is contained in:
Matt Valentine-House 2022-06-27 13:35:22 +01:00 • committed by Peter Zhu
parent 7d211c93af
commit ca85bd818a
Notes: git 2022-06-28 23:10:45 +09:00
1 changed files with 21 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

40
man/ruby.1
View file

@ -423,35 +423,37 @@ Dump some information.
.Pp .Pp
Prints the specified target. Prints the specified target.
.Ar target .Ar target
can be one of; can be one of:
.Bl -hang -offset indent .Bl -hang -offset indent
.It Sy version .It Sy version
version description same as Print version description (same as
.Fl -version .Fl -version).
.It Sy usage .It Sy usage
brief usage message same as Print a brief usage message (same as
.Fl h .Fl h).
.It Sy help .It Sy help
Show long help message same as Show long help message (same as
.Fl -help .Fl -help).
.It Sy syntax .It Sy syntax
check of syntax same as Check syntax (same as
.Fl c .Fl c
.Fl -yydebug .Fl -yydebug).
.Pp
.El
.Pp
Or one of the following, which are intended for debugging the interpreter:
.Bl -hang -offset indent -tag -width "parsetree_with_comment"
.It Sy yydebug .It Sy yydebug
compiler debug mode, same as Enable compiler debug mode (same as
.Fl -yydebug .Fl -yydebug).
.Pp
Only specify this switch if you are going to debug the Ruby interpreter.
.It Sy parsetree .It Sy parsetree
Print a textual representation of the Ruby AST for the program.
.It Sy parsetree_with_comment .It Sy parsetree_with_comment
AST nodes tree Print a textual representation of the Ruby AST for the program, but with each node annoted with the associated Ruby source code.
.Pp
Only specify this switch if you are going to debug the Ruby interpreter.
.It Sy insns .It Sy insns
disassembled instructions Print a list of disassembled bytecode instructions.
.Pp .It Sy insns_without_opt
Only specify this switch if you are going to debug the Ruby interpreter. Print the list of disassembled bytecode instructions before various optimizations have been applied.
.El .El
.Pp .Pp
.It Fl -verbose .It Fl -verbose