Documentation cleanup of object.cpp pursuant to Mantis 2897 bug-hunting.

git-svn-id: svn://svn.icculus.org/fs2open/trunk/fs2_open@9706 387891d4-d844-0410-90c0-e4c51a9137d3