[picketlink-issues] [JBoss JIRA] (PLINK-589) Permission API documentation improvement