Mercurial: Search History

The Mercurial History window enables you to search the history of changes of the relevant file(s) on branch and date. It also supports diff to a previous revision, backing out a revision from the repository, and view of a revision.

Toolbar

The history toolbar is at the top of the Mercurial History window.

The following table lists components for the commands that are available in the Mercurial History toolbar for the currently displayed project or file.

Element Description

Go to Previous Difference

Highlights the previous difference found between versions.

Go to Next Difference

Highlights the next difference found between versions.

Show All Change Paths (check-box)

Displays all files in a changeset.

Filter (drop-down list) contains

Displays only those revisions that match the criteria you specified for the selected filter (No Filter, Revision, Message, or User).

Summary View

The Summary view displays a list containing the details of the results matching the specified search criteria. Each row corresponds to a revision obtained from the repository.

If your search criteria specified a revision, all files contained therein are displayed beneath the revision heading.

You can call the following commands from the list directly on revisions:

Element Description

Diff Revision

Compares your currently selected file with the previous revision.

Backout Revision

Adds a new revision to the current branch that reverts your previous change.

Diff View

The Diff Viewer is divided into two panes:

Element Description

Upper pane

Contains a table that enables you to view a summary of a file's evolution by the date and time stamps. A stamp is applied whenever a file is saved in the IDE or committed to the Mercurial repository.

The table features the following columns and components:

Nodes

Displays the revision label for a file tracked in the Mercurial repository. The revisions can be sorted by clicking the Nodes column header.

Time

Displays the creation date and time of the revision in the history. The file revisions are listed according to the date, with the most current version displayed on top. They can be sorted by clicking the Time column header.

User

Displays the name of the person who created and authored the revision. The users can be sorted by clicking the User column header.

Message

Lists any message associated with the file. The messages can be sorted by clicking the Message column header.

You can call commands from the table directly on revisions using the right-click menu:

  • Backout. Adds a new revision to the current branch that reverts your previous change.
  • Revert to. Reverts your current file to the specified version.
  • Show only rows where. Filters revisions in accordance with the filter specified (Time/User/Message ==, Time/User/Message <>, Time/User/Message >, Time/User/Message <, Time/User/Message >=, Time/User/Message <=, No Filter). Available in the Time, User, and Message columns.

Multiple selection of any two revisions in the table displays them compared in the Diff Viewer in the lower pane.

Lower pane

Enables you to compare revisions of a file in the following two modes:

Graphical

Displays the differences between the files being compared side by side using color coding.

The Diff Viewer provides the following UI components:

  • Blue. Indicates lines that have been changed since the earlier revision.
  • Green. Indicates lines that have been added since the earlier revision.
  • Red. Indicates lines that have been removed since the earlier revision.

Textual

Displays the collection of differences between the compared files in text.

You can adjust the size of the Diff Viewer panes by dragging the divider between them.

Search Options

You can use the following criteria to search for files or folders:

Element Description

Branch

Enter the name of a branch to search for the revisions of files committed within this branch. Click the Select button to choose a branch from the list of available branches in the repository in the Select Branch in Repository dialog box.

Limit

Enter a positive integer to limit the number of revisions from the top of the repository to be displayed in the Mercurial History window.

Show merges

Select to display merge changes between repository revisions and your local working copy.

From

Enter a revision or date of a revision to search for the revisions of file(s) committed after that revision or date.

To

Enter a revision or date of a revision to search for the revisions of file(s) committed before that revision or date.

When you click the Search button, revisions meeting the specified criteria are displayed in Mercurial History window.


Related Topics

Developing Applications with NetBeans IDE,

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.