Prohibit non-administrative users from directly manipulating the illumination level.

Author: glyph

Reviewer: exarkun

Fixes #2603

This changes the actor interface of the first administrative command, 'illuminate', to be `IManipulator` rather than the standard `IActor`, and moves the logic of changing the illumination level into the model and out of the action.

(It also adds a bunch of useful docstrings for unrelated functionality, that I had to investigate in order to fix the issue in question.)