diff options
author | Andrew Gallant <jamslam@gmail.com> | 2016-11-28 17:39:45 -0500 |
---|---|---|
committer | Andrew Gallant <jamslam@gmail.com> | 2016-11-28 17:40:44 -0500 |
commit | d12bdf35a57733184f5db897f685d8626a1a4b18 (patch) | |
tree | 454b6c5dff488caf00c79dde71ebc23c0647a2b5 /doc | |
parent | 08514e8e6c88fe79bc2b30d2cc767b4fc1a901d9 (diff) |
Clarify use of --heading/--no-heading.
Fixes #247.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/rg.1 | 8 | ||||
-rw-r--r-- | doc/rg.1.md | 8 |
2 files changed, 11 insertions, 5 deletions
@@ -222,13 +222,17 @@ This is the default when one file is searched. .RE .TP .B \-\-heading -Show the file name above clusters of matches from each file. +Show the file name above clusters of matches from each file instead of +showing the file name for every match. This is the default mode at a tty. .RS .RE .TP .B \-\-no\-heading -Don\[aq]t show any file name heading. +Don\[aq]t group matches by each file. +If \-H/\-\-with\-filename is enabled, then file names will be shown for +every line matched. +This is the default more when not at a tty. .RS .RE .TP diff --git a/doc/rg.1.md b/doc/rg.1.md index 11487d69..f0fed3da 100644 --- a/doc/rg.1.md +++ b/doc/rg.1.md @@ -147,11 +147,13 @@ Project home page: https://github.com/BurntSushi/ripgrep one file is searched. --heading -: Show the file name above clusters of matches from each file. - This is the default mode at a tty. +: Show the file name above clusters of matches from each file instead of + showing the file name for every match. This is the default mode at a tty. --no-heading -: Don't show any file name heading. +: Don't group matches by each file. If -H/--with-filename is enabled, then + file names will be shown for every line matched. This is the default more + when not at a tty. --hidden : Search hidden directories and files. (Hidden directories and files are |