This page last changed on Oct 14, 2007 by smaddox.

The 'Manage Files' tab is displayed when you are creating a review. This tab allows you to select and modify which files make up the review.

The 'Manage Files' tab has the following sub-tabs:

Constraints on Manage Files Tab

Before using the 'Changesets' or 'Files' tabs, you can narrow the files down by specifying constraints, as listed along the top of the 'Manage Files' tab:

Repository This is a list of the repositories that contain the files that can be reviewed. If the repository you require is not in the list then it has not been added to FishEye. Please contact your Crucible/FishEye administrator.
Author This contains a list of all the authors who have made changes within the repository. When creating a review, this will default if possible to the username of the user authoring this review and will therefore show their changesets.
Branch This will only show files and recent changes on that branch from the repository set above.
Tag This will only show files and recent changes tagged.

To create a review that includes a number of revisions for a particular file, always choose the oldest revision first and then tick each revision of the file up to the most recent one. Only one version of the file will be reviewed but it will contain the diffs from the revisions chosen.

Changeset Tab


Screenshot: Changesets tab


By default, Crucible presents a list of the author's changesets in reverse chronological order. You can see other changesets by changing the constraints described above.

Click the checkbox next to the changeset ID to add the entire changeset, or the checkboxes next to file names to add or remove individual files. Click 'Remove all revisions' to remove them.

Understanding Changesets in Detail

To help decide what files are to be placed under review, the moderator can click the icons next to the files to gain further information about them before they go out for review:

Clock icon or the file URL A view detailing the history of this particular file.
Changeset ID next to the file URL A view of the complete file. Amended lines are highlighted on the left in yellow.
Down arrow icon Option to download the file.
Change Indicator (+n -n) This shows how many lines have been amended (e.g. +3 -2) and also what type of change has been made. If it says 'diffs' then you can click this to see the differences in the file between the revisions.

After you have chosen the files, click the 'Review' tab to see the files that are included in the review.

Files Tab


Screenshot: Files tab


Use the Files tab to find specific files

If you want to have specific files reviewed, rather than a changeset, it may be easier to find the files via the 'Files' tab.

To find a file, browse the folders by clicking the relevant folder. The folders by default are sorted by path name but can sorted by last-commit or first-commit

Empty folders will be greyed out.

If the folders contain empty folders then a toggle option called 'Hide Empty' will appear under the 'Sort' options.

To see or ignore deleted files, you can click the 'Hide' and 'Show' options located above the file names on the left.

To choose a file for reviewing, click the checkbox to the left of the filename and if required the revision number.

After you have chosen the files, click the 'Review' tab to see the files that are included in the review.

Search Tab


Screenshot: Search tab


If you are not certain about which changesets/revisions/files to include in a review, use the Search tab to find them.

Choose the relevant search filters and then click the 'Search' button. If the simple filters are not enough, click 'Switch to Advanced Search'. You can then create an EyeQL query can be created to produce the results. Read about EyeQL queries in the FishEye documentation.

After you have chosen the files, click the 'Review' tab to see the files that are included in the review.

Read the FishEye documentation for more information about the searching your repository.

Patch Tab

Read about creating a patch review.


SearchTab.png (image/png)
FilesTab.png (image/png)
ChangesetsTab.png (image/png)
Document generated by Confluence on Nov 29, 2007 18:19