docs: update description of @ revset expression, mention name@remote syntax

Since I'm going to remove the root symbol, it doesn't make sense to leave
@ in the priority list.
This commit is contained in:
Yuya Nishihara 2023-09-03 13:41:15 +09:00
parent 4394bf8de8
commit c08fab60da

View file

@ -21,8 +21,9 @@ ID or a Git ref pointing to them).
The symbol `root` refers to the virtual commit that is the oldest ancestor of The symbol `root` refers to the virtual commit that is the oldest ancestor of
all other commits. all other commits.
The symbol `@` refers to the working copy commit in the current workspace. Use The `@` expression refers to the working copy commit in the current workspace.
`<workspace name>@` to refer to the working-copy commit in another workspace. Use `<workspace name>@` to refer to the working-copy commit in another
workspace. Use `<name>@<remote>` to refer to a remote-tracking branch.
A full commit ID refers to a single commit. A unique prefix of the full commit A full commit ID refers to a single commit. A unique prefix of the full commit
ID can also be used. It is an error to use a non-unique prefix. ID can also be used. It is an error to use a non-unique prefix.
@ -40,12 +41,11 @@ Taking shell quoting into account, you may need to use something like
Jujutsu attempts to resolve a symbol in the following order: Jujutsu attempts to resolve a symbol in the following order:
1. `@` 1. `root`
2. `root` 2. Tag name
3. Tag name 3. Branch name
4. Branch name 4. Git ref
5. Git ref 5. Commit ID or change ID
6. Commit ID or change ID
## Operators ## Operators