Clarify a bit getNameForObject correct usage.

diff --git a/lib/xmldb/classes/generators/XMLDBGenerator.class.php b/lib/xmldb/classes/generators/XMLDBGenerator.class.php
index ca7800acff4d29dbe57ba730f3c11eb1f1764839..646b32a083e295c316f7c753b176cf0c0bc29281 100644 (file)
--- a/lib/xmldb/classes/generators/XMLDBGenerator.class.php
+++ b/lib/xmldb/classes/generators/XMLDBGenerator.class.php
@@ -882,8 +882,11 @@ class XMLDBgenerator {
     }
 
     /**
-     * Given three strings (table name, list of fields (comma separated) and suffix), create the proper object name
-     * quoting it if necessary
+     * Given three strings (table name, list of fields (comma separated) and suffix), 
+     * create the proper object name quoting it if necessary.
+     * 
+     * IMPORTANT: This function must be used to calculate names of objects to be created, 
+     *            never to guess names of existing objects!
      */
     function getNameForObject($tablename, $fields, $suffix='') {