Improve documentation and formatting of debug settings file

This change uses a comment style that is more in keeping with the PHP code
conventions and adds an explanatory blurb about what the file is and how to use
it. Still quite a bit of room for improvement.

Change-Id: I2869f96f65fe097b2d8d1f041c488ae97e47d2af