[closes #35] Fixing documentation about the --doc-warnings flag