JBoss Community Search Help

 

If you're interested in the general search.jboss.org FAQ go here:JBoss Community Search FAQ

Searching...

Query language

Examples of simple searches:

 

QueryExplanation
drools performance tips
hibernate search
infinispan cluster

 

Examples of searches using advanced Lucene query language:

 

QueryExplanation
hibernate AND sessionSearch for documents that contain  hibernate and session.
+hibernate +sessionSame as previous example but using different notation.
"cache invalidation"~4Search for documents that contain cache and invalidation where they are within a specified word distance.

 

The query language is based on Lucene query syntax: http://lucene.apache.org/java/3_4_0/queryparsersyntax.html

 

Named fields

Every document stored in our index is in fact an associative array of field/value pairs. This means that if you want you can query against specific fields (see Lucene query syntaxt documentation on Fields for more info).

 

QueryExplanation
subject:nettySearch for documents that contain netty in the subject field.
subject:(netty service)

Search for documents that contain netty or service in the subject field.

project:infinispan AND author:manik

Search for documents that contain infinispan in the project field and manik in the author field.

 

As of now you can use the following fields:

 

FieldExamplesExplanation
subjectsubject:welcomeEmail subject (available only in emails).
authorauthor:emmanuelAuthor of the document.
projectproject:hibernateName of the project.
date

date:[2008-02-01 TO 2010-05-01]

date:[2008-2 2010-5]

date:[* 2010]

First two examples are the same, the later is just shorter. The last is an example of an unbounded lower boundary.
mail_listmail_list:(dev users)Mail list type: dev, users.
message_attachmentsmessage_attachments:(execution rule)Search in mail attachments.

 

Using the Web User Interface

The Web User Interface provides faceted search options and several easy-to-use filters:

Filtering

Instead of using named fields in query string you can easily narrow search using interactive filters. Currently, it is possible to filter by project (1), date (2), mail list (3) type and author (4) as depicted on the image below.

search-filters.png

 

All fitlers are quite similar in functionality, except the date filter which provides not only predefined time frames (past week, month, quarter, year and custom interval) but also interactive histogram in which you can select interval by pointing device. Project filter also allows to order its items either by name or frequency.

 

If you want to save some space on screen for search results you can hide filters in an easy way. Project filter can be collapsed by clicking on the small blue arrow in its left-hand top corner. Date, Mail list type and author filters are all nested in tab that can be collapsed by clicking on the small blue arrow or its right-hand border line.

 

Search results can be sorted (1) by relevancy and date (the newest first or the oldest first).

search-box.png

We hope the search to be fast enough to constantly provide new search results as you type (aka instant search), however, sometimes this can be impractical, thus you can turn this feature off using a small checkbox (2) below the search button. Note: in some situations it can be a useful performance tip to turn instant search off, especially if your web borwser is slower or your machine is under heavy load.

Document preview

Search.jboss.org does not only provide you with search results but it can also show you a quick preview of individual documents with relevant search terms highlighted.

search-result.png

When you click the search hit title (1) it will open a new browser window (or tab) with particular document as it can be found on lists.jboss.org site. However, if you click the small icon next to the title or the snippet text (2) then a document preview window will open directly inside the search application:

search-preview.png

Conversation thread (experimental)

The preview window tries to reconstruct mail thread that this email is a part of. It should be noted that this is an experimental feature right now (do not always expect perfect results). Explaining how exactly the mail thread is reconstructed is out of scope of this page but let's just point out that it can be very tricky and difficult process and we hope to improve it going forward.

 

Upon opening the preview window the mail thread is reconstructed using one of two methods:

  • either based on original mail header data (Header references)
  • or based on mail subject similarity (Includes subject pattern)

You can switch between these two options using select box on the top of the window. You can also use checkbox to filter out results that are found in different project/mail list type scope.