[rubygems/rubygems] Document missing options from man pages:

- The `bundle plugin uninstall --all` was missing.
- The `bundle plugin install --local-git` was missing due to being
  deprecated. We decided to reintroduce the doc for more clarity.

4da252945c

lib/bundler/man/bundle-plugin.1

@@ -6,7 +6,7 @@
 .SH "SYNOPSIS"
 \fBbundle plugin\fR install PLUGINS [\-\-source=\fISOURCE\fR] [\-\-version=\fIversion\fR] [\-\-git=\fIgit\-url\fR] [\-\-branch=\fIbranch\fR|\-\-ref=\fIrev\fR] [\-\-path=\fIpath\fR]
 .br
-\fBbundle plugin\fR uninstall PLUGINS
+\fBbundle plugin\fR uninstall PLUGINS [\-\-all]
 .br
 \fBbundle plugin\fR list
 .br
@@ -41,8 +41,16 @@ When you specify \fB\-\-git\fR, you can use \fB\-\-branch\fR or \fB\-\-ref\fR to
 .TP
 \fBbundle plugin install bundler\-graph \-\-path \.\./bundler\-graph\fR
 Install bundler\-graph gem from a local path\.
+.TP
+\fBbundle plugin install bundler\-graph \-\-local\-git \.\./bundler\-graph\fR
+This option is deprecated in favor of \fB\-\-git\fR\.
 .SS "uninstall"
 Uninstall the plugin(s) specified in PLUGINS\.
+.P
+\fBOPTIONS\fR
+.TP
+\fB\-\-all\fR
+Uninstall all the installed plugins\. If no plugin is installed, then it does nothing\.
 .SS "list"
 List the installed plugins and available commands\.
 .P

lib/bundler/man/bundle-plugin.1.ronn

@@ -6,7 +6,7 @@ bundle-plugin(1) -- Manage Bundler plugins
 `bundle plugin` install PLUGINS [--source=<SOURCE>] [--version=<version>]
                               [--git=<git-url>] [--branch=<branch>|--ref=<rev>]
                               [--path=<path>]<br>
-`bundle plugin` uninstall PLUGINS<br>
+`bundle plugin` uninstall PLUGINS [--all]<br>
 `bundle plugin` list<br>
 `bundle plugin` help [COMMAND]
 
@@ -42,10 +42,18 @@ Install the given plugin(s).
 * `bundle plugin install bundler-graph --path ../bundler-graph`:
   Install bundler-graph gem from a local path.
 
+* `bundle plugin install bundler-graph --local-git ../bundler-graph`:
+  This option is deprecated in favor of `--git`.
+
 ### uninstall
 
 Uninstall the plugin(s) specified in PLUGINS.
 
+**OPTIONS**
+
+* `--all`:
+  Uninstall all the installed plugins. If no plugin is installed, then it does nothing.
+
 ### list
 
 List the installed plugins and available commands.

spec/bundler/quality_spec.rb

@@ -288,8 +288,6 @@ RSpec.describe "The library itself" do
   end
 
   def cli_and_man_pages_in_sync!(commands)
-    undocumented_options = ["--all", "--local-git"]
-
     commands.each do |command_name, opts|
       man_page_path = man_tracked_files.find {|f| File.basename(f) == "bundle-#{command_name}.1.ronn" }
       expect(man_page_path).to_not be_nil, "The command #{command_name} has no associated man page."
@@ -298,8 +296,6 @@ RSpec.describe "The library itself" do
 
       man_page_content = File.read(man_page_path)
       opts.each do |option_name|
-        next if undocumented_options.include?(option_name.to_s)
-
         error_msg = <<~EOM
           The command #{command_name} has no mention of the option or subcommand `#{option_name}` in its man page.
           Document the `#{option_name}` in the man page to discard this error.