From 5c5ea474c4e3e8423340269ee5e24af92a5432e0 Mon Sep 17 00:00:00 2001
From: "Eloy Lafuente (stronk7)" <stronk7@moodle.org>
Date: Wed, 14 Dec 2011 22:37:40 +0100
Subject: [PATCH] MDL-30592 moodlelib: minor phpdocs/debug tweaks

---
 lib/moodlelib.php | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/lib/moodlelib.php b/lib/moodlelib.php
index b01fa1ca3d5..527c3be7621 100644
--- a/lib/moodlelib.php
+++ b/lib/moodlelib.php
@@ -7771,22 +7771,24 @@ function get_list_of_plugins($directory='mod', $exclude='', $basedir='') {
 }
 
 /**
-* invoke plugin's callback functions
+* Invoke plugin's callback functions
 *
-* @param string $type Plugin type e.g. 'mod'
-* @param string $name Plugin name
-* @param string $feature Feature name
-* @param string $action Feature's action
+* @param string $type plugin type e.g. 'mod'
+* @param string $name plugin name
+* @param string $feature feature name
+* @param string $action feature's action
 * @param array $params parameters of callback function, should be an array
 * @param mixed $default default value if callback function hasn't been defined, or if it retursn null.
 * @return mixed
+*
+* @todo Decide about to deprecate and drop plugin_callback() - MDL-30743
 */
 function plugin_callback($type, $name, $feature, $action, $params = null, $default = null) {
     return component_callback($type . '_' . $name, $feature . '_' . $action, (array) $params, $default);
 }
 
 /**
- * invoke plugin's callback functions
+ * Invoke component's callback functions
  *
  * @param string $component frankenstyle component name, e.g. 'mod_quiz'
  * @param string $function the rest of the function name, e.g. 'cron' will end up calling 'mod_quiz_cron'
@@ -7799,7 +7801,7 @@ function component_callback($component, $function, array $params = array(), $def
 
     $cleancomponent = clean_param($component, PARAM_COMPONENT);
     if (empty($cleancomponent)) {
-        throw new coding_exception('Invalid component used in plugin_callback():' . $component);
+        throw new coding_exception('Invalid component used in plugin/component_callback():' . $component);
     }
     $component = $cleancomponent;
 
@@ -7811,7 +7813,7 @@ function component_callback($component, $function, array $params = array(), $def
 
     $dir = get_component_directory($component);
     if (empty($dir)) {
-        throw new coding_exception('Invalid component used in plugin_callback():' . $component);
+        throw new coding_exception('Invalid component used in plugin/component_callback():' . $component);
     }
 
     // Load library and look for function