Browsing through a repository

Browsing a repository

To browse a repository:

1. Click Repositories in the header and choose either a recently viewed repository, or All repositories. 
2. Click the name of a repository to view its contents. See the 'Viewing a repository' screenshot below.
3. If required, use the selector (under the repository or file name) to choose the branch or tag that you want to browse the changelog for.
4. You can view various information about the repository, as outlined below. If you navigate to a folder, the context of the information below will change. For example, if you navigate to a particular folder in the left navigation tree, the activity, files and users information, reports generated and search results will all relate to that folder.
   A greyed out item is either a deleted file or an empty/deleted (folder).
   
   • Activity tab — View the commit, review and issue (requires JIRA) activity related to the repository/folder. The activity stream is similar to the changelog activity stream, see Viewing the changelog for more information.
   • Commit Graph tab — Visualise the repository, using the commit graph. See Viewing the commit graph for a repository for more information.
   • Files tab — View the contents of the repository/folder being viewed.
   • Users tab — View the commit history of the users that have committed changes to files in the repository/folder. See Viewing People's Statistics for more information.
   • Reports — View activity charts for the repository/folder. See FishEye Charts for more information.
   • Search — Search the repository/folder. See Searching FishEye for more information.
5. Click any file, when browsing the repository, to view information about the file. See Viewing a file for more information.

Screenshot: Browsing a repository

Hiding empty directories and deleted files

FishEye tracks deleted files for your repository. Deleted files will be greyed out in your left-hand navigation tree. If all of the files in a directory are deleted, the empty directory will also be greyed out. Note, deleted files and empty directories are not removed from your left navigation.

You can choose to hide deleted files and empty directories in the left navigation tree when browsing through a repository, as described below.

To hide deleted directories/files in your navigation tree:

1. Click the Source tab and browse a repository.
2. In the left hand navigation panel, click the  to show the dropdown menu:
   
   • Hide empty directories – hide all empty (greyed out) directories and their contents (i.e. deleted files and other empty directories).
   • Hide deleted files – hide deleted (i.e. greyed out) files. This does not affect directories.

Hence, if you choose to hide both empty directories and deleted files, you will only see files and directories that exist on the Head of that path. In repositories other than Subversion repositories, this could mean files/directories on any branch.

Screenshot: Hiding deleted files/empty directories

Watching a repository

You can "watch" a repository in FishEye/Crucible. Watching the repository allows you to receive emails when changes are made to the repository. You can view all of your watches and configure the frequency of your watch emails in your user profile. See Changing your user profile for more information.

Note, the option to add a watch will only be available if the administrator has enabled watches for the repository.

To watch a repository:

1. Navigate to the repository that you want to watch.
2. Choose Tools > Watch.  (The watch icon becomes coloured, not grey).

To remove the watch, choose Tools > Watch again. (The watch icon becomes grey). You can also remove watches from within your user profile.