bookmark | bo | book | bookmarks
create a new bookmark or list existing bookmarks
Bookmarks are labels on changesets to help track lines of development. Bookmarks are unversioned and can be moved, renamed and deleted. Deleting or moving a bookmark has no effect on the associated changesets.
Creating or updating to a bookmark causes it to be marked as 'active'.
The active bookmark is indicated with a '*'.
When a commit is made, the active bookmark will advance to the new commit.
sl goto will also advance an active bookmark, if possible.
Updating away from a bookmark will cause it to be deactivated.
Bookmarks can be pushed and pulled between repositories (see
sl help push and
sl help pull). If a shared bookmark has
diverged, a new 'divergent bookmark' of the form 'name@path' will
be created. Using
sl merge will resolve the divergence.
Specifying bookmark as '.' to -m or -d options is equivalent to specifying the active bookmark's name.
- create an active bookmark for a new line of development:
sl book new-feature
- create an inactive bookmark as a place marker:
sl book -i reviewed
- create an inactive bookmark on another changeset:
sl book -r .^ tested
- rename bookmark turkey to dinner:
sl book -m turkey dinner
- move the '@' bookmark from another branch:
sl book -f @
In Git repos, bookmarks correspond to branches. Remote Git branches can be listed using the
- list remote branches:
sl bookmark --remote
- list remote tags:
sl bookmark --remote tags
- list all refs:
sl bookmark --remote 'refs/*'
- list branches from specified path:
sl bookmark --remote --remote-path my-fork
|revision for bookmark action
|delete a given bookmark
|like --delete, but also strip changesets
|rename a given bookmark
|mark a bookmark inactive
|track this bookmark or remote name
|remove tracking for this bookmark
|show both remote and local bookmarks
|fetch remote Git refs
|remote path from which to fetch bookmarks
|show only remote bookmarks that are available locally