(NFC) Cleanup new docblocks

diff --git a/CRM/Core/PrevNextCache/Interface.php b/CRM/Core/PrevNextCache/Interface.php
index aa6772c99bdc5bf0cbed608df7ec89a42d7ac6bc..6c355050e7577fdb4c6c2e1cd67a4b4464eb5efa 100644 (file)
--- a/CRM/Core/PrevNextCache/Interface.php
+++ b/CRM/Core/PrevNextCache/Interface.php
@@ -41,8 +41,11 @@ interface CRM_Core_PrevNextCache_Interface {
    *   A SQL query. The query *MUST* be a SELECT statement which yields
    *   the following columns (in order): cacheKey, entity_id1, data
    * @param array $sqlParams
-   *   An array of SQLParams to be used with the $sql
+   *   An array of parameters to be used with $sql.
+   *   Use the same interpolation format as CRM_Core_DAO (composeQuery/executeQuery).
+   *   Ex: [1 => ['foo', 'String']]
    * @return bool
+   * @see CRM_Core_DAO::composeQuery
    */
   public function fillWithSql($cacheKey, $sql, $sqlParams = []);
 

diff --git a/CRM/Core/PrevNextCache/Sql.php b/CRM/Core/PrevNextCache/Sql.php
index 38cd490f1b09e10bb642f8bd034854764df5072a..efa1756a0219b7e932d01a79b453b676bca95ab4 100644 (file)
--- a/CRM/Core/PrevNextCache/Sql.php
+++ b/CRM/Core/PrevNextCache/Sql.php
@@ -39,9 +39,12 @@ class CRM_Core_PrevNextCache_Sql implements CRM_Core_PrevNextCache_Interface {
    *   A SQL query. The query *MUST* be a SELECT statement which yields
    *   the following columns (in order): cacheKey, entity_id1, data
    * @param array $sqlParams
-   *   An array of Parameters to be used on the Insert Query
+   *   An array of parameters to be used with $sql.
+   *   Use the same interpolation format as CRM_Core_DAO (composeQuery/executeQuery).
+   *   Ex: [1 => ['foo', 'String']]
    * @return bool
    * @throws CRM_Core_Exception
+   * @see CRM_Core_DAO::composeQuery
    */
   public function fillWithSql($cacheKey, $sql, $sqlParams = []) {
     $insertSQL = "