merge of content from gh-pages branch with update for Permit Empty directive

This is the content from the gh-pages branch with the update about the Permit Empty directive applied. This update has been removed from the gh-pages branch.