[ruby-core:82596] [Ruby trunk Feature#13849] Show --dump options in help

Issue #13849 has been updated by sonots (Naotoshi Seo).


Sorry for raising a discussion again.
I noticed that Features list are shown bottom at --help.

```
$ ruby --help
  --enable=feature[,...], --disable=feature[,...]
                  enable or disable features
  --external-encoding=encoding, --internal-encoding=encoding
                  specify the default external or internal character encoding
  --version       print the version
  --help          show this message, -h for short message
Features:
  gems            rubygems (default: enabled)
  did_you_mean    did_you_mean (default: enabled)
  rubyopt         RUBYOPT environment variable (default: enabled)
  frozen-string-literal
                  freeze all string literals (default: disabled)
```

I now feel showing dump lists with `--help=dump` does not have a consistency.
I have two idea.

(1) Show dump list at bottom as features list

```
$ ruby --help
  --dump=target[,...]
                  dump debug information. target is such as insns shown below
  --enable=feature[,...], --disable=feature[,...]
                  enable or disable features shown below
  --external-encoding=encoding, --internal-encoding=encoding
                  specify the default external or internal character encoding
  --version       print the version
  --help          show this message, -h for short message
Dump Targets:
  insns    dump instruction sequences
  ydebug  dump yydebug of yacc parser generator
  parsetree, parsetree_with_comment
                  dump AST or AST with comments.  
Features:
  gems            rubygems (default: enabled)
  did_you_mean    did_you_mean (default: enabled)
  rubyopt         RUBYOPT environment variable (default: enabled)
  frozen-string-literal
                  freeze all string literals (default: disabled)
```

(2) Move features list to --help=feature

```
$ ./ruby --help=feature
Usage: ./ruby [switches] [--] [programfile] [arguments]
  gems            rubygems (default: enabled)
  did_you_mean    did_you_mean (default: enabled)
  rubyopt         RUBYOPT environment variable (default: enabled)
  frozen-string-literal
                  freeze all string literals (default: disabled)
```

```
$ ./ruby --help=dump
Usage: ./ruby [switches] [--] [programfile] [arguments]
  insns    dump instruction sequences
  yydebug  dump yydebug of yacc parser generator
  parsetree, parsetree_with_comment
                  dump AST or AST with comments.
```

I feel (2) is better based on the matz principle to keep help as compact as possible.


----------------------------------------
Feature #13849: Show --dump options in help
https://bugs.ruby-lang.org/issues/13849#change-66419

* Author: sonots (Naotoshi Seo)
* Status: Open
* Priority: Normal
* Assignee: sonots (Naotoshi Seo)
* Target version: Next Major
----------------------------------------
Current help does not show any helps for --dump options such as --dump=insns.
I want to get them.

```
$ ./ruby --help
Usage: ./ruby [switches] [--] [programfile] [arguments]
  -0[octal]       specify record separator (\0, if no argument)
  -a              autosplit mode with -n or -p (splits $_ into $F)
  -c              check syntax only
  -Cdirectory     cd to directory before executing your script
  -d, --debug     set debugging flags (set $DEBUG to true)
  -e 'command'    one line of script. Several -e's allowed. Omit [programfile]
  -Eex[:in], --encoding=ex[:in]
                  specify the default external and internal character encodings
  -Fpattern       split() pattern for autosplit (-a)
  -i[extension]   edit ARGV files in place (make backup if extension supplied)
  -Idirectory     specify $LOAD_PATH directory (may be used more than once)
  -l              enable line ending processing
  -n              assume 'while gets(); ... end' loop around your script
  -p              assume loop like -n but print line also like sed
  -rlibrary       require the library before executing your script
  -s              enable some switch parsing for switches after script name
  -S              look for the script using PATH environment variable
  -T[level=1]     turn on tainting checks
  -v, --verbose   print version number, then turn on verbose mode
  -w              turn warnings on for your script
  -W[level=2]     set warning level; 0=silence, 1=medium, 2=verbose
  -x[directory]   strip off text before #!ruby line and perhaps cd to directory
  --copyright     print the copyright
  --enable=feature[,...], --disable=feature[,...]
                  enable or disable features
  --external-encoding=encoding, --internal-encoding=encoding
                  specify the default external or internal character encoding
  --version       print the version
  --help          show this message, -h for short message
Features:
  gems            rubygems (default: enabled)
  did_you_mean    did_you_mean (default: enabled)
  rubyopt         RUBYOPT environment variable (default: enabled)
  frozen-string-literal
                  freeze all string literals (default: disabled)
```




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

Unsubscribe: <mailto:[e-mail]?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>