INFRA-132 - Batch 14 (g)

[civicrm-core.git] / api / v3 / Contact.php

diff --git a/api/v3/Contact.php b/api/v3/Contact.php
index fb619c9d7663283276586a361e9f031b2eb9dd66..4a23bdd0b49182102b2562cccb69226c41e02687 100644 (file)
--- a/api/v3/Contact.php
+++ b/api/v3/Contact.php
@@ -53,8 +53,6 @@
  * @return array
  *   API Result Array
  *
- * @static void
- * @access public
  */
 function civicrm_api3_contact_create($params) {
 
@@ -147,12 +145,6 @@ function _civicrm_api3_contact_create_spec(&$params) {
  *
  * @return array
  *   API Result Array
- * (@getfields contact_get}
- * @static void
- * @access public
- *
- * @example ContactGet.php Standard GET example
- *
  */
 function civicrm_api3_contact_get($params) {
   $options = array();
@@ -270,14 +262,10 @@ function _civicrm_api3_contact_get_supportanomalies(&$params, &$options) {
  * Delete a contact with given contact id
  *
  * @param array $params
- *   (reference ) input parameters, contact_id element required.
+ *   input parameters per getfields
  *
  * @return array
  *   API Result Array
- * @access public
- *
- * @example ContactDelete.php
- * {@getfields contact_delete}
  */
 function civicrm_api3_contact_delete($params) {
 
@@ -308,15 +296,12 @@ function civicrm_api3_contact_delete($params) {
 /**
  * @param array $params
  * @param bool $dupeCheck
- * @param bool $dupeErrorArray
- * @param bool $obsoletevalue
- * @param int $dedupeRuleGroupID
  *
  * @return null
  * @throws API_Exception
  * @throws CiviCRM_API3_Exception
  */
-function _civicrm_api3_contact_check_params(&$params, $dupeCheck = TRUE, $dupeErrorArray = FALSE, $obsoletevalue = TRUE, $dedupeRuleGroupID = NULL) {
+function _civicrm_api3_contact_check_params(&$params, $dupeCheck) {
 
   switch (strtolower(CRM_Utils_Array::value('contact_type', $params))) {
     case 'household':
@@ -413,9 +398,7 @@ function _civicrm_api3_contact_check_params(&$params, $dupeCheck = TRUE, $dupeEr
  * @param int $contactID
  *   If present the contact with that ID is updated.
  *
- * @return CRM_Contact_BAO_Contact object
- * @access public
- * @static
+ * @return CRM_Contact_BAO_Contact|CRM_Core_Error
  */
 function _civicrm_api3_contact_update($params, $contactID = NULL) {
   //@todo - doesn't contact create support 'id' which is already set- check & remove
@@ -435,7 +418,6 @@ function _civicrm_api3_contact_update($params, $contactID = NULL) {
  *
  * @throws API_Exception
  *
- * @access public
  */
 function _civicrm_api3_greeting_format_params($params) {
   $greetingParams = array('', '_id', '_custom');
@@ -560,7 +542,9 @@ function _civicrm_api3_greeting_format_params($params) {
  * @deprecated
  *
  * {@example ContactGetquick.php 0}
- *
+ * @param array $params
+ * @return array
+ * @throws \API_Exception
  */
 function civicrm_api3_contact_getquick($params) {
   civicrm_api3_verify_mandatory($params, NULL, array('name'));
@@ -857,7 +841,7 @@ LIMIT    0, {$limit}
 /**
  * @deprecated api notice
  * @return array
- *   of deprecated actions
+ *   Array of deprecated actions
  */
 function _civicrm_api3_contact_deprecation() {
   return array('getquick' => 'The "getquick" action is deprecated in favor of "getlist".');
@@ -879,8 +863,6 @@ function _civicrm_api3_contact_deprecation() {
  * @return array
  *   API Result Array
  *
- * @static void
- * @access public
  */
 function civicrm_api3_contact_merge($params) {
   $mode = CRM_Utils_Array::value('mode', $params, 'safe');