Upsource 2.5 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:

assets/browse/search_main_large.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: 14 September 2016