X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=api%2Fv3%2FSystem.php;h=92f8c0659112099326fd1e902138f6cab8297ee2;hb=5e4f7f7473c2f23f2bc2197a9808e3fe138f91ed;hp=6c0f33425067df7afe756f257207e2127b85d5c5;hpb=29d98e1314e345f1b9044f5359c2d0a67f380d21;p=civicrm-core.git diff --git a/api/v3/System.php b/api/v3/System.php index 6c0f334250..92f8c06591 100644 --- a/api/v3/System.php +++ b/api/v3/System.php @@ -33,11 +33,10 @@ * * @copyright CiviCRM LLC (c) 2004-2014 * @version $Id: Domain.php 30171 2010-10-14 09:11:27Z mover $ - * */ /** - * Flush all system caches + * Flush all system caches. * * @param array $params * Input parameters. @@ -55,9 +54,10 @@ function civicrm_api3_system_flush($params) { } /** - * Adjust Metadata for Flush action + * Adjust Metadata for Flush action. + * + * The metadata is used for setting defaults, documentation & validation. * - * The metadata is used for setting defaults, documentation & validation * @param array $params * Array or parameters determined by getfields. */ @@ -67,12 +67,13 @@ function _civicrm_api3_system_flush_spec(&$params) { } /** - * System.Check API specification (optional) + * System.Check API specification (optional). + * * This is used for documentation and validation. * * @param array $spec * Description of fields supported by this API call. - * @return void + * * @see http://wiki.civicrm.org/confluence/display/CRM/API+Architecture+Standards */ function _civicrm_api3_system_check_spec(&$spec) { @@ -80,9 +81,10 @@ function _civicrm_api3_system_check_spec(&$spec) { } /** - * System.Check API + * System.Check API. * * @param array $params + * * @return array * API result descriptor; return items are alert codes/messages * @see civicrm_api3_create_success @@ -100,13 +102,15 @@ function civicrm_api3_system_check($params) { } /** + * Log entry to system log table. + * * @param array $params * * @return array */ function civicrm_api3_system_log($params) { $log = new CRM_Utils_SystemLogger(); - // this part means fields with separate db storage are accepted as params which kind of seems more intuitive to me + // This part means fields with separate db storage are accepted as params which kind of seems more intuitive to me // because I felt like not doing this required a bunch of explanation in the spec function - but perhaps other won't see it as helpful? if (!isset($params['context'])) { $params['context'] = array(); @@ -122,7 +126,8 @@ function civicrm_api3_system_log($params) { } /** - * Metadata for log function + * Metadata for log function. + * * @param array $params */ function _civicrm_api3_system_log_spec(&$params) { @@ -157,9 +162,10 @@ function _civicrm_api3_system_log_spec(&$params) { } /** - * System.Get API + * System.Get API. * * @param array $params + * * @return array */ function civicrm_api3_system_get($params) {