Index: modules/rdf/rdf.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/rdf/rdf.module,v
retrieving revision 1.20
diff -u -p -r1.20 rdf.module
--- modules/rdf/rdf.module	14 Jan 2010 06:31:45 -0000	1.20
+++ modules/rdf/rdf.module	21 Jan 2010 16:45:43 -0000
@@ -20,7 +20,7 @@ function rdf_help($path, $arg) {
 }
 
 /**
- * @defgroup rdf RDFa API
+ * @defgroup rdf RDF Mapping API
  * @{
  * Functions to describe entities and bundles for RDFa.
  *
@@ -263,8 +263,9 @@ function rdf_rdfa_attributes($mapping, $
  * While both default entity mappings and specific bundle mappings can be
  * defined in hook_rdf_mapping(), we do not want to save the default entity
  * mappings in the database because users are not expected to alter these.
- * Instead they should alter specific bundle mappings which are stored in the
- * database so that they can be altered via the RDF CRUD mapping API.
+ * The default entity mappings can be overriden by specific bundle mappings,
+ * which are stored in the database and can be altered via the
+ * RDF CRUD mapping API.
  */
 function rdf_modules_installed($modules) {
   // We need to clear the caches of entity_info as this is not done right
@@ -295,6 +296,12 @@ function rdf_modules_uninstalled($module
  * Implements hook_entity_info_alter().
  *
  * Adds the proper RDF mapping to each entity type, bundle pair.
+ *
+ * @todo May need to move the comment below to another place.
+ * This hook should not be used by modules to alter the bundle mappings.
+ * The UI should always be authoritative. UI mappings are stored in the database
+ * and if hook_entity_info_alter was used to override module defined mappings,
+ * it would override the user defined mapping as well.
  */
 function rdf_entity_info_alter(&$entity_info) {
   // Loop through each entity type and its bundles.