[svn-r8576] Purpose:

Add more C++ wrapper and documentation - incrementally check-in

Description:
    Added doxygen documentation to:
        H5DataSet.cpp
        H5DataSpace.cpp
        H5CommonFG.cpp

    and a wrapper for H5Rcreate to H5Object.* with tests will be added
    later.

    There are more documentation need to be added to these files but
    to preserve the changes, I check them in now.

Platforms:
    SunOS 5.7 (arabica)
    Linux 2.4 (eirene)


Misc. update:

c++/src/H5File.cpp

@@ -412,7 +412,15 @@ void H5File::getVFDHandle(void **file_handle)
    }
 }
 
-// Calls the C API H5Fclose to close this file.  Used by IdComponent::reset
+//--------------------------------------------------------------------------
+// Function:    H5File::p_close (private)
+///\brief       Closes this H5 file.
+///\exception   H5::FileIException
+///\note
+///             This function will be obsolete because its functionality
+///             is recently handled by the C library layer.
+// Programmer   Binh-Minh Ribler - 2000
+//--------------------------------------------------------------------------
 void H5File::p_close() const
 {
    herr_t ret_value = H5Fclose( id );