Major cleanup to the niobject documentation as well as addition of deprecation and removal info where applicable.