finish documenting (jacoco, regexps for ctags)

Author: tarzanek

README.txt

@@ -702,10 +702,9 @@ Now you can instrument your classes and test them run:
 
   $ ant -Djacoco=true -Djacoco.home=/<path_to>/jacoco jacoco-code-coverage
 
-Now you should get output data in .
+Now you should get output data in jacoco.exec
 
-Look at coverage/coverage.txt, coverage/coverage.xml and 
-coverage/coverage.html to see how complete your tests are.
+Look at jacoco/index.html to see how complete your tests are.
 
 9.4 Using Checkstyle
 --------------------

src/org/opensolaris/opengrok/analysis/Ctags.java

@@ -96,6 +96,12 @@ private void initialize() throws IOException {
 
             //Ideally all below should be in ctags, or in outside config file, 
             //we might run out of command line SOON
+            
+            //Also note, that below ctags definitions HAVE to be in POSIX
+            //otherwise the regexp will not work on some platforms
+            //on Solaris regexp.h used is different than on linux (gnu regexp)            
+            //http://en.wikipedia.org/wiki/Regular_expression#POSIX_basic_and_extended
+            
             command.add("--langdef=scala"); // below is bug 61 to get full scala support
             command.add("--langmap=scala:.scala");
             command.add("--regex-scala=/^[[:space:]]*((abstract|final|sealed|implicit|lazy)[[:space:]]*)*(private|protected)?[[:space:]]*class[[:space:]]+([a-zA-Z0-9_]+)/\\4/c,classes/");