Quick URLs quick reference
Swarm handles URLs intelligently to reduce the amount of information you need to enter to quickly locate what you are looking for:
- Enter a URL in the following format:
-
Swarm checks the
<identifier>
and redirects you to the first match it finds. Swarm checks for the identifier in following order:
https://myswarm.url/<identifier>
- Changelist and review identifiers must be numeric.
- If you enter an identifier that does not exist for any type of resource, Swarm displays a Page Not Found error.
Example usage
Display the latest version of a review
For example, to display review 124: enter the URL https://myswarm.url/124
, Swarm redirects to https://myswarm.url/reviews/124
.
- To display a specific version of a review, enter the full URL including reviews and append /v<n>/to the URL. For example, to display version 2 of review 124: enter
https://myswarm.url/reviews/124/v2/
- To display a diff between two versions of a review, enter the full URL including reviews and append /v<n,n>/ the URL. For example, to display the diff between version 2 and 4 of review 124: enter
https://myswarm.url/reviews/124/v2,4/
- To open a review with a specific tab open, append #<tab name> to the end of the URL (#<tab name> must be the last item in the URL):
- Files tab: #files (default if #<tab name> is not specified)
- Comments tab: #comments
- Activity tab: #activity
Display a changelist
For example, to display changelist 123: enter the URL https://myswarm.url/123
, Swarm redirects to https://myswarm.url/changes/123
.
To open a changelist with a specific tab open, append #<tab name> to the end of the URL:
- Files tab: #files (default if #<tab name> is not specified)
- Comments tab: #comments
Display the latest version of a file
Enter the URL https://myswarm.url/depot/alpha/readme.txt
, Swarm redirects to https://myswarm.url/files/depot/alpha/readme.txt
.
- To display a specific version of a file, enter the full URL including files and append ?v=<n> to the URL. For example, to display version 2 of the depot/alpha/readme.txt file: enter
https://myswarm.url/files/depot/alpha/readme.txt?v=2
- To open a file with a specific tab open, append #<tab name> to the end of the URL (#<tab name> must be the last item in the URL):
- View tab: #view (default if #<tab name> is not specified)
- Commits tab: #commits
Display the user profile page for jsmith
Enter the URL https://myswarm.url/jsmith
, Swarm redirects to https://myswarm.url/users/jsmith
.