Upsource 2020.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 byDescriptionExample
Commit IDType in id: then enter the ID number. id: 39fa60b
Commit messageType in one or more words you expect the commit message to contain. You can also specify discrete phrases in quotation marks. TemplateSubstitutor implemented
Commit tagType in tag: then enter the tag the commits you're searching for should contain tag: cosmetic
BranchType 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 authorType in author: then enter the username enclosed in curly brackets or select it from the drop-down list. author: {Travis Wickett}
File name or pathType in path: then enter the path and/or file name or select it from the drop-down list. path: /CourseCreator.iml
Review ID or titleType in review: then enter the review ID or title. review: JB-CR-118
ReviewerType in reviewer: then enter the username enclosed in curly brackets or select it from the drop-down list. reviewer: {Herbert Binkley}
Commit dateType 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: 29 June 2020