Expand description
*magit:file:<ref>:<path>* — a file’s content at a fixed
reference point, read-only.
<CR> on a file line inside any magit buffer tied to a specific
commit or index state (magit-revision, the staged region of
magit-commit/magit-diff) resolves to this buffer instead of the
live working-tree file — the diff/commit you were looking at
describes a SPECIFIC version of the file, and the working-tree
copy may already have diverged from it (mid-rebase, after a
later edit, or simply because the commit is historical). Visiting
the CURRENT file for editing stays <CR> in buffers that are
themselves about current state (magit-status, magit-diff’s
Unstaged scope) — see magit.md §6.3 for the full uniformity
rule across views.
<ref> is either a real commit-ish (sha/tag/branch) or the
literal token staged, meaning “the index’s blob for this path”
(git show :<path>) rather than a commit.
Structs§
Enums§
- Blob
Step - MG.23f: which way [
blob_step] walks the file’s history.