confirmation on format, refs #23, untested
doc and build fixes to get into a running state