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:

  1. Enter a URL in the following format:
  2. https://myswarm.url/<identifier>

  3. Swarm checks the <identifier> and redirects you to the first match it finds. Swarm checks for the identifier in following order:

  • 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.