update a few documentation bugs
add missing optional delimiter for consistency
Merge pull request #1344 from benfitzpatrick/doc.update

Update a few documentation bugs