[rubygems/rubygems] Improve doctor CLI flag documentation

Name default value placeholders in a more standard way. That's what our
specs check, but they don't yet work for subcommand flags.

ruby/rubygems@c589899cb8

Author: deivid-rodriguez

lib/bundler/man/bundle-doctor.1

@@ -6,7 +6,7 @@
 .SH "SYNOPSIS"
 \fBbundle doctor [diagnose]\fR [\-\-quiet] [\-\-gemfile=GEMFILE] [\-\-ssl]
 .br
-\fBbundle doctor ssl\fR [\-\-host=HOST] [\-\-tls\-version=VERSION] [\-\-verify\-mode=MODE]
+\fBbundle doctor ssl\fR [\-\-host=HOST] [\-\-tls\-version=TLS\-VERSION] [\-\-verify\-mode=VERIFY\-MODE]
 .br
 \fBbundle doctor\fR help [COMMAND]
 .SH "DESCRIPTION"
@@ -57,12 +57,12 @@ Open a TLS connection and verify the outcome\.
 \fB\-\-host=HOST\fR
 Perform the diagnostic on HOST\. Defaults to \fBrubygems\.org\fR\.
 .TP
-\fB\-\-tls\-version=VERSION\fR
+\fB\-\-tls\-version=TLS\-VERSION\fR
 Specify the TLS version when opening the connection to HOST\.
 .IP
 Accepted values are: \fB1\.1\fR or \fB1\.2\fR\.
 .TP
-\fB\-\-verify\-mode=MODE\fR
+\fB\-\-verify\-mode=VERIFY\-MODE\fR
 Specify the TLS verify mode when opening the connection to HOST\. Defaults to \fBSSL_VERIFY_PEER\fR\.
 .IP
 Accepted values are: \fBCLIENT_ONCE\fR, \fBFAIL_IF_NO_PEER_CERT\fR, \fBNONE\fR, \fBPEER\fR\.

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

@@ -7,8 +7,8 @@ bundle-doctor(1) -- Checks the bundle for common problems
                            [--gemfile=GEMFILE]
                            [--ssl]<br>
 `bundle doctor ssl` [--host=HOST]
-                    [--tls-version=VERSION]
-                    [--verify-mode=MODE]<br>
+                    [--tls-version=TLS-VERSION]
+                    [--verify-mode=VERIFY-MODE]<br>
 `bundle doctor` help [COMMAND]
 
 ## DESCRIPTION
@@ -65,12 +65,12 @@ The diagnostic will perform a few checks such as:
 * `--host=HOST`:
   Perform the diagnostic on HOST. Defaults to `rubygems.org`.
 
-* `--tls-version=VERSION`:
+* `--tls-version=TLS-VERSION`:
   Specify the TLS version when opening the connection to HOST.
 
   Accepted values are: `1.1` or `1.2`.
 
-* `--verify-mode=MODE`:
+* `--verify-mode=VERIFY-MODE`:
   Specify the TLS verify mode when opening the connection to HOST.
   Defaults to `SSL_VERIFY_PEER`.