A better comment I hope ...

This commit was SVN r8477.

opal/mca/base/mca_base_component_repository.h

@@ -28,13 +28,13 @@ extern "C" {
     OMPI_DECLSPEC int mca_base_component_repository_init(void);
 
 /* This file provide the external interface to our base component module.
- * At this level we don't need a proper definition for the lt_dlhandle,
+ * Most of the components that depend on it, will use the retain_component
- * just a void* is enought. Except for all file that really require the
+ * function to increase the reference count on a particular component. But
- * header ltdl.h because they use functions declared inside. As the ltdl.h
+ * it's convenient to have all the functions exported from one source file
- * header file define LTDL_H when it get included, we can use it to detect
+ * in the same header. That's why we keep the retain function here. However,
- * if we have to furnish our fake definition for the lt_dlhandle. However,
+ * because this function require the definition of the lt_dlhandle type,
- * all files needing the ltdl.h header have to includ it before including
+ * therefore it will be included only when the ltdl.h has been previously
- * this one.
+ * included in the headers list.
  */
 #if defined(LTDL_H)
     OMPI_DECLSPEC int mca_base_component_repository_retain(char *type,