Improve documentation of memory allocation/deallocation API

Author: aaronj0

include/CppInterOp/CppInterOp.h

@@ -838,14 +838,14 @@ enum : long int {
 CPPINTEROP_API std::vector<long int> GetDimensions(TCppType_t type);
 
 /// Allocates memory required by an object of a given class
-/// \c scope Given class for which to allocate memory for
-/// \c count is used to indicate the number of objects to allocate for.
+/// \param[in] scope Given class for which to allocate memory for
+/// \param[in] count is used to indicate the number of objects to allocate for.
 CPPINTEROP_API TCppObject_t Allocate(TCppScope_t scope,
                                      TCppIndex_t count = 1UL);
 
 /// Deallocates memory for a given class.
-/// \c scope Class to indicate size of memory to deallocate
-/// \c count is used to indicate the number of objects to dallocate for
+/// \param[in] scope Class to indicate size of memory to deallocate
+/// \param[in] count is used to indicate the number of objects to dallocate for
 CPPINTEROP_API void Deallocate(TCppScope_t scope, TCppObject_t address,
                                TCppIndex_t count = 1UL);
 
@@ -855,6 +855,8 @@ CPPINTEROP_API void Deallocate(TCppScope_t scope, TCppObject_t address,
 /// \param[in] arena If set, this API uses placement new to construct at this
 /// address.
 /// \param[in] is used to indicate the number of objects to construct.
+/// \returns a pointer to the constructed object, which is arena if placement
+/// new is used.
 CPPINTEROP_API TCppObject_t Construct(TCppScope_t scope, void* arena = nullptr,
                                       TCppIndex_t count = 1UL);