fix documentation issues spotted by @webpro. fixes issue #13