Documentation: Add phpdoc for ObjectManager class

Also moves a couple functions arround so that all the functions making
up the public API are at the top of the class and in a logical order.
No functionality changes in this patch.

Change-Id: Ibb152c20bd9ebda8f6e486dca7d0754c1ae35cdf
Merge "Documentation: Add phpdoc for ObjectManager class"