Add all the top level comments

1 files changed, 14 insertions, 0 deletions

diff --git a/Library/Homebrew/cmd/outdated.rb b/Library/Homebrew/cmd/outdated.rb
index dbcf94ae8..dfd61226a 100644
--- a/Library/Homebrew/cmd/outdated.rb
+++ b/Library/Homebrew/cmd/outdated.rb
@@ -1,3 +1,17 @@
+#:  * `outdated` [`--quiet`|`--verbose`|`--json=v1`]:
+#:    Show formulae that have an updated version available.
+#:
+#:    By default, version information is displayed in interactive shells, and
+#:    suppressed otherwise.
+#:
+#:    If `--quiet` is passed, list only the names of outdated brews (takes
+#:    precedence over `--verbose`).
+#:
+#:    If `--verbose` is passed, display detailed version information.
+#:
+#:    If `--json=`<version> is passed, the output will be in JSON format. The only
+#:    valid version is `v1`.
+
 require "formula"
 require "keg"