Display the annotation view (git blame) of the current file.
Display the diff of a particular commit by selecting the annotation of a line.
From the commit diff view, you can:
Open the annotation view of the file just before the commit, and trace back the history.
Open the diff of another file in the same commit.
The vertical colour bar is coloured darker for older commits and lighter for more recent commits (or the other way around, depending on the colours you specified).
Highlight the annotations with same commit hash when hovering over them.
Blame the current file and open the diff of a particular commit
From the commit diff, annotate the contents of the left side of the diff view
From the commit diff, open the diff of another file in the same commit
A couple of requests from me when you raise an github issue.
Requesting a feature: Please try to provide the context of why you want the feature. Such as, in what situation the feature could help you and how, or how the lack of the feature is causing an inconvenience to you. I can't think of introducing it until I understand how it helps you 🙂
Reporting a bug: Please include environment information (OS name/version, the editor version). Also consider providing screenshots (or even videos) where appropriate. They are often very very helpful!
Commands
Annotator: Annotate the Current File or the File Before the Commit (if on Commit Diff)
Command ID:annotator.annotate
Annotator: Show Diff of Another File Changed in the Same Commit
Command ID:annotator.switchDiffWithinCommit
Configurations
annotator.annotationColumnWidth: Width of the annotation column
annotator.annotationCommitColorRange: Range of colours to be used for colouring each commit. Specify intermediate colours by giving more than 2 colours
annotator.annotationCommitColorBarWidth: Width of the commit colour bar
annotator.annotationFontColor: Font colour of the annotation text
annotator.annotationHighlightColor: Highlight colour when hovering over the annotation text
annotator.annotationTooltipWidth: Width of the annotation tooltip
annotator.annotationTooltipBackgroundColor: Background colour of the annotation tooltip
annotator.git.ignoreWhitespaceOnBlame: Ignore whitespace when git blame by specifying -w option.
Prerequisite
git command must be available. You need to either make git available in your PATH or set git.path in your settings.
