Usage tips for SOURCERER

Including wildcards

You can use lucene wildcards to enhance your search (in keywords mode) for example, entering:

synch*  AND  network

will match keywords with 'network' and 'synch' followed by anything. Fuzzy search can be specified by appending '~' at the end, for example,

database AND connect~

means something that has 'database' and text similar to 'connect'. Another example is,

vector AND normalize~

This will match 'normalize' as well as 'normalise'.

Searching specific fields in the code

SOUCERER allows you to search in specific fields in the code. Currently these fields are supported:

• comments - search in comments
• content - search in the fully qualified name (FQN)
• proper_name - search in the leftmost component of the FQN

Example:

 comments:(network AND data) AND contents:(socket OR port) AND proper_name:(send OR receive)
 

the above query will search for code entities that have 'network' and 'data' in their comments, 'socket' or 'port' anywhere in their FQN, and 'send' or 'receive' appearing in the rightmost part of the FQN.

The default fields that are searched when you do not specify these fields explicitly are: content and proper_name.

Fingerprint inputs

The Fingerprints search take all numeric inputs. You can either give an integer or append a relational operator (<, >, =, >=, <=, !=) before the integer with space in between. (For example, ">= 3".. ignore the quotes). Default value for a fingerprint feature is assumed to be ">= 0".

Known Issues

Please use all small letters for keywords and all capitals for logical connectives for them. (eg; quick~ AND sort )

Currently the forms do not validate for errors in input, so you might see error messages for invalid inputs. Please make sure you take care of these:

• If you are using wildcards, give permitted combinations of wildcards in keywords as described here.
• In fingerprints search, either give a single number (integer) or a relational operator (listed above) followed by space followed by a number.

We are working on these issues and will be fixed ASAP.

Browser Compatibility

For the best experience with SOURCERER please use Firefox.

Feedback.

Please note that we are upgrading SOURCERER constantly. If you experience problems you can try refreshing the page, navigating back and resubmitting the query or staring over again. If the problem persists please report us at (sourcerer_AT_ics.uci.edu, replace _AT_ with @) and visit the site after some time.

Thank You!