update example for forthcoming new feature to be committed
update the read me
add some extra line breaks in the written .tex file

easier to parse visually if necessary
add [macro-file=] feature and checking for .tex file changes
update docs