diff options
| author | Jonas Bernoulli <jonas@bernoul.li> | 2026-03-19 21:34:34 +0100 |
|---|---|---|
| committer | Jonas Bernoulli <jonas@bernoul.li> | 2026-03-19 23:36:21 +0100 |
| commit | c81deca6778ec2f2577be6a824b27f35217a3ccd (patch) | |
| tree | 14ea1fe9568cc639c5866d7e01ecaa6bf1d1c429 /docs | |
| parent | aca61af96cfe4b0eaf582729db49151881456b7b (diff) | |
manual: Extend magit-diff-toggle-refine-hunk documentation
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/magit.org | 16 | ||||
| -rw-r--r-- | docs/magit.texi | 16 |
2 files changed, 30 insertions, 2 deletions
diff --git a/docs/magit.org b/docs/magit.org index 5b977b5..698190c 100644 --- a/docs/magit.org +++ b/docs/magit.org @@ -3235,7 +3235,21 @@ not support these arguments.) - Key: D t (magit-diff-toggle-refine-hunk) :: - This command toggles hunk refinement on or off. + This command toggles hunk refinement on or off, or switches the + refinement method. + + If hunk refinement is currently on, then turn off hunk refinement. + If hunk refinement is off, then turn on immediate hunk refinement. + + With a prefix argument, an alternative refinement method comes into + play. When using that method, mode hunks are not refined immediately, + instead each hunk is refined once it is selected, and then stays refined + until the next refresh of the buffer. If hunk refinement is currently + on, then toggle between refining all hunks up front or only once they + are selected. If hunk refinement is off, then turn on hunk refinement, + using the eventual refinement method. + + Customize option ~magit-diff-refine-hunk~ to change the default method. - Key: D r (magit-diff-switch-range-type) :: diff --git a/docs/magit.texi b/docs/magit.texi index 7ea3d12..78ae07a 100644 --- a/docs/magit.texi +++ b/docs/magit.texi @@ -3797,7 +3797,21 @@ affected because their local values have already been initialized. @item @kbd{D t} (@code{magit-diff-toggle-refine-hunk}) @kindex D t @findex magit-diff-toggle-refine-hunk -This command toggles hunk refinement on or off. +This command toggles hunk refinement on or off, or switches the +refinement method. + +If hunk refinement is currently on, then turn off hunk refinement. +If hunk refinement is off, then turn on immediate hunk refinement. + +With a prefix argument, an alternative refinement method comes into +play. When using that method, mode hunks are not refined immediately, +instead each hunk is refined once it is selected, and then stays refined +until the next refresh of the buffer. If hunk refinement is currently +on, then toggle between refining all hunks up front or only once they +are selected. If hunk refinement is off, then turn on hunk refinement, +using the eventual refinement method. + +Customize option @code{magit-diff-refine-hunk} to change the default method. @item @kbd{D r} (@code{magit-diff-switch-range-type}) @kindex D r |