Skip to content

manual: add a section about navigating blame/diff views #1373

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

manual: add a section about navigating blame/diff views #1373

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions doc/manual.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -248,6 +248,30 @@ be appended:
[main] 77d9e40fbcea3238015aea403e06f61542df9a31 - commit 1 of 779 loading 5s 0%
-------------------------------------------------------------------------------

[[blame]]
Blame and diff navigation
~~~~~~~~~~~~~~~~~~~~~~~~~

Tig allows quick navigation between blame views and related diff views.

In the diff view, navigating to an added line in a diff and pressing
'b' will open the blame view of the commit that was shown and select
the corresponding line in that view. Navigating to a removed line in the
diff and pressing 'b' takes you to the blame view of the parent commit.

The blame view can also be opened directly with the 'tig blame' command.

In the blame view, the blame commit for the current line is considered
Copy link

@eMPee584 eMPee584 Jun 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is somewhat hard to understand (huh, blame commit for the current line?), could you maybe try to reword it?
Also, when I move from line to line (in blame view), nothing changes in the status bar for me (also tested with TIGRC_SYSTEM= to skip local config..), maybe you can provide a screenshot of what you mean by that?
Otherwise, this looks good, and thanks for teaching us more TUI hacks ; )

"selected", and is shown in the status bar. In this view, the 'b'
command will jump to the corresponding line in the blame view for that
commit. The ',' AKA ':parent' command will jump to the corresponding line
in the parent of the blame commit (or the nearest line Tig can find,
if there is no corresponding line). The '<' AKA ':back' command can be
used to undo jumps within the blame view.

Pressing 'Enter' in the blame view will take you to the corresponding
line in the diff of the blamed commit.

[[env-variables]]
Environment Variables
---------------------
Expand Down