lucene 4.2.1 , document new query parser, allow path regexp if just one and enclosed in /

Author: Lubos Kosco

nbproject/project.properties

@@ -44,7 +44,7 @@ jnlp.mixed.code=default
 jnlp.signing=
 jnlp.signing.alias=
 jnlp.signing.keystore=
-lucene.version=4.2.0
+lucene.version=4.2.1
 lucene-core.jar=lucene-core-${lucene.version}.jar
 lucene-analyzers-common.jar=lucene-analyzers-common-${lucene.version}.jar
 lucene-queryparser.jar=lucene-queryparser-${lucene.version}.jar

opengrok-web-nbproject/nbproject/project.properties

@@ -25,7 +25,7 @@ dist.javadoc.dir=${dist.dir}/javadoc
 dist.war=${dist.dir}/${war.name}
 endorsed.classpath=
 excludes=
-lucene.version=4.2.0
+lucene.version=4.2.1
 lucene-core.jar=lucene-core-${lucene.version}.jar
 lucene-analyzers-common.jar=lucene-analyzers-common-${lucene.version}.jar
 lucene-queryparser.jar=lucene-queryparser-${lucene.version}.jar

src/org/opensolaris/opengrok/search/QueryBuilder.java

@@ -270,7 +270,8 @@ private String escapeQueryString(String field, String query) {
                 return query.replace("::", "\\:\\:");
             case PATH:
                 // workaround for replacing / with escaped / - needed since lucene 4.x
-                return (query.replace(":", "\\:")).replace("/", "\\/");
+                if (!(query.startsWith("/") && query.endsWith("/"))) {
+                return (query.replace(":", "\\:")).replace("/", "\\/"); }
             // Other fields shouldn't use qualified terms, so escape colons
             // so that we can search for them.
             default:

web/help.jsp

@@ -75,14 +75,19 @@ A <dfn>Query</dfn> is a series of clauses. A clause may be prefixed by:</p>
         <b>OR</b>(<b>||</b>), <b>NOT</b>(<b>!</b>) and "<b>-</b>" (Note: they
         must be ALL CAPS).</li>
 </ul>
-<p>Wildcard, Fuzzy, Proximity &amp; Range Searches:</p>
+<p>Regular Expression, Wildcard, Fuzzy, Proximity &amp; Range Searches:</p>
 <ul>
+    <li>to perform a regular expression search use the "<b>/</b>" enclosure,
+        e.g.  /[mb]an/ - will search for man or for ban;
+        NOTE: path field search escapes "/" by default, so it only supports 
+        regexps when the search string <u>starts and ends</u> with "/"
+    </li>
     <li>to perform a single character wildcard search use the "<b>?</b>" symbol,
         e.g.  te?t</li>
     <li>to perform a multiple character wildcard search use the "<b>*</b>"
         symbol, e.g. test* or te*t</li>
-    <li>you cannot use a * or ? symbol as the first character of a search
-        (unless enabled using indexer option -a).</li>
+    <li>you can use a * or ? symbol as the first character of a search
+        (unless not enabled using indexer option -a).</li>
     <li>to do a fuzzy search(find words similar in spelling, based on the
         Levenshtein Distance, or Edit Distance algorithm) use the tilde,
         "<b>~</b>", e.g. rcs~ </li>
@@ -101,7 +106,7 @@ A <dfn>Query</dfn> is a series of clauses. A clause may be prefixed by:</p>
 <a id="escaping"><dfn>Escaping special characters:</dfn></a>
 <p>Opengrok supports escaping special characters that are part of the query
     syntax. Current special characters are:<br/>
-    <b>+ - &amp;&amp; || ! ( ) { } [ ] ^ " ~ * ? : \ </b><br/>
+    <b>+ - &amp;&amp; || ! ( ) { } [ ] ^ " ~ * ? : \ / </b><br/>
 To escape these character use the \ before the character. For example to search
 for <b>(1+1):2</b> use the query: <b>\(1\+1\)\:2</b>
 </p>