add README:  explain project layout
rearrange star grammars and examples into subdirectory
comments to main star-parsing module to indicate differences between full and simple parsers more clearly