From c79920095b697ce3766b8b1546e7f1827d0c9da0 Mon Sep 17 00:00:00 2001 From: Ilya Grigoriev Date: Tue, 31 Oct 2023 19:41:03 -0700 Subject: [PATCH] glossary.md: Clarify description of "visible commits" --- docs/glossary.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/glossary.md b/docs/glossary.md index 13af2a23f..c4c6c83a1 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -175,6 +175,12 @@ Visible commits are the commits you see in `jj log -r 'all()'`. They are the commits that are reachable from an anonymous head in the [view](#view). Ancestors of a visible commit are implicitly visible. +Intuitively, visible commits are the "latest versions" of a revision with a +given [change id](#change-id). A commit that's abandoned or +[rewritten](#rewrite) stops being visible and is labeled as "hidden". Such +commits are no longer accessible using a change id, but they are still +accessible by their [commit id](#commit-id). + ## View A view is a snapshot of branches and their targets, anonymous heads,