a start at 'make check'
doc fixes from Jan feedback