If you're interested in the general search.jboss.org FAQ go here:JBoss Community Search FAQ
Examples of simple searches:
|drools performance tips|
Examples of searches using advanced Lucene query language:
|hibernate AND session||Search for documents that contain hibernate and session.|
|+hibernate +session||Same as previous example but using different notation.|
|"cache invalidation"~4||Search 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
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).
|subject:netty||Search for documents that contain netty in the subject field.|
Search for documents that contain netty or service in the subject field.
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:
|subject||subject:welcome||Email subject (available only in emails).|
|author||author:emmanuel||Author of the document.|
|project||project:hibernate||Name of the project.|
|date||First two examples are the same, the later is just shorter. The last is an example of an unbounded lower boundary.|
|mail_list||mail_list:(dev users)||Mail list type: dev, users.|
|message_attachments||message_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:
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.
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.
Results sorting and Instant search
Search results can be sorted (1) by relevancy and date (the newest first or the oldest first).
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.
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.
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:
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.