1 files changed, 4 insertions, 1 deletions
diff --git a/doc/rg.1 b/doc/rg.1
index c0c1df0d..1b346740 100644
--- a/doc/rg.1
+++ b/doc/rg.1
@@ -274,8 +274,11 @@ Only show path of each file with no matches.
 .RE
 .TP
 .B \-H, \-\-with\-filename
-Prefix each match with the file name that contains it.
+Display the file name for matches.
 This is the default when more than one file is searched.
+If \-\-heading is enabled, the file name will be shown above clusters of
+matches from each file; otherwise, the file name will be shown on each
+match.
 .RS
 .RE
 .TP