review of the interface
new parser options for the demo
verbose README