dontruns around broken examples (see issues 19 and 20) and fixes for broken doc syntax