No, this is not a "simple function"

diff --git a/api/v3/utils.php b/api/v3/utils.php
index 3281beada05d6c650d2e3044d198a6a7fad9e69e..dc71983581da2551c141e0f19f2451671fe123f9 100644 (file)
--- a/api/v3/utils.php
+++ b/api/v3/utils.php
@@ -461,10 +461,15 @@ function _civicrm_api3_store_values(&$fields, &$params, &$values) {
 }
 
 /**
- * Get function for query object api.
+ * Query function for civicrm_api_basic_get.
+ *
+ * Fetches an entity based on specified params for the "where" clause,
+ * return properties for the "select" clause,
+ * as well as limit and order.
+ *
+ * Automatically joins on custom fields to return or filter by them.
  *
- * This is a simple get function, but it should be usable for any kind of
- * entity. I created it to work around CRM-16036.
+ * Supports an additional sql fragment which the calling api can provide.
  *
  * @param string $dao_name
  *   Name of DAO