diff --git a/Library/Homebrew/cask/cmd.rb b/Library/Homebrew/cask/cmd.rb
index c5dc653c5f..cee4589519 100644
--- a/Library/Homebrew/cask/cmd.rb
+++ b/Library/Homebrew/cask/cmd.rb
@@ -78,7 +78,6 @@ module Cask
Commands:
#{command_lines.join}
-
See also: `man brew`
EOS
end
diff --git a/Library/Homebrew/cli/parser.rb b/Library/Homebrew/cli/parser.rb
index a758d4ece9..433bf8fdbf 100644
--- a/Library/Homebrew/cli/parser.rb
+++ b/Library/Homebrew/cli/parser.rb
@@ -176,7 +176,7 @@ module Homebrew
def usage_banner_text
@parser.banner
- .gsub(/^ - (`[^`]+`)\s+/, "\n- \\1 \n ") # Format `cask` subcommands as MarkDown list.
+ .gsub(/^ - (`[^`]+`)\s+/, "\n- \\1:\n
") # Format `cask` subcommands as Markdown list.
end
def comma_array(name, description: nil)
diff --git a/Library/Homebrew/dev-cmd/man.rb b/Library/Homebrew/dev-cmd/man.rb
index 6a3e27c372..24fe0e0ff7 100644
--- a/Library/Homebrew/dev-cmd/man.rb
+++ b/Library/Homebrew/dev-cmd/man.rb
@@ -135,6 +135,8 @@ module Homebrew
when "--markdown"
ronn_output = ronn_output.gsub(%r{(.*?)}, "*`\\1`*")
.gsub(/\n\n\n+/, "\n\n")
+ .gsub(/^(- `[^`]+`):/, "\\1") # drop trailing colons from definition lists
+ .gsub(/(?<=\n\n)([\[`].+):\n/, "\\1\n
") # replace colons with
on subcommands
when "--roff"
ronn_output = ronn_output.gsub(%r{(.*?)
}, "\\fB\\1\\fR")
.gsub(%r{(.*?)}, "\\fI\\1\\fR")
@@ -234,10 +236,10 @@ module Homebrew
sig { returns(String) }
def env_vars_manpage
lines = Homebrew::EnvConfig::ENVS.flat_map do |env, hash|
- entry = " * `#{env}`:\n #{hash[:description]}\n"
+ entry = "- `#{env}`:\n
#{hash[:description]}\n"
default = hash[:default_text]
default ||= "`#{hash[:default]}`." if hash[:default]
- entry += "\n\n *Default:* #{default}\n" if default
+ entry += "\n\n *Default:* #{default}\n" if default
entry
end