diff options
Diffstat (limited to 'manual/src/grep.md')
-rw-r--r-- | manual/src/grep.md | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/manual/src/grep.md b/manual/src/grep.md index cd1e129d..60a61d07 100644 --- a/manual/src/grep.md +++ b/manual/src/grep.md @@ -4,3 +4,17 @@ Delta applies syntax-highlighting and other enhancements to standard grep output If you don't need special features of `git grep`, then for best results pipe `rg --json` output to delta: this avoids parsing ambiguities that are inevitable with the output of `git grep` and `grep`. To customize the colors and syntax highlighting, see `grep-match-line-style`, `grep-match-word-style`, `grep-context-line-style`, `grep-file-style`, `grep-line-number-style`. Note that `git grep` can display the "function context" for matches and that delta handles this output specially: see the `-p` and `-W` options of `git grep`. + +```sh +rg --json handle | delta +``` + +<table><tr><td><img width=400px src="https://user-images.githubusercontent.com/52205/225271024-a01367f0-af1b-466a-9b9e-b1ced7f80031.png" alt="image" /></td></tr></table> + +If you enable hyperlinks then grep hits will be formatted as [OSC8 hyperlinks](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda) in terminal emulators that support the feature. It is then possible to make your OS handle a click on those links by opening your editor at the correct file and line number (e.g. via <https://github.com/dandavison/open-in-editor/>). + +```gitconfig +[delta] + hyperlinks = true + hyperlinks-file-link-format = "file-line://{path}:{line}" +``` |