diff --git a/manpages/README.md b/manpages/README.md
index 580342535c..20e3cc744f 100644
--- a/manpages/README.md
+++ b/manpages/README.md
@@ -1,3 +1,3 @@
 # Manual pages
 
-This directory contains the generated Homebrew man pages from the `brew man` command. This command creates the output from `#:` comments in files, sections extracted from the repository's `README.md` and `brew.1.md.erb`.
+This directory contains the generated Homebrew man pages from the `brew man` command. This command creates the output from the `CLI::Parser` definitions in files, sections extracted from the repository's `README.md` and `brew.1.md.erb`.