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