diff --git a/demos/demo_git_compat.sh b/demos/demo_git_compat.sh
index e2b328960..c4ac517b1 100755
--- a/demos/demo_git_compat.sh
+++ b/demos/demo_git_compat.sh
@@ -10,12 +10,12 @@ run_command "cd Hello-World"
blank
-comment "By default, \"jj\" creates a local master branch tracking the remote master
-branch. The other branches are only available as remote-tracking branches."
-run_command "jj branch list --all"
-comment "We can create a local branch tracking one of the remote branches we just
+comment "By default, \"jj\" creates a local bookmark \"master\" tracking the remote master
+branch. Other remote branches are only available as remote-tracking bookmarks."
+run_command "jj bookmark list --all"
+comment "We can create a local bookmark tracking one of the remote branches we just
fetched."
-run_command "jj branch track octocat-patch-1@origin"
+run_command "jj bookmark track octocat-patch-1@origin"
comment "By default, \"jj log\" excludes untracked remote branches to focus on
\"our\" commits."
diff --git a/demos/demo_juggle_conflicts.sh b/demos/demo_juggle_conflicts.sh
index 442607b49..290702f41 100755
--- a/demos/demo_juggle_conflicts.sh
+++ b/demos/demo_juggle_conflicts.sh
@@ -6,13 +6,13 @@ new_tmp_dir
(
jj init --config-toml ui.allow-init-native=true
echo "first" > file
- jj branch create first
+ jj bookmark create first
jj commit -m 'first'
echo "second" > file
- jj branch create second
+ jj bookmark create second
jj commit -m 'second'
echo "third" > file
- jj branch create third
+ jj bookmark create third
jj commit -m 'third'
) >/dev/null 2>&1
diff --git a/demos/demo_operation_log.sh b/demos/demo_operation_log.sh
index 8c1525819..b94cb038c 100755
--- a/demos/demo_operation_log.sh
+++ b/demos/demo_operation_log.sh
@@ -7,8 +7,8 @@ new_tmp_dir
jj git clone https://github.com/octocat/Hello-World
cd Hello-World
jj abandon --ignore-immutable octocat-patch-1@origin
- jj branch forget octocat-patch-1
- jj branch track test@origin
+ jj bookmark forget octocat-patch-1
+ jj bookmark track test@origin
} > /dev/null 2>&1
comment "We are in the octocat/Hello-World repo.
@@ -18,7 +18,7 @@ run_command "jj op log"
comment "We are going to make some changes to show
how the operation log works. Let's add a file, set
-a description, and rebase onto the \"test\" branch:"
+a description, and rebase onto the \"test\" bookmark:"
run_command "echo stuff > new-file"
run_command "jj describe -m stuff"
run_command "jj rebase -d test"
diff --git a/demos/demo_resolve_conflicts.sh b/demos/demo_resolve_conflicts.sh
index 2eea43dd7..36897c647 100755
--- a/demos/demo_resolve_conflicts.sh
+++ b/demos/demo_resolve_conflicts.sh
@@ -7,11 +7,11 @@ new_tmp_dir
jj git clone https://github.com/octocat/Hello-World
cd Hello-World
jj abandon --ignore-immutable test@origin
- jj branch forget test
+ jj bookmark forget test
} > /dev/null 2>&1
-comment "We are on the master branch of the
-octocat/Hello-World repo:"
+comment "We are on the master branch of the octocat/Hello-World repo,
+represented by the \"master\" bookmark on the parent commit."
run_command "jj log"
comment "Let's make an edit that will conflict
diff --git a/demos/demo_working_copy.sh b/demos/demo_working_copy.sh
index a8b3195b4..911bceb14 100755
--- a/demos/demo_working_copy.sh
+++ b/demos/demo_working_copy.sh
@@ -7,9 +7,9 @@ new_tmp_dir
jj git clone https://github.com/octocat/Hello-World
cd Hello-World
jj abandon --ignore-immutable test@origin
- jj branch forget test
+ jj bookmark forget test
jj abandon --ignore-immutable octocat-patch-1@origin
- jj branch forget octocat-patch-1
+ jj bookmark forget octocat-patch-1
}> /dev/null 2>&1
comment "We are in the octocat/Hello-World repo.
@@ -25,9 +25,9 @@ comment "Because of these changes, our working copy is no longer marked as \"(em
Also, its commit ID (starting with a blue character) changed:"
run_command "jj status"
-comment "Add a branch so we can easily refer to this
+comment "Add a bookmark so we can easily refer to this
commit:"
-run_command "jj branch create goodbye"
+run_command "jj bookmark create goodbye"
run_command "jj log"
comment "Start working on a new change off of master:"
diff --git a/demos/git_compat.png b/demos/git_compat.png
index 5be876615..76ba4ffed 100644
Binary files a/demos/git_compat.png and b/demos/git_compat.png differ
diff --git a/demos/git_compat.svg b/demos/git_compat.svg
index 2767a86d4..5ed9feb6a 100644
--- a/demos/git_compat.svg
+++ b/demos/git_compat.svg
@@ -40,39 +40,39 @@
$ jj git clone https://github.com/octocat/Hello-World
Fetching into new repo in "/private/var/folders/lj/rv4h95_d0mxb9ryztzpz4qph0000g↓
-n/T/tmp.ExrIt6VdYc/Hello-World"
-branch: master@origin [new] untracked
-branch: octocat-patch-1@origin [new] untracked
-branch: test@origin [new] untracked
+n/T/tmp.v3wfSIm7te/Hello-World"
+bookmark: master@origin [new] untracked
+bookmark: octocat-patch-1@origin [new] untracked
+bookmark: test@origin [new] untracked
Setting the revset alias "trunk()" to "master@origin"
-Working copy now at: qyyypuyn557a65b9(empty)(no description set)
+Working copy now at: qotuunkpd67be097(empty)(no description set)Parent commit : orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 fr↓om Spaceghost/patch-1
Added 1 files, modified 0 files, removed 0 files
$ cd Hello-World
-# By default, "jj" creates a local master branch tracking the remote master
-# branch. The other branches are only available as remote-tracking branches.
+# By default, "jj" creates a local bookmark "master" tracking the remote master
+# branch. Other remote branches are only available as remote-tracking bookmarks.
-$ jj branch list --all
+$ jj bookmark list --all
master: orrkosyo7fd1a60b(empty) Merge pull request #6 from Spaceghost/patch-1
@origin: orrkosyo7fd1a60b(empty) Merge pull request #6 from Spaceghost/patch↓-1
octocat-patch-1@origin: tpstlustb1b3f972 sentence case
test@origin: kowxouwzb3cbd5bb Create CONTRIBUTING.md
-# We can create a local branch tracking one of the remote branches we just
+# We can create a local bookmark tracking one of the remote branches we just# fetched.
-$ jj branch track octocat-patch-1@origin
-Started tracking 1 remote branches.
+$ jj bookmark track octocat-patch-1@origin
+Started tracking 1 remote bookmarks.
# By default, "jj log" excludes untracked remote branches to focus on# "our" commits.$ jj log
-@qyyypuynjjfan@example.com2024-09-04 19:29:24557a65b9
+@qotuunkpjjfan@example.com2024-10-13 19:54:52d67be097│ (empty)(no description set)│ ○ tpstlustsupport+octocat@github.com2018-05-10 10:55:19octocat-patch-1├─╯ b1b3f972
@@ -84,7 +84,7 @@
# We can also ask "jj" to show all the commits.$ jj log -r 'all()'
-@qyyypuynjjfan@example.com2024-09-04 19:29:24557a65b9
+@qotuunkpjjfan@example.com2024-10-13 19:54:52d67be097│ (empty)(no description set)│ ○ tpstlustsupport+octocat@github.com2018-05-10 10:55:19octocat-patch-1├─╯ b1b3f972
@@ -95,9 +95,9 @@
├─╮ (empty) Merge pull request #6 from Spaceghost/patch-1
│ ◆nznozkvvJohnneylee.rollins@gmail.com2011-09-13 21:42:4176294131├─╯ New line at end of file. --Signed off by Spaceghost
-◆syktoqtscameron@github.com2011-01-26 12:06:08553c2077
+◆syktoqtscameron@github.com2011-01-26 12:06:08553c2077│ first commit
-◆zzzzzzzzroot()00000000
+◆zzzzzzzzroot()00000000# We can look at the diffs of commits in the repo
@@ -112,8 +112,8 @@
# The repo is backed by the actual Git repo:$ git --git-dir=.jj/repo/store/git log --graph --all --decorate --oneline
-* 557a65b
-| * 1ccbcd7
+* 8aaad6b
+* d67be09| * b1b3f97 (origin/octocat-patch-1) sentence case
|/| * b3cbd5b (origin/test) Create CONTRIBUTING.md
diff --git a/demos/juggle_conflicts.png b/demos/juggle_conflicts.png
index c48e6751f..27e8c4cf0 100644
Binary files a/demos/juggle_conflicts.png and b/demos/juggle_conflicts.png differ
diff --git a/demos/juggle_conflicts.svg b/demos/juggle_conflicts.svg
index 2ae445f6a..f2f807ab1 100644
--- a/demos/juggle_conflicts.svg
+++ b/demos/juggle_conflicts.svg
@@ -40,15 +40,15 @@
# editing the same line:$ jj log
-@mnrltoyzjjfan@example.com2024-09-04 19:32:070a13891c
+@xtlupomqjjfan@example.com2024-10-13 19:54:53fd822031│ (empty)(no description set)
-○ mnksvwsqjjfan@example.com2024-09-04 19:32:07thirdc69ca402
+○ vlrryzpmjjfan@example.com2024-10-13 19:54:53thirde5609328│ third
-○ pxssrovnjjfan@example.com2024-09-04 19:32:07secondd4f1281c
+○ vozropowjjfan@example.com2024-10-13 19:54:53second838a97d1│ second
-○ zwlynwuojjfan@example.com2024-09-04 19:32:07first23b66a7d
+○ yzkyuwyxjjfan@example.com2024-10-13 19:54:53firstd11b168f│ first
-◆zzzzzzzzroot()00000000
+◆zzzzzzzzroot()00000000$ jj diff -r first
Added regular file file: 1: first
@@ -66,15 +66,15 @@
$ jj rebase -s second -d third
Rebased 1 commits
$ jj log
-○ pxssrovnjjfan@example.com2024-09-04 19:32:07secondf3d448cf
+○ vozropowjjfan@example.com2024-10-13 19:54:54secondbab527f4│ second
-│ @mnrltoyzjjfan@example.com2024-09-04 19:32:07ff8340a7conflict
+│ @xtlupomqjjfan@example.com2024-10-13 19:54:54cccec5aaconflict├─╯ (empty)(no description set)
-×mnksvwsqjjfan@example.com2024-09-04 19:32:07third1395ab1cconflict
+×vlrryzpmjjfan@example.com2024-10-13 19:54:54third252149abconflict│ third
-○ zwlynwuojjfan@example.com2024-09-04 19:32:07first23b66a7d
+○ yzkyuwyxjjfan@example.com2024-10-13 19:54:53firstd11b168f│ first
-◆zzzzzzzzroot()00000000
+◆zzzzzzzzroot()00000000# The commit labeled "third" has a conflict, as expected. What's more# interesting is that the top commit has no conflict! That's because it
@@ -83,8 +83,8 @@
# Let's verify that by looking at its contents:$ jj new second
-Working copy now at: tllxozupacb9a438(empty)(no description set)
-Parent commit : pxssrovnf3d448cfsecond | second
+Working copy now at: lwwotoor7d2b3194(empty)(no description set)
+Parent commit : vozropowbab527f4second | second
Added 0 files, modified 1 files, removed 0 files
$ cat file
third
@@ -94,24 +94,24 @@
$ jj rebase -s second -d first
Rebased 2 commits
-Working copy now at: tllxozupd999f947(empty)(no description set)
-Parent commit : pxssrovna8719aaasecond | second
+Working copy now at: lwwotoorf6445745(empty)(no description set)
+Parent commit : vozropow5ccf5c89second | second
Added 0 files, modified 1 files, removed 0 files
$ jj new second third -m merged
-Working copy now at: xkynxupue5bb9694(empty) merged
-Parent commit : pxssrovna8719aaasecond | second
-Parent commit : mnksvwsq1395ab1cthird | (conflict) third
+Working copy now at: ktkzxtmq2dd72c52(empty) merged
+Parent commit : vozropow5ccf5c89second | second
+Parent commit : vlrryzpm252149abthird | (conflict) third
Added 0 files, modified 1 files, removed 0 files
$ jj log
-@xkynxupujjfan@example.com2024-09-04 19:32:07e5bb9694
+@ktkzxtmqjjfan@example.com2024-10-13 19:54:542dd72c52├─╮ (empty) merged
-│ ×mnksvwsqjjfan@example.com2024-09-04 19:32:07third1395ab1cconflict
+│ ×vlrryzpmjjfan@example.com2024-10-13 19:54:54third252149abconflict│ │ third
-○ │ pxssrovnjjfan@example.com2024-09-04 19:32:07seconda8719aaa
+○ │ vozropowjjfan@example.com2024-10-13 19:54:54second5ccf5c89├─╯ second
-○ zwlynwuojjfan@example.com2024-09-04 19:32:07first23b66a7d
+○ yzkyuwyxjjfan@example.com2024-10-13 19:54:53firstd11b168f│ first
-◆zzzzzzzzroot()00000000
+◆zzzzzzzzroot()00000000# Again, because the merge commit has the# changes from all three commits, it has no
diff --git a/demos/operation_log.png b/demos/operation_log.png
index c1bc68928..006f42bcc 100644
Binary files a/demos/operation_log.png and b/demos/operation_log.png differ
diff --git a/demos/operation_log.svg b/demos/operation_log.svg
index 701fa083d..f482b59f9 100644
--- a/demos/operation_log.svg
+++ b/demos/operation_log.svg
@@ -1,5 +1,5 @@
-# We have an empty working copy on top of master:$ jj log
-@ozsmopnzjjfan@example.com2024-09-05 17:44:52fb3dbcd1
+@sqmuzyqkjjfan@example.com2024-10-13 19:54:592c379c44│ (empty)(no description set)
-◆orrkosyooctocat@nowhere.com2012-03-06 16:06:50master7fd1a60b
+◆orrkosyooctocat@nowhere.com2012-03-06 16:06:50master7fd1a60b│ (empty) Merge pull request #6 from Spaceghost/patch-1
~
$ jj status
The working copy is clean
-Working copy : ozsmopnzfb3dbcd1(empty)(no description set)
-Parent commit: orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 from Spa↓
+Working copy : sqmuzyqk2c379c44(empty)(no description set)
+Parent commit: orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 from Spa↓ceghost/patch-1
# Now make some changes in the working copy:
@@ -63,27 +63,27 @@
Working copy changes:
M READMEA new-file
-Working copy : ozsmopnze667643c(no description set)
-Parent commit: orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 from Spa↓
+Working copy : sqmuzyqk8a6d28e6(no description set)
+Parent commit: orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 from Spa↓ceghost/patch-1
-# Add a branch so we can easily refer to this
+# Add a bookmark so we can easily refer to this# commit:
-$ jj branch create goodbye
-Created 1 branches pointing to ozsmopnze667643cgoodbye | (no description set)
+$ jj bookmark create goodbye
+Created 1 bookmarks pointing to sqmuzyqk8a6d28e6goodbye | (no description set)$ jj log
-@ozsmopnzjjfan@example.com2024-09-05 17:44:52goodbyee667643c
+@sqmuzyqkjjfan@example.com2024-10-13 19:54:59goodbye8a6d28e6│ (no description set)
-◆orrkosyooctocat@nowhere.com2012-03-06 16:06:50master7fd1a60b
+◆orrkosyooctocat@nowhere.com2012-03-06 16:06:50master7fd1a60b│ (empty) Merge pull request #6 from Spaceghost/patch-1
~
# Start working on a new change off of master:$ jj new master
-Working copy now at: qulnmsrocece88b0(empty)(no description set)
-Parent commit : orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 fr↓
+Working copy now at: lnmmqryq4a26dc6e(empty)(no description set)
+Parent commit : orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 fr↓om Spaceghost/patch-1
Added 0 files, modified 1 files, removed 1 files
@@ -91,11 +91,11 @@
# "goodbye" change stayed in its own commit:$ jj log
-@qulnmsrojjfan@example.com2024-09-05 17:44:51cece88b0
+@lnmmqryqjjfan@example.com2024-10-13 19:54:584a26dc6e│ (empty)(no description set)
-│ ○ ozsmopnzjjfan@example.com2024-09-05 17:44:52goodbyee667643c
+│ ○ sqmuzyqkjjfan@example.com2024-10-13 19:54:59goodbye8a6d28e6├─╯ (no description set)
-◆orrkosyooctocat@nowhere.com2012-03-06 16:06:50master7fd1a60b
+◆orrkosyooctocat@nowhere.com2012-03-06 16:06:50master7fd1a60b│ (empty) Merge pull request #6 from Spaceghost/patch-1
~
@@ -104,8 +104,8 @@
$ jj status
The working copy is clean
-Working copy : qulnmsrocece88b0(empty)(no description set)
-Parent commit: orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 from Spa↓
+Working copy : lnmmqryq4a26dc6e(empty)(no description set)
+Parent commit: orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 from Spa↓ceghost/patch-1
# Modify a file in this new change:
@@ -114,8 +114,8 @@
$ jj status
Working copy changes:
M README
-Working copy : qulnmsro51e8e98e(no description set)
-Parent commit: orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 from Spa↓
+Working copy : lnmmqryqdedb65bd(no description set)
+Parent commit: orrkosyo7fd1a60bmaster | (empty) Merge pull request #6 from Spa↓ceghost/patch-1
# The working copy is not special; we can, for
@@ -132,11 +132,11 @@
# Inspect the result:$ jj log
-○ ozsmopnzjjfan@example.com2024-09-05 17:44:52goodbyeeb4cc65d
+○ sqmuzyqkjjfan@example.com2024-10-13 19:54:59goodbyee3842b58│ goodbye
-│ @qulnmsrojjfan@example.com2024-09-05 17:44:52aa8ad947
+│ @lnmmqryqjjfan@example.com2024-10-13 19:54:59d7fadb8a├─╯ everyone
-◆orrkosyooctocat@nowhere.com2012-03-06 16:06:50master7fd1a60b
+◆orrkosyooctocat@nowhere.com2012-03-06 16:06:50master7fd1a60b│ (empty) Merge pull request #6 from Spaceghost/patch-1
~