From: sonots@... Date: 2017-09-01T00:46:59+00:00 Subject: [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: