[ruby-core:97689] [Ruby master Feature#16754] Pager for `--help`

Issue #16754 has been updated by shevegen (Robert A. Heiler).


I think the basic idea for the suggestion is fine.

There may be cases where the ruby user may prefer to not use (or depend) on a page
and may be fine with a long message output from --help. This may also depend on
the terminal and shell in use.

For example, I typically use bash + KDE konsole, and I rarely use any pagers at
all (very rarely I pipe towards "more" but I actually try to work in a way so
that I don't need any pager; I am more inclined to write some ruby script that
does re-format any output I may see).

On the other hand, when I use e. g. xterm, and say, perhaps the fish shell,
I may need to use a pager more often, simply because configuring (and using)
xterm is ... not so convenient.

So I think the gist of what I am trying to say is that it may be best to allow
the user to toggle the behaviour, possibly simplest just via a configure
option, and if anyone else needs more then a separate issue could be created.
So perhaps a --no-pager option, if the pager display becomes the default; or
vice versa if it is not the default. (Or perhaps an ENV variable, but this
is probably not really needed; just giving a few suggestions for that
possible case.)

----------------------------------------
Feature #16754: Pager for `--help`
https://bugs.ruby-lang.org/issues/16754#change-84898

* Author: nobu (Nobuyoshi Nakada)
* Status: Open
* Priority: Normal
----------------------------------------
The help message by `--help` is getting longer and longer, and it often exceeds usual terminal windows.
How about to show the message via pager when running on a tty?

And although the message is sectioned, they are less remarkable in the long text, and should be highlighted more, like as the attached screenshot for example.

https://github.com/ruby/ruby/pull/3000

---Files--------------------------------
screenshot-help.gif (38 KB)


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

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