Using the History Window
The History window provides detailed historical data about a team project, branch, folder, or file. For information about how to display the window
in Visual Studio Application Lifecycle Management (ALM), see View Historical Data.
as a standalone window from the command line, see History Command.
Tip
When you open the History window from within Visual Studio ALM, you can customize the position of the window by right-clicking the title and then clicking one of these options: Float, Dock, or Dock as Tabbed Document.
The History window displays the historical data about the item in two tabs:
The Changesets tab lists every change (including edits, renames, and merges) made to the item.
The Labels tab lists every label that has been applied to the item.
Changesets Tab
The Changesets tab displays detailed data about every change that has been made to an item. All changesets that have modified the item are listed in a table that includes the following columns:
Changeset The ID of the changeset.
User The name of the user who checked in the changeset.
Date The date and time the changeset was checked in.
Comment The comment entered by the user who checked in the changeset.
Note If you open this window by using the History command and you are displaying data about a team project, branch, or folder, then the history of children items (for example, the files contained by a folder) is shown only if you use the /recursive option.
If the item is a file, then additional data is displayed in the following columns:
Change The types of changes that were made to the file with the changeset. Examples of values that can appear in this column include add, edit, rename, and merge.
Path The path to the file.
Tip
Sometimes you need to share this kind of data with someone else. You can select one or more rows from the table in the Labels tab, right-click them, click Copy to copy the data to the clipboard, and then paste the data into an e-mail message, document, or spreadsheet.
Common Tasks
By using the Changesets tab, you can perform the following tasks:
Task |
Supporting content |
|---|---|
View the item as it existed when the changeset was checked in: Double click the changeset or right-click it, and then click View. (This command is available only if the item is a file.) |
None |
Get more details about a changeset: Right-click a changeset and then click Changeset Details to get information such as:
|
|
Compare a past version with the current version: Right-click a changeset and then click Compare. Compare a past version with another past version:
|
|
Get a past version of the item: Right-click a changeset and then click Get This Version to download the past version of the item to your workspace. |
|
View which users made specific changes within a file: Right-click a changeset and then click Annotate. (This command is available only if the item is a file.) |
|
Get more details about a merge: If the changeset resulted from a merge change, you can expand this item. Expand the node to display the changesets that were merged into this item from another branch. (This command is available only if the item is a file.) |
None |
Get more details about changes that were made before a rename change: If the changeset includes a rename change, you can expand this item. Expand the node to display the changesets that occurred before the rename change was made. |
None |
View other branches to which this changeset has been merged: Right-click the changeset and click Track Changeset. |
Labels tab
All labels that have been applied to the item are listed in a table that includes the following columns:
Name The name of the label.
User The user who applied the label.
Date The date and time the label was applied.
Comment The comment made by the user who applied the label.
Note
When you display historical data about a team project, branch, or folder, the data about labels applied to children items (for example, the files contained by a folder) is not shown.
Tip
Sometimes you need to share this kind of data with someone else. You can select one or more rows from the table in the Labels tab, right-click them, click Copy to copy the data to the clipboard, and then paste the data into an e-mail message, document, or spreadsheet.
Common Tasks
Task |
Supporting content |
|---|---|
View the item as it existed when the labeled changeset was checked in: Right-click a label and then click View. (This command is available only if the item is a file.) |
None |
Edit the label: Right-click the label and click Edit Label. |
|
Delete the label: Right-click the label and click Delete Label. |
|
Compare a past version of the item with the current version: Right-click a label and then click Compare to compare a past version of the item with the current version. |
|
Get a past version of the item: Right-click a label and then click Get This Version to download the past version of the item to your workspace. |
|
View other branches to which the labeled changeset has merged: Right-click the label and click Track Changeset. (This command is available only if the item is a file.) |
|
View which users made specific changes within the labeled version of a file: Right-click a changeset and then click Annotate. (This command is available only if the item is a file.) |