Bug #15359


Bundler help is not properly integrated

Added by vo.x (Vit Ondruch) almost 4 years ago. Updated over 2 years ago.

Target version:
ruby -v:
ruby 2.6.0dev (2018-11-26 trunk 65990) [x86_64-linux]


Bundler has nice help, but it is a bit complex 1. It ideally needs man command installed but it definitely needs the help source files, which are not placed on proper location to be reachable by BUndler from StdLib. In that case, Bundler fallbacks to the simplest help provided by its Thor based CLI, but that is probably not the user experience integrated Bundler should provide.

For comparison, this is the official help:

 bundler --help
BUNDLE(1)							     BUNDLE(1)

       bundle - Ruby Dependency Management

... snip ...

       These commands are obsolete and should no longer be used

       o   bundle cache(1)

       o   bundle show(1)

				   July 2017			     BUNDLE(1)

and this is the help output provided by the bundled Bundler:

# bundler --help
Bundler commands:
  bundler add GEM VERSION         # Add gem to Gemfile and run bundle install

... snip ...

  bundler version                 # Prints the bundler's version information

      [--no-color]                 # Disable colorization in output
  -r, [--retry=NUM]                # Specify the number of times you wish to attempt network commands
  -V, [--verbose], [--no-verbose]  # Enable verbose output mode

Related issues 1 (0 open1 closed)

Related to Ruby master - Bug #17778: Properly install Bundler man pagesThird Party's IssueActions
Actions #1

Updated by vo.x (Vit Ondruch) almost 4 years ago

BTW I am not sure how the Bundler man pages are imported into Ruby repository, but I think there should be either the source .ronn files or the resulting .txt files and man page files. Not both.

Updated by shevegen (Robert A. Heiler) almost 4 years ago

I can't comment on the issue itself but I wanted to add that I personally do not
use man-pages. I use the commandline "--help" flag, though, and of course online
queries for help (and then I often put useful bits into a local knowledgebase; I
did so for ruby as well).

Of course others may benefit from man-pages still, but I think that "--help"
is probably the number one way for many ruby users, especially linux users,
for quick help; whereas "man bundler" would be significantly less commonly
used, I'd assume.

The second result seems a lot more useful to me than the first one by the
way. I am not even sure it is very useful to tell users that things may
be obsolete ... :-)

Actions #3

Updated by hsbt (Hiroshi SHIBATA) almost 4 years ago

  • Status changed from Open to Assigned
Actions #4

Updated by hsbt (Hiroshi SHIBATA) over 2 years ago

  • Status changed from Assigned to Closed

Applied in changeset [ruby-core:90164]" href="/projects/ruby-master/repository/git/revisions/b9962f0e8909b1163320fbcfe80060a259b2353d">git|b9962f0e8909b1163320fbcfe80060a259b2353d.

Fixed incorrect man path with ruby installation path

[Bug #15359][ruby-core:90164]

Updated by hsbt (Hiroshi SHIBATA) over 2 years ago

I added the workaround for man path with ruby installation. But we should care about the convention of Linux distribution.

Welcome to additional patches.

Actions #6

Updated by vo.x (Vit Ondruch) over 1 year ago

  • Related to Bug #17778: Properly install Bundler man pages added

Also available in: Atom PDF