This page last changed on Sep 22, 2008 by edawson.

FishEye allows you to search through the repository to find particular changesets or files.

Below we describe the three ways to search:

Quick Search

To use this search, enter your search term in the 'Quick Search' box in the top right hand corner of the FishEye screens.

Screenshot: Quick Search box

You can search for the following:

  • Authors
  • Branch names
  • Commit comments
  • Changeset ids
  • Filenames/paths
  • File content
  • Tags
  • Date (YYYY-MM-DD format, or any substring of that)
  • Added/Removed diff text.

Results are sorted by relevance, with limited results per page. Click 'Next' to load following pages. Search matches inside the results are highlighted in yellow.

Restricting searches by prefixing database field
You can search matches against a given field, by using a search in this format:

author:anna

This would return all results from the author field that match the string 'anna'.

Searches can be specifically restricted to the following available fields:

  • Author
  • Comment
  • Contents
  • File (You can use Antglobs)
  • Branch
  • Tag
  • Cs
  • Date
  • AddedLine
  • RemovedLine.

Searching for discrete strings with precise case
To search for a specific string that appears discretely, with specific capital or non-capital letters, search with quotation marks, as in the following example:

"Monkey"

This search will ignore occurrences of the string that appear embedded in other strings, have different case, or are part of a path or disk location. The example above would not return "ProjectMonkey", "monkey", or "/zoo/mammals/monkey/archie/".
Note that regular quick searches do not take case into account and phrases cannot be searched in Quick Search at present.

File content Quick Search is a brand new feature in the FishEye 1.6 public beta and is still under development. If you want to access historical file contents in the repository, you will need to re-index it.

Simple Search

To access the simple search screen, click the 'Search' tab in the top right-hand corner of the FishEye screens.

Screenshot: FishEye Simple Search panel

You can use this search to retrieve a list of changesets/files using the filters that are available. You can search using one or more of the following filters:

  • Commit comments
  • Contents of files — files must be non-binary, less than 5MB, and located on the trunk/head
  • File names/paths — Antglobs can be used
  • Authors
  • Branch names
  • Tag names
  • Revision dates before and after.

Results can be grouped by the following:

  • Changeset
  • Revision
  • File
  • Directory.

The results are shown in a standard HTML view. You can choose to show the results in a tabular format by using the 'Tabular/CSV' checkboxes, and you can save the results to a CSV file.

The following fields are shown:

  • Path
  • Revision
  • Author
  • Date
  • Comment
  • Changeset
  • Total lines
  • Total lines added
  • Total lines removed
  • Tags.

Advanced Search

In some circumstances the results of a simple search may not be specific enough. Using the advanced search, you can create your own complex searches using FishEye's powerful query language called EyeQL.

Screenshot: FishEye Advanced Search

To do an advanced search, click the 'Switch to Advanced Search' link found on the top left-hand side of the Simple Search screen.

Use Simple Search to build your basic query first

You can flick between Simple and Advanced Search. The EyeQL statement will contain the basics of the statement and you can adapt it as required.


Document generated by Confluence on Sep 23, 2008 01:42