Merge remote-tracking branch 'upstream/4.5' into 4.5-4.6-2015-03-23-18-42-19
[civicrm-core.git] / CRM / Core / Reference / Interface.php
index 169de419d2e3c6fbd8a7075ad8f9e5a3cfc2bb28..09e0a0ba6dbf5eec1ab98082dc6cc1046c5906f5 100644 (file)
@@ -17,20 +17,24 @@ interface CRM_Core_Reference_Interface {
   public function matchesTargetTable($tableName);
 
   /**
-   * Create a query to find references to a particular record
+   * Create a query to find references to a particular record.
    *
-   * @param CRM_Core_DAO $targetDao the instance for which we want references
+   * @param CRM_Core_DAO $targetDao
+   *   The instance for which we want references.
    * @return CRM_Core_DAO|NULL a query-handle (like the result of CRM_Core_DAO::executeQuery)
    */
   public function findReferences($targetDao);
 
   /**
-   * Create a query to find references to a particular record
+   * Create a query to find references to a particular record.
    *
-   * @param CRM_Core_DAO $targetDao the instance for which we want references
-   * @return array a record describing the reference; must include the keys:
-   *  - 'type': string (not necessarily unique)
-   *  - 'count': int
+   * @param CRM_Core_DAO $targetDao
+   *   The instance for which we want references.
+   * @return array
+   *   a record describing the reference; must include the keys:
+   *   - 'type': string (not necessarily unique)
+   *   - 'count': int
    */
   public function getReferenceCount($targetDao);
+
 }