Clearly document the custom_acls_* configuration parameters

Add documentation, do a little reformatting.
Reword for clarity
Merge branch 'cm/custom_acl_doc'