manpages: relocate some sections

Reorder switches as force/quiet/verbose/debug, --installed before --all, and link to SPECIFYING FORMULAE from top of page.

Library/Homebrew/cmd/fetch.rb

@@ -19,11 +19,11 @@ module Homebrew
              description: "Fetch HEAD version instead of stable version."
       switch "--devel",
              description: "Fetch development version instead of stable version."
+      switch :force,
+             description: "Remove a previously cached version and re-fetch."
       switch :verbose,
              description: "Do a verbose VCS checkout, if the URL represents a VCS. This is useful for "\
                           "seeing if an existing VCS cache has been updated."
-      switch :force,
-             description: "Remove a previously cached version and re-fetch."
       switch "--retry",
              description: "Retry if a download fails or re-download if the checksum of a previously cached "\
                           "version no longer matches."

Library/Homebrew/cmd/gist-logs.rb

@@ -17,9 +17,6 @@ module Homebrew
 
         Upload logs for a failed build of <formula> to a new Gist.
 
-        <formula> is usually the name of the formula to install, but it can be specified
-        in several different ways.
-
         If no logs are found, an error message is presented.
       EOS
       switch "--with-hostname",

Library/Homebrew/cmd/install.rb

@@ -20,9 +20,6 @@ module Homebrew
 
         Install <formula>.
 
-        <formula> is usually the name of the formula to install, but it can be specified
-        in several different ways.
-
         Unless `HOMEBREW_NO_INSTALL_CLEANUP` is set, `brew cleanup` will be run for the
         installed formulae or, every 30 days, for all formulae.
       EOS

Library/Homebrew/cmd/options.rb

@@ -16,12 +16,12 @@ module Homebrew
       EOS
       switch "--compact",
              description: "Show all options on a single line separated by spaces."
-      switch "--all",
-             description: "Show options for all formulae."
       switch "--installed",
              description: "Show options for all installed formulae."
+      switch "--all",
+             description: "Show options for all available formulae."
       switch :debug
-      conflicts "--all", "--installed"
+      conflicts "--installed", "--all"
     end
   end
 

Library/Homebrew/cmd/postinstall.rb

@@ -14,8 +14,8 @@ module Homebrew
 
         Rerun the post-install steps for <formula>.
       EOS
-      switch :verbose
       switch :force
+      switch :verbose
       switch :debug
     end
   end

Library/Homebrew/cmd/update-report.rb

@@ -29,8 +29,8 @@ module Homebrew
              description: "Run in 'auto-update' mode (faster, less output)."
       switch :force
       switch :quiet
-      switch :debug
       switch :verbose
+      switch :debug
       hide_from_man_page!
     end
   end

Library/Homebrew/manpages/brew.1.md.erb

@@ -33,6 +33,9 @@ these flags should only appear after a command.
 
 Install <formula>.
 
+<formula> is usually the name of the formula to install, but it has other syntaxes which
+are listed in the [SPECIFYING FORMULAE](#specifying-formulae) section.
+
 ### `uninstall` <formula>:
 
 Uninstall <formula>.