About the source control history editor

Use the history editor to view commits in a branch and details about a commit.

Select a branch to view commits

  1. In the navigator area, click the Source Control navigator button () in the navigator bar.

  2. Disclose Branches (click the disclosure triangle next to Branches), then select a branch.

    The commits to the branch appear in the history editor on the right. The history editor shows the author, description, identifier, and date of each commit. The server profile pictures of authors also appear.

Search using filters

You can use search filters to search specific fields of a commit.

  1. In the search field, start entering your search text.

    A pop-up menu appears.

  2. Choose one of the suggestions (a search filter) from the pop-up menu, then enter Return.

    For example, to search the author field, choose Author: [text] and to search the description field, choose Message: [text]. The commits that match the search filter appear below.

  3. Refine the results in the following ways:

    • Change search filters: Click the arrow in a search filter and choose a different field from the pop-up menu.

    • Use multiple search filters: Place the pointer in the search field, start entering search text, then choose another suggestion from the pop-up menu. The search filter is appended to the search field.

Filter by date range

Open the commit files in the comparison editor

Choose working copies, branches, or tags from the jump bar

View branches, commits, and comparison editor in one window

You can configure your project window to view branches, the history, commit details, and the comparison editor together.

  1. In the navigator area, click the Source Control navigator button (), then select a branch.

  2. In the history editor (on the right), select a commit.

  3. In the toolbar, click the Inspectors button (), then select the Source Control inspector ().

    The inspector shows the details of the selected commit.

  4. In the toolbar, from the Assistant editor () pop-up menu, choose Assistant Editors on Bottom.

    The assistant editor displays the selected commit in the comparison editor.

  5. In the history editor, select another commit.

    The assistant editor and the inspector show the details of the selected commit.

View commit files in the inspector

You can view the files in a commit in the Source Control inspector.

  1. In the history editor, select a commit.

  2. In the inspector area (), select the Source Control inspector ().

    Details about the commit appear in the inspector. The files in the commit appear under Files.

Optionally, hover the pointer over a file and click the arrow to open it in the comparison editor.

Email an author of a commit

Alternatively, select a commit and in the Source Control inspector (), choose an email address from the Author pop-up menu.

Change a working copy author (Git)

  1. In the Source Control navigator, select a working copy.

  2. In the inspector area (), select the Source Control inspector ().

  3. Under Working Copy, enter the author’s name and email address in the text fields.

See alsoCompare revisions of a file