Next: Collections, Previous: Projects and the Project File, Up: Concepts [Contents]
2.2 Repository Designators ¶
A project or a dependency is designated by one of:
- the git url itself:
‘https://gitlab.com/com-informatimago/com-informatimago.git’ or
‘git@github.com:informatimago/lisp.git’;
- a collection-qualified designator: the name of a collection and
the path of the repository in it — ‘gitlab:owner/repo’ in the
shell and AutoLISP syntax, ‘(gitlab "owner/repo")’ in Common Lisp;
- a simplified designator: the path alone — ‘owner/repo’; the
collections are searched, and when several match, you are asked to
choose. Simplified designators are accepted interactively, but
not in project files.
A version may be attached to the designator; without one, the
repository’s default branch is tracked:
| shell / AutoLISP | Common Lisp | meaning |
| ‘…@refactor’ | ‘:branch "refactor"’ | a branch |
| ‘…@v2.0.1’ | ‘:tag "v2.0.1"’ | a tag |
| ‘…@4d16a40…’ | ‘:commit "4d16a40…"’ | a commit hash |
| ‘…@latest’ | ‘:tag :latest’ or ‘:release :latest’ | latest tag or release |