added bsearch function and improved the inline documentation
fixed the java String comparison method
improved the inline documentation