Add the lacking documentation for the PermissionController.php

Adds a good amount of documentation.
Merge pull request #2 from boboman13/patch-1

Add the lacking documentation for the PermissionController.php