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

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

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

View file

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