diff --git a/hack/man-page-checker b/hack/man-page-checker
index dceb1b77..a340c929 100755
--- a/hack/man-page-checker
+++ b/hack/man-page-checker
@@ -81,7 +81,7 @@ function compare_usage() {
     from_man=$(sed -E -e "s/\*\*$cmd\*\*[[:space:]]*//" <<<"$from_man")
     from_help=$(sed -E -e "s/^[[:space:]]*$cmd[[:space:]]*//" <<<"$from_help")
 
-    # man page lists 'foo [*options*]', help msg shows 'foo [flags]'.
+    # man page lists 'foo [*options*]', help msg shows 'foo [command options]'.
     # Make sure if one has it, the other does too.
     if expr "$from_man" : "\[\*options\*\]" >/dev/null; then
         if expr "$from_help" : "\[command options\]" >/dev/null; then
@@ -102,7 +102,7 @@ function compare_usage() {
     # Constant strings in man page are '**foo**', in --help are 'foo'.
     from_man=$(sed -E -e 's/\*\*([^*]+)\*\*/\1/g' <<<"$from_man")
 
-    # Args in man page are '*foo*', in --help are 'FOO'. Convert all to
+    # Args in man page are '_foo_', in --help are 'FOO'. Convert all to
     # UPCASE simply because it stands out better to the eye.
     from_man=$(sed -E -e 's/_([a-z-]+)_/\U\1/g' <<<"$from_man")