Removed Doxygen warnings caused by improper formatting of several headers

Removed Doxygen warnings caused by improper formatting of several headers

OCResource.h and OCPlatform.h had a number of methods where improperly
documented.  They had:

* Incorrect parameter names for a several methods,

* Missing documentation for overloaded methods,

* Where only one overload was documented, often the documentation was
  attached to the wrong overloaded method,

* Improper capitalization, and

* Formatting that impairs readability of Doxygen HTML documentation.

This commit addresses those issues.

Change-Id: I4536964afe91f4278810fe2d71f0cf74cf7a78b7
Signed-off-by: William Dieter <william.r.dieter@intel.com>
Reviewed-on: https://gerrit.iotivity.org/gerrit/417
Tested-by: jenkins-iotivity <jenkins-iotivity@opendaylight.org>
Reviewed-by: Jon A. Cruz <jonc@osg.samsung.com>
Reviewed-by: Erich Keane <erich.keane@intel.com>
Reviewed-by: Sudarshan Prasad <sudarshan.prasad@intel.com>