Local History View
See Also
The Local History View allows to quickly access the local history of changes of the relevant file. You can generally open the Local History View by
choosing Team > Local history > Show Local history from the main menu. If a file is open in the Source Editor, you can click the History button in the editor's toolbar to open the History View.
This topic introduces the following Local History View features:
- Tabs
- Toolbar
- Diff Viewer
The top of the History View tab shows the name of the document.
If multiple files are open, you can split the History View by clicking and dragging the tab. As you drag to different parts of the editing area, you see a red outline that shows you where the new window will open. When one of these boxes appears, you can drop the document and split the pane.
- You must close the split file if you want the view to return to its unsplit
state.
You can right-click a tab to access the following commands:
- Close. Closes the selected file.
- Close All. Closes all files that are open in the History
View area.
- Close Other. Closes all files except for the selected file.
- Maximize/Restore. Hides other windows and
expands the History View to use all of the window space in the IDE. To
return the windows to the state that they were before you chose Maximize, deselect the checked Maximize option.
You can also maximize and restore the History View by double-clicking a tab.
- Float/Dock. Opens document in a History View in a new window. If window is already floating, the Dock option appears instead.
- Clone Document. Opens a new tab for the same document. This command is
particularly useful in combination with splitting the window so that you can view
different parts of the same file simultaneously.
- New Document Tab Group/Collapse Document Tab Group. Splits the History View vertically into parts containing open documents in new windows.
- Editors. Allows for switching between the Source and History editors.
The history toolbar is at the top of the History View window. It shows the Local History title and a shortcut Show Versioning History link (applicable to files versioned via Subversion and Mercurial). It can be invoked using the Show editor toolbar item in the View menu.
The Diff Viewer is divided into two panes:
- 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.
The table features the following two columns:
- Version. The versions are listed according to date, with the most current version displayed on top. They can be sorted by clicking the Version column header.
- Label. Lists any label associated with the file. The labels can be sorted by clicking the Labels column header.
- To add a label to a specific file version, click on the version row beneath the Label column and type in a label directly.
- You can call commands from the table directly on versions using the right-click menu:
- Revert from History. Reverts your current file to the selected version.
- Delete from History. Deletes the selected version from the Local History repository.
- Show only rows where. Filters versions in accordance with the filter specified (Label ==, Label <>, Label >, Label <, Label >=, Label <=, No Filter). Applicable to labels only.
- Lower pane. Enables you to compare revisions of a file side by side using color coding to emphasize the differences between the files being compared.
You can navigate among individual differences between file versions using the
following buttons in the toolbar on the lower pane:
Previous ( ) |
Highlights the previous difference found between versions. |
Next ( ) |
Highlights the next difference found between versions. |
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. |
The following icons allow you to make changes directly to the file:
Replace
( ) |
Inserts the highlighted text from the previous revision into the current revision. |
Move All
( ) |
Reverts the file's current version to the state of the selected previous version. |
Remove
( ) |
Removes the highlighted text from the current version so that it mirrors the previous version. |
You can adjust the size of the Diff Viewer panes by dragging the divider between them.
- Click the pointing up black arrow on the left of the divider once to expand the lower pane, click the same arrow again to collapse the upper pane.
- Click the pointing down black arrow on the left of the divider once to expand the upper pane, click the same arrow again to collapse the lower pane.
- See Also
- About Local File History
- About the Java Source Editor
- About the PHP Source Editor
- About the HTML Source Editor
- Editing an XML Document
Legal Notices