fix warnings in Ant file
make comments consistent in basic usage examples
simplify scheme usage example
allow passing of String or char[] to a Java-based Parser, deprecate use of InputBuffer