CRM-11925 - Remove filterPermissions.

The filtering presents an imperfect facade (see JIRA)
Doc tweak
CRM-11925 - Modify upgradePermissions to work with all permissions (not just single-module permissions)