From 97889ad57727ee2eb5dd08a01a0ee55066b81f30 Mon Sep 17 00:00:00 2001 From: Mike Gunderloy Date: Sun, 26 Feb 2012 20:21:24 -0600 Subject: [PATCH] Preserve square brackets in option listings --- Rakefile | 5 +- command-reference.md | 196 +++++++++++++++++++++---------------------- 2 files changed, 102 insertions(+), 99 deletions(-) diff --git a/Rakefile b/Rakefile index a678dee..fac746f 100644 --- a/Rakefile +++ b/Rakefile @@ -45,7 +45,9 @@ task :command_guide do # This will end up in a 
 block
           html_string += line
         else
+          puts html_string
           html_string += line.gsub("<", "<").gsub(">", ">")
+          puts html_string
         end
         html_string += "\n"
       end
@@ -72,7 +74,8 @@ task :command_guide do
       break if (helpline =~ /Arguments/) || (helpline =~  /Summary/)
       unless helpline.gsub(/\n/, '').strip == ''
         # Use zero-width space to prevent "helpful" change of -- to –
-        helpline = helpline.gsub('--', '-​-')
+        helpline = helpline.gsub('--', '-​-').gsub('[', '\\[').gsub(']', '\\]')
+
         if helpline =~ /^\s{10,}(.*)/
           options = options[0..-2] + " #{$1}\n"
         else
diff --git a/command-reference.md b/command-reference.md
index a6d7e8a..ef67463 100644
--- a/command-reference.md
+++ b/command-reference.md
@@ -50,7 +50,7 @@ Build a gem from a gemspec
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -89,7 +89,7 @@ Manage RubyGems certificates and signing settings
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -118,7 +118,7 @@ Check installed gems
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -145,7 +145,7 @@ Clean up old versions of installed gems in the local repository
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -181,13 +181,13 @@ Display the contents of the installed gems
 *     -v, -​-version VERSION          - Specify version of gem to contents
 *         -​-all                      - Contents for all gems
 *     -s, -​-spec-dir a,b,c           - Search for gems under specific paths
-*     -l, -​-[no-]lib-only            - Only return files in the Gem's lib_dirs
-*         -​-[no-]prefix              - Don't include installed path prefix
+*     -l, -​-\[no-\]lib-only            - Only return files in the Gem's lib_dirs
+*         -​-\[no-\]prefix              - Don't include installed path prefix
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -217,13 +217,13 @@ Show the dependencies of an installed gem
 
 *     -v, -​-version VERSION          - Specify version of gem to dependency
 *         -​-platform PLATFORM        - Specify the platform of gem to dependency
-*         -​-[no-]prerelease          - Allow prerelease versions of a gem
-*   - -R, -​-[no-]reverse-dependencies  Include reverse dependencies in the output
+*         -​-\[no-\]prerelease          - Allow prerelease versions of a gem
+*   - -R, -​-\[no-\]reverse-dependencies  Include reverse dependencies in the output
 *         -​-pipe                     - Pipe Format (name -​-version ver)
 
 ###   Deprecated Options:
 
-*     -u, -​-[no-]update-sources      - Update local source cache
+*     -u, -​-\[no-\]update-sources      - Update local source cache
 
 ###   Local/Remote Options:
 
@@ -233,12 +233,12 @@ Show the dependencies of an installed gem
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
 *         -​-clear-sources            - Clear the gem sources
 *         -​-source URL               - Add URL as a remote source for gems
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -267,7 +267,7 @@ Display information about the RubyGems environment
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -339,18 +339,18 @@ Download a gem and place it in the current directory
 
 *     -v, -​-version VERSION          - Specify version of gem to fetch
 *         -​-platform PLATFORM        - Specify the platform of gem to fetch
-*         -​-[no-]prerelease          - Allow prerelease versions of a gem
+*         -​-\[no-\]prerelease          - Allow prerelease versions of a gem
 
 ###   Local/Remote Options:
 
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 *         -​-source URL               - Add URL as a remote source for gems
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -379,8 +379,8 @@ Generates the index files for a gem server directory
 ###   Options:
 
 *     -d, -​-directory=DIRNAME        - repository base dir containing gems subdir
-*         -​-[no-]legacy              - Generate Marshal.4.8
-*         -​-[no-]modern              - Generate indexes for RubyGems newer than 1.2.0
+*         -​-\[no-\]legacy              - Generate Marshal.4.8
+*         -​-\[no-\]modern              - Generate indexes for RubyGems newer than 1.2.0
 *         -​-update                   - Update modern indexes with gems added since the last update
 
 ###   RSS Options:
@@ -392,7 +392,7 @@ Generates the index files for a gem server directory
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -446,7 +446,7 @@ Provide help on the 'gem' command
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -478,26 +478,26 @@ Install a gem into the local repository
 
 *         -​-platform PLATFORM        - Specify the platform of gem to install
 *     -v, -​-version VERSION          - Specify version of gem to install
-*         -​-[no-]prerelease          - Allow prerelease versions of a gem to be installed. (Only for listed gems)
+*         -​-\[no-\]prerelease          - Allow prerelease versions of a gem to be installed. (Only for listed gems)
 
 ###   Deprecated Options:
 
-*     -u, -​-[no-]update-sources      - Update local source cache
+*     -u, -​-\[no-\]update-sources      - Update local source cache
 
 ###   Install/Update Options:
 
 *     -i, -​-install-dir DIR          - Gem repository directory to get installed gems
 *     -n, -​-bindir DIR               - Directory where binary files are located
-*     -d, -​-[no-]rdoc                - Generate RDoc documentation for the gem on install
-*         -​-[no-]ri                  - Generate RI documentation for the gem on install
-*     -E, -​-[no-]env-shebang         - Rewrite the shebang line on installed scripts to use /usr/bin/env
-*     -f, -​-[no-]force               - Force gem to install, bypassing dependency checks
-*     -w, -​-[no-]wrappers            - Use bin wrappers for executables Not available on dosish platforms
+*     -d, -​-\[no-\]rdoc                - Generate RDoc documentation for the gem on install
+*         -​-\[no-\]ri                  - Generate RI documentation for the gem on install
+*     -E, -​-\[no-\]env-shebang         - Rewrite the shebang line on installed scripts to use /usr/bin/env
+*     -f, -​-\[no-\]force               - Force gem to install, bypassing dependency checks
+*     -w, -​-\[no-\]wrappers            - Use bin wrappers for executables Not available on dosish platforms
 *     -P, -​-trust-policy POLICY      - Specify gem trust policy
 *         -​-ignore-dependencies      - Do not install any required dependent gems
 *     -y, -​-include-dependencies     - Unconditionally install the required dependent gems
-*         -​-[no-]format-executable   - Make installed executable names match ruby. If ruby is ruby18, foo_exec will be foo_exec18
-*         -​-[no-]user-install        - Install in user's home directory instead of GEM_HOME.
+*         -​-\[no-\]format-executable   - Make installed executable names match ruby. If ruby is ruby18, foo_exec will be foo_exec18
+*         -​-\[no-\]user-install        - Install in user's home directory instead of GEM_HOME.
 *         -​-development              - Install any additional development dependencies
 *         -​-conservative             - Don't attempt to upgrade gems already meeting version requirement
 
@@ -509,12 +509,12 @@ Install a gem into the local repository
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
 *         -​-clear-sources            - Clear the gem sources
 *         -​-source URL               - Add URL as a remote source for gems
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -592,16 +592,16 @@ Display gems whose name starts with STRING
 
 ###   Options:
 
-*     -i, -​-[no-]installed           - Check for installed gem
+*     -i, -​-\[no-\]installed           - Check for installed gem
 *     -v, -​-version VERSION          - Specify version of gem to list for use with -​-installed
-*     -d, -​-[no-]details             - Display detailed information of gem(s)
-*         -​-[no-]versions            - Display only gem names
+*     -d, -​-\[no-\]details             - Display detailed information of gem(s)
+*         -​-\[no-\]versions            - Display only gem names
 *     -a, -​-all                      - Display all gem versions
-*         -​-[no-]prerelease          - Display prerelease versions
+*         -​-\[no-\]prerelease          - Display prerelease versions
 
 ###   Deprecated Options:
 
-*     -u, -​-[no-]update-sources      - Update local source cache
+*     -u, -​-\[no-\]update-sources      - Update local source cache
 
 ###   Local/Remote Options:
 
@@ -611,12 +611,12 @@ Display gems whose name starts with STRING
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
 *         -​-clear-sources            - Clear the gem sources
 *         -​-source URL               - Add URL as a remote source for gems
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -644,12 +644,12 @@ Generate a lockdown list of gems
 
 ###   Options:
 
-*     -s, -​-[no-]strict              - fail if unable to satisfy a dependency
+*     -s, -​-\[no-\]strict              - fail if unable to satisfy a dependency
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -713,7 +713,7 @@ Display all gems that need updates
 
 ###   Deprecated Options:
 
-*     -u, -​-[no-]update-sources      - Update local source cache
+*     -u, -​-\[no-\]update-sources      - Update local source cache
 
 ###   Local/Remote Options:
 
@@ -723,12 +723,12 @@ Display all gems that need updates
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
 *         -​-clear-sources            - Clear the gem sources
 *         -​-source URL               - Add URL as a remote source for gems
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -756,12 +756,12 @@ Manage gem owners on RubyGems.org.
 
 ###   Local/Remote Options:
 
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -794,13 +794,13 @@ Restores installed gems to pristine condition from files located in the gem cach
 ###   Options:
 
 *         -​-all                      - Restore all installed gems to pristine condition
-*         -​-[no-]extensions          - Restore gems with extensions
+*         -​-\[no-\]extensions          - Restore gems with extensions
 *     -v, -​-version VERSION          - Specify version of gem to restore to pristine condition
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -848,12 +848,12 @@ Push a gem up to RubyGems.org
 
 ###   Local/Remote Options:
 
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -885,17 +885,17 @@ Query gem information in local or remote repositories
 
 ###   Options:
 
-*     -i, -​-[no-]installed           - Check for installed gem
+*     -i, -​-\[no-\]installed           - Check for installed gem
 *     -v, -​-version VERSION          - Specify version of gem to query for use with -​-installed
 *     -n, -​-name-matches REGEXP      - Name of gem(s) to query on matches the provided REGEXP
-*     -d, -​-[no-]details             - Display detailed information of gem(s)
-*         -​-[no-]versions            - Display only gem names
+*     -d, -​-\[no-\]details             - Display detailed information of gem(s)
+*         -​-\[no-\]versions            - Display only gem names
 *     -a, -​-all                      - Display all gem versions
-*         -​-[no-]prerelease          - Display prerelease versions
+*         -​-\[no-\]prerelease          - Display prerelease versions
 
 ###   Deprecated Options:
 
-*     -u, -​-[no-]update-sources      - Update local source cache
+*     -u, -​-\[no-\]update-sources      - Update local source cache
 
 ###   Local/Remote Options:
 
@@ -905,12 +905,12 @@ Query gem information in local or remote repositories
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
 *         -​-clear-sources            - Clear the gem sources
 *         -​-source URL               - Add URL as a remote source for gems
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -933,15 +933,15 @@ Generates RDoc for pre-installed gems
 ###   Options:
 
 *         -​-all                      - Generate RDoc/RI documentation for all installed gems
-*         -​-[no-]rdoc                - Generate RDoc HTML
-*         -​-[no-]ri                  - Generate RI data
-*         -​-[no-]overwrite           - Overwrite installed documents
+*         -​-\[no-\]rdoc                - Generate RDoc HTML
+*         -​-\[no-\]ri                  - Generate RI data
+*         -​-\[no-\]overwrite           - Overwrite installed documents
 *     -v, -​-version VERSION          - Specify version of gem to rdoc
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -974,16 +974,16 @@ Display all gems whose name contains STRING
 
 ###   Options:
 
-*     -i, -​-[no-]installed           - Check for installed gem
+*     -i, -​-\[no-\]installed           - Check for installed gem
 *     -v, -​-version VERSION          - Specify version of gem to search for use with -​-installed
-*     -d, -​-[no-]details             - Display detailed information of gem(s)
-*         -​-[no-]versions            - Display only gem names
+*     -d, -​-\[no-\]details             - Display detailed information of gem(s)
+*         -​-\[no-\]versions            - Display only gem names
 *     -a, -​-all                      - Display all gem versions
-*         -​-[no-]prerelease          - Display prerelease versions
+*         -​-\[no-\]prerelease          - Display prerelease versions
 
 ###   Deprecated Options:
 
-*     -u, -​-[no-]update-sources      - Update local source cache
+*     -u, -​-\[no-\]update-sources      - Update local source cache
 
 ###   Local/Remote Options:
 
@@ -993,12 +993,12 @@ Display all gems whose name contains STRING
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
 *         -​-clear-sources            - Clear the gem sources
 *         -​-source URL               - Add URL as a remote source for gems
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -1028,14 +1028,14 @@ Documentation and gem repository HTTP server
 
 *     -p, -​-port=PORT                - port to listen on
 *     -d, -​-dir=GEMDIR               - directories from which to serve gems multiple directories may be provided
-*         -​-[no-]daemon              - run as a daemon
+*         -​-\[no-\]daemon              - run as a daemon
 *     -b, -​-bind=HOST,HOST           - addresses to bind
-*     -l, -​-launch[=COMMAND]         - launches a browser window COMMAND defaults to 'start' on Windows and 'open' on all other platforms
+*     -l, -​-launch\[=COMMAND\]         - launches a browser window COMMAND defaults to 'start' on Windows and 'open' on all other platforms
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -1082,12 +1082,12 @@ Manage the sources and cache file RubyGems uses to search for gems
 
 ###   Local/Remote Options:
 
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -1118,7 +1118,7 @@ Display gem specification (in yaml)
 
 ###   Deprecated Options:
 
-*     -u, -​-[no-]update-sources      - Update local source cache
+*     -u, -​-\[no-\]update-sources      - Update local source cache
 
 ###   Local/Remote Options:
 
@@ -1128,12 +1128,12 @@ Display gem specification (in yaml)
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
 *         -​-clear-sources            - Clear the gem sources
 *         -​-source URL               - Add URL as a remote source for gems
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -1163,7 +1163,7 @@ List gems along with access times
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -1185,20 +1185,20 @@ Uninstall gems from the local repository
 
 ###   Options:
 
-*     -a, -​-[no-]all                 - Uninstall all matching versions
-*     -I, -​-[no-]ignore-dependencies - Ignore dependency requirements while uninstalling
-*     -x, -​-[no-]executables         - Uninstall applicable executables without confirmation
+*     -a, -​-\[no-\]all                 - Uninstall all matching versions
+*     -I, -​-\[no-\]ignore-dependencies - Ignore dependency requirements while uninstalling
+*     -x, -​-\[no-\]executables         - Uninstall applicable executables without confirmation
 *     -i, -​-install-dir DIR          - Directory to uninstall gem from
 *     -n, -​-bindir DIR               - Directory to remove binaries from
-*         -​-[no-]user-install        - Uninstall from user's home directory in addition to GEM_HOME.
-*         -​-[no-]format-executable   - Assume executable names match Ruby's prefix and suffix.
+*         -​-\[no-\]user-install        - Uninstall from user's home directory in addition to GEM_HOME.
+*         -​-\[no-\]format-executable   - Assume executable names match Ruby's prefix and suffix.
 *     -v, -​-version VERSION          - Specify version of gem to uninstall
 *         -​-platform PLATFORM        - Specify the platform of gem to uninstall
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -1233,7 +1233,7 @@ Unpack an installed gem to the current directory
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -1261,28 +1261,28 @@ Update the named gems (or all installed gems) in the local repository
 
 ###   Options:
 
-*         -​-system [VERSION]         - Update the RubyGems system software
+*         -​-system \[VERSION\]         - Update the RubyGems system software
 *         -​-platform PLATFORM        - Specify the platform of gem to update
-*         -​-[no-]prerelease          - Allow prerelease versions of a gem as update targets
+*         -​-\[no-\]prerelease          - Allow prerelease versions of a gem as update targets
 
 ###   Deprecated Options:
 
-*     -u, -​-[no-]update-sources      - Update local source cache
+*     -u, -​-\[no-\]update-sources      - Update local source cache
 
 ###   Install/Update Options:
 
 *     -i, -​-install-dir DIR          - Gem repository directory to get installed gems
 *     -n, -​-bindir DIR               - Directory where binary files are located
-*     -d, -​-[no-]rdoc                - Generate RDoc documentation for the gem on install
-*         -​-[no-]ri                  - Generate RI documentation for the gem on install
-*     -E, -​-[no-]env-shebang         - Rewrite the shebang line on installed scripts to use /usr/bin/env
-*     -f, -​-[no-]force               - Force gem to install, bypassing dependency checks
-*     -w, -​-[no-]wrappers            - Use bin wrappers for executables Not available on dosish platforms
+*     -d, -​-\[no-\]rdoc                - Generate RDoc documentation for the gem on install
+*         -​-\[no-\]ri                  - Generate RI documentation for the gem on install
+*     -E, -​-\[no-\]env-shebang         - Rewrite the shebang line on installed scripts to use /usr/bin/env
+*     -f, -​-\[no-\]force               - Force gem to install, bypassing dependency checks
+*     -w, -​-\[no-\]wrappers            - Use bin wrappers for executables Not available on dosish platforms
 *     -P, -​-trust-policy POLICY      - Specify gem trust policy
 *         -​-ignore-dependencies      - Do not install any required dependent gems
 *     -y, -​-include-dependencies     - Unconditionally install the required dependent gems
-*         -​-[no-]format-executable   - Make installed executable names match ruby. If ruby is ruby18, foo_exec will be foo_exec18
-*         -​-[no-]user-install        - Install in user's home directory instead of GEM_HOME.
+*         -​-\[no-\]format-executable   - Make installed executable names match ruby. If ruby is ruby18, foo_exec will be foo_exec18
+*         -​-\[no-\]user-install        - Install in user's home directory instead of GEM_HOME.
 *         -​-development              - Install any additional development dependencies
 *         -​-conservative             - Don't attempt to upgrade gems already meeting version requirement
 
@@ -1294,12 +1294,12 @@ Update the named gems (or all installed gems) in the local repository
 *     -B, -​-bulk-threshold COUNT     - Threshold for switching to bulk synchronization (default 1000)
 *         -​-clear-sources            - Clear the gem sources
 *         -​-source URL               - Add URL as a remote source for gems
-*     -p, -​-[no-]http-proxy [URL]    - Use HTTP proxy for remote operations
+*     -p, -​-\[no-\]http-proxy \[URL\]    - Use HTTP proxy for remote operations
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors
@@ -1327,13 +1327,13 @@ Find the location of a library file you can require
 
 ###   Options:
 
-*     -a, -​-[no-]all                 - show all matching files
-*     -g, -​-[no-]gems-first          - search gems before non-gems
+*     -a, -​-\[no-\]all                 - show all matching files
+*     -g, -​-\[no-\]gems-first          - search gems before non-gems
 
 ###   Common Options:
 
 *     -h, -​-help                     - Get help on this command
-*     -V, -​-[no-]verbose             - Set the verbose level of output
+*     -V, -​-\[no-\]verbose             - Set the verbose level of output
 *     -q, -​-quiet                    - Silence commands
 *         -​-config-file FILE         - Use this config file instead of default
 *         -​-backtrace                - Show stack backtrace on errors