Merge pull request #2440 from MikeMcQuaid/document-short-flags

Document all short flags.

4 files changed, 6 insertions, 4 deletions

diff --git a/Library/Homebrew/dev-cmd/bottle.rb b/Library/Homebrew/dev-cmd/bottle.rb
index b11da5607..8d3038a5a 100644
--- a/Library/Homebrew/dev-cmd/bottle.rb
+++ b/Library/Homebrew/dev-cmd/bottle.rb
@@ -6,7 +6,7 @@
 #:    generated DSL. Passing `--keep-old` will attempt to keep it at its
 #:    original value, while `--no-rebuild` will remove it.
 #:
-#:    If `--verbose` is passed, print the bottling commands and any warnings
+#:    If `--verbose` (or `-v`) is passed, print the bottling commands and any warnings
 #:    encountered.
 #:
 #:    If `--skip-relocation` is passed, do not check if the bottle can be marked
diff --git a/Library/Homebrew/dev-cmd/man.rb b/Library/Homebrew/dev-cmd/man.rb
index a146f23a8..4e5103910 100644
--- a/Library/Homebrew/dev-cmd/man.rb
+++ b/Library/Homebrew/dev-cmd/man.rb
@@ -106,7 +106,9 @@ module Homebrew
     Utils.popen(["ronn", format_flag] + shared_args, "rb+") do |ronn|
       ronn.write markup
       ronn.close_write
-      target.atomic_write ronn.read
+      ronn_output = ronn.read
+      ronn_output.gsub!(%r{</?var>}, "`") if format_flag == "--markdown"
+      target.atomic_write ronn_output
     end
   end
 
diff --git a/Library/Homebrew/dev-cmd/test.rb b/Library/Homebrew/dev-cmd/test.rb
index 4898629b0..288aa8a87 100644
--- a/Library/Homebrew/dev-cmd/test.rb
+++ b/Library/Homebrew/dev-cmd/test.rb
@@ -7,7 +7,7 @@
 #:    To test the development or head version of a formula, use `--devel` or
 #:    `--HEAD`.
 #:
-#:    If `--debug` is passed and the test fails, an interactive debugger will be
+#:    If `--debug` (or `-d`) is passed and the test fails, an interactive debugger will be
 #:    launched with access to IRB or a shell inside the temporary test directory.
 #:
 #:    If `--keep-tmp` is passed, the temporary files created for the test are
diff --git a/Library/Homebrew/dev-cmd/tests.rb b/Library/Homebrew/dev-cmd/tests.rb
index 18e7d96f2..91c7d880b 100644
--- a/Library/Homebrew/dev-cmd/tests.rb
+++ b/Library/Homebrew/dev-cmd/tests.rb
@@ -3,7 +3,7 @@
 #:    `--only=`<test_script> runs only <test_script>_spec.rb, and `--seed`
 #:    randomizes tests with the provided value instead of a random seed.
 #:
-#:    If `--verbose` is passed, print the command that runs the tests.
+#:    If `--verbose` (or `-v`) is passed, print the command that runs the tests.
 #:
 #:    If `--coverage` is passed, also generate code coverage reports.
 #: