History view

Click the History tab to see the history view for the active file in the content pane:

The history view displays the Contents page in all editions. The Diff page is available in JBuilder Professional and Enterprise editions. The Info view is only available in JBuilder Enterprise edition.

All three pages display revision lists. The revision lists show the version number of the file, the type and date of revision, and other information. You can sort the revision lists by clicking on the column head of the characteristic you want to sort by.

This table illustrates the version types indicated by the icons in the revision table:

The version of the file that you checked out from the repository in this session.
A file version from a version control system.
A backup version of the file.
The version of the file that includes all changes made and saved since the file was last committed.
The version of the file that's in the buffer. The buffer version includes unsaved changes in your workspace.

Tip: When your cursor is in the revision list, you can scroll through the list by pressing Enter or by using your keyboard arrow keys.

Most of the pages have a source viewer. The source viewer displays the source code of the file version selected in the revision list. You can copy and paste from the source viewer into the editor, though you cannot edit the source viewer directly. This simplifies retrieving old work while it protects the integrity of the prior file versions.

Most of the pages provide access to the Refresh Revision Info and Revert To Previous Revision buttons at the top of the page.

Refresh Revision Info

The Refresh Revision Info button updates your view of the revision list to include any changes made by other users to the file in the repository.

Revert To Previous Revision

The Revert To Previous Revision button makes the version you have selected the most current version again. If you are using version control or your backup level is high enough, all other versions are retained. The old version simply becomes the most recent. Note that reverting to a prior version loses all unsaved changes in the editor buffer.


Contents page

The Contents page of the history view displays all available versions of the active file. The revision list at the top allows you to sort the file versions by version type, revision number, label, date of change, or author. Select a version in the revision list to view its source in the source viewer.

The Contents page provides access to the Refresh Revision Info and Revert To Previous Revision buttons.


Diff page

This is a feature of JBuilder Professional and Enterprise
The Diff page displays differences between two selected versions of the active file. The revision lists at the top allow you to sort the file versions by version type, revision number, or date of change. It provides access to the Refresh Revision Info button.

There are two revision lists in the Diff page. One is titled From and the other is titled To. Select a version from the From list and select a different version from the To list. The differences will be displayed in the source viewer below the lists:

Viewing differences between two versions of a file

In each block of difference, the From diff is in red and the To diff is in yellow.

Use the diff arrows to move between more than one block of difference. You can also use Alt + n to move to the next diff block, or Alt + p to move to the previous diff block.

Tip: To see all changes made to the repository since you started working, select the original repository version in the From area and the file version with the highest revision number in the To area.


Info page

This is a feature of JBuilder Enterprise
The Info page of the history view displays the full text of labels and logs for any selected version of the active file. The revision list at the top allows you to sort the file versions by version type, revision number, label, date of change, author, or comment. It provides access to the Refresh Revision Info and Revert To Previous Revision buttons.

To use the Info page, select a version from the revision list. Its label and any comments that were entered describing the revision are displayed in the lower part of the page. Scroll bars allow you to view the full text of the comments and labels.