Upsource 2018.1 Help

Searching for revisions

The search field at the top of the revisions list on the project home page allows you to find a specific revision using various search criteria:

search_main.png

Search by

Description

Example

Commit ID

Type in id: then enter the ID number.

id: 39fa60b

Commit message

Type in one or more words you expect the commit message to contain. You can also specify discrete phrases in quotation marks.

TemplateSubstitutor implemented

Commit tag

Type in tag: then enter the tag the commits you're searching for should contain

tag: cosmetic

Branch

Type in branch: then enter the branch name or select it from the drop-down list.

branch: Idea14.0.2_EAP_139_560

In a multi-repository project, you can use wildcards to expand your search.

branch: {master*} will return commits made to all master branches from all repositories in a multi-repo project

Commit author

Type in author: then enter the username enclosed in curly brackets or select it from the drop-down list.

author: {Travis Wickett}

File name or path

Type in path: then enter the path and/or file name or select it from the drop-down list.

path: /CourseCreator.iml

Review ID or title

Type in review: then enter the review ID or title.

review: JB-CR-118

Reviewer

Type in reviewer: then enter the username enclosed in curly brackets or select it from the drop-down list.

reviewer: {Herbert Binkley}

Commit date

Type in date: then enter the date of commit.

date: 2014-Dec-01

You can also:

  • Search for commits adjacent to the specified commit ID

    Example: around: 39fa60b

  • Search for time spans

    Example: date: 2015-Jul-23..2015-Dec-05 will return all the commits made between the specified dates including the closing one.

  • Perform complex searches combining different criteria and binary operators (and, or, not)

    Example: author: {Travis Wickett} and (date: 2015-Oct-12..2015-Nov-01) will return all the commits made by the specified author during the specified period of time.

  • Use the following predefined shortcut keywords:

    Keyword

    Meaning

    #merge

    Find all merge commits

    #review

    Find all revisions included in reviews

    #{open review}

    Find all revisions included in open (pending or resolved) reviews

    #{closed review}

    Find all revisions included in closed review

Last modified: 2 November 2018