Documentation tweaks in automodapi
Fix the :skip: option of automodapi to not generate skipped function/class docs

Closes #983
Merge pull request #1088 from eteq/issue-983

Fix automodapi :skip: directive