From c28e17683c9a697a035d17c26f337c2229275673 Mon Sep 17 00:00:00 2001
From: Coleman Watts <coleman@civicrm.org>
Date: Thu, 5 Feb 2015 14:09:30 -0500
Subject: [PATCH] Cleanup api3 docblocks

---
 api/v3/Acl.php                     |  2 +-
 api/v3/AclRole.php                 |  2 +-
 api/v3/ActionSchedule.php          |  1 -
 api/v3/Activity.php                | 10 +++-----
 api/v3/ActivityContact.php         |  4 +---
 api/v3/ActivityType.php            |  5 ++--
 api/v3/Address.php                 |  4 +---
 api/v3/Attachment.php              |  2 --
 api/v3/Batch.php                   |  2 +-
 api/v3/Campaign.php                |  3 +--
 api/v3/Case.php                    |  3 +--
 api/v3/CaseType.php                |  4 +---
 api/v3/Constant.php                |  3 +--
 api/v3/Contact.php                 | 13 ++++++-----
 api/v3/ContactType.php             | 13 ++++-------
 api/v3/Contribution.php            |  4 +---
 api/v3/ContributionPage.php        |  3 +--
 api/v3/ContributionRecur.php       |  6 ++---
 api/v3/ContributionSoft.php        |  4 +---
 api/v3/Country.php                 |  6 +----
 api/v3/CustomField.php             |  6 ++---
 api/v3/CustomGroup.php             |  4 +---
 api/v3/CustomSearch.php            | 33 ++++++++++++++++++++++++++
 api/v3/CustomValue.php             | 13 +++++------
 api/v3/Dashboard.php               |  6 +----
 api/v3/DashboardContact.php        |  3 +--
 api/v3/Domain.php                  |  4 +---
 api/v3/Email.php                   |  4 +---
 api/v3/Entity.php                  |  2 --
 api/v3/EntityTag.php               |  4 +---
 api/v3/Event.php                   |  4 +---
 api/v3/Extension.php               | 10 ++++----
 api/v3/File.php                    | 15 ++++++------
 api/v3/FinancialAccount.php        |  2 +-
 api/v3/FinancialType.php           |  2 +-
 api/v3/Generic/Update.php          |  2 ++
 api/v3/Grant.php                   |  7 +++---
 api/v3/Group.php                   | 10 +++-----
 api/v3/GroupContact.php            |  6 +----
 api/v3/GroupNesting.php            |  4 +---
 api/v3/GroupOrganization.php       |  4 +---
 api/v3/Im.php                      |  3 +--
 api/v3/Job.php                     |  7 +-----
 api/v3/LineItem.php                |  3 +--
 api/v3/LocBlock.php                |  6 ++---
 api/v3/LocationType.php            |  4 +---
 api/v3/MailSettings.php            | 14 ++++-------
 api/v3/Mailing.php                 |  2 --
 api/v3/MailingAB.php               |  2 --
 api/v3/MailingComponent.php        |  2 +-
 api/v3/MailingContact.php          |  4 +---
 api/v3/MailingEventConfirm.php     |  5 +---
 api/v3/MailingEventQueue.php       |  2 --
 api/v3/MailingEventResubscribe.php |  2 --
 api/v3/MailingEventSubscribe.php   |  2 --
 api/v3/MailingEventUnsubscribe.php |  2 --
 api/v3/MailingGroup.php            |  4 +---
 api/v3/MailingJob.php              |  5 +---
 api/v3/MailingRecipients.php       |  5 +---
 api/v3/Membership.php              |  4 +---
 api/v3/MembershipBlock.php         | 18 +++++++--------
 api/v3/MembershipPayment.php       |  4 +---
 api/v3/MembershipStatus.php        |  4 +---
 api/v3/MembershipType.php          |  4 +---
 api/v3/MessageTemplate.php         |  2 +-
 api/v3/Note.php                    |  4 +---
 api/v3/OptionGroup.php             | 37 ++++++++++++++++++++++++++++--
 api/v3/OptionValue.php             | 34 +++++++++++++++++++++++++++
 api/v3/Participant.php             |  4 +---
 api/v3/ParticipantPayment.php      |  6 ++---
 api/v3/ParticipantStatusType.php   |  9 +++-----
 api/v3/PaymentProcessor.php        |  3 +--
 api/v3/PaymentProcessorType.php    |  5 +---
 api/v3/Phone.php                   |  4 +---
 api/v3/Pledge.php                  |  4 +---
 api/v3/PledgePayment.php           | 10 ++++----
 api/v3/Premium.php                 |  2 +-
 api/v3/PriceField.php              |  6 ++---
 api/v3/PriceFieldValue.php         |  6 ++---
 api/v3/PriceSet.php                |  6 ++---
 api/v3/PrintLabel.php              |  2 +-
 api/v3/Product.php                 |  2 +-
 api/v3/Profile.php                 |  4 +---
 api/v3/Relationship.php            |  4 +---
 api/v3/RelationshipType.php        |  5 +---
 api/v3/ReportInstance.php          | 32 ++++++++++++++++++++++++++
 api/v3/ReportTemplate.php          | 32 ++++++++++++++++++++++++++
 api/v3/Setting.php                 |  4 +---
 api/v3/SmsProvider.php             |  2 +-
 api/v3/Survey.php                  |  6 ++---
 api/v3/SurveyRespondant.php        |  2 +-
 api/v3/System.php                  |  8 +++----
 api/v3/SystemLog.php               |  4 +---
 api/v3/Tag.php                     |  4 +---
 api/v3/UFField.php                 |  4 +---
 api/v3/UFGroup.php                 |  4 +---
 api/v3/UFJoin.php                  |  4 +---
 api/v3/UFMatch.php                 |  4 +---
 api/v3/Website.php                 |  4 +---
 api/v3/WordReplacement.php         |  4 +---
 api/v3/utils.php                   |  2 --
 101 files changed, 310 insertions(+), 316 deletions(-)

diff --git a/api/v3/Acl.php b/api/v3/Acl.php
index 5e6018b72e..d1ee882ee9 100644
--- a/api/v3/Acl.php
+++ b/api/v3/Acl.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 acl functions
+ * This api exposes CiviCRM acl.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_acl
diff --git a/api/v3/AclRole.php b/api/v3/AclRole.php
index 31775ea8c0..33d6c6fcaa 100644
--- a/api/v3/AclRole.php
+++ b/api/v3/AclRole.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 acl_role functions
+ * This api exposes CiviCRM acl_role.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_acl_role
diff --git a/api/v3/ActionSchedule.php b/api/v3/ActionSchedule.php
index ed0c42605c..946318deb4 100644
--- a/api/v3/ActionSchedule.php
+++ b/api/v3/ActionSchedule.php
@@ -31,7 +31,6 @@
  * @package CiviCRM_APIv3
  * @subpackage API_ActionSchedule
  *
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
diff --git a/api/v3/Activity.php b/api/v3/Activity.php
index d140f2d94a..f4521ea219 100644
--- a/api/v3/Activity.php
+++ b/api/v3/Activity.php
@@ -1,6 +1,4 @@
 <?php
-// $Id$
-
 /*
  +--------------------------------------------------------------------+
  | CiviCRM version 4.6                                                |
@@ -28,12 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 activity functions
+ * This api exposes CiviCRM activity.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Activity
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Activity.php 30486 2010-11-02 16:12:09Z shot $
  */
 
 
@@ -41,7 +37,7 @@
  * Creates or updates an Activity.
  *
  * @param array $params
- *  Array per getfields documentation.
+ *   Array per getfields documentation.
  *
  * @throws API_Exception
  * @return array
@@ -181,7 +177,7 @@ function civicrm_api3_activity_create($params) {
  * ensuring mandatory requirements are met.
  *
  * @param array $params
- *  Array of parameters determined by getfields.
+ *   Array of parameters determined by getfields.
  */
 function _civicrm_api3_activity_create_spec(&$params) {
 
diff --git a/api/v3/ActivityContact.php b/api/v3/ActivityContact.php
index d9220ac8ca..fc873f43d8 100644
--- a/api/v3/ActivityContact.php
+++ b/api/v3/ActivityContact.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 activity contact functions
+ * This api exposes CiviCRM activity contact.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_ActivityContact
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: ActivityContact.php 2014-04-01 elcapo $
  */
 
 /**
diff --git a/api/v3/ActivityType.php b/api/v3/ActivityType.php
index 5affa0690c..627cfd419e 100644
--- a/api/v3/ActivityType.php
+++ b/api/v3/ActivityType.php
@@ -26,13 +26,12 @@
  */
 
 /**
+ * The activity_type api is deprecated. Please use the option_value api instead.
+ *
  * @deprecated
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Activity
- *
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id: ActivityType.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/Address.php b/api/v3/Address.php
index 472e85fc0b..0e554efedf 100644
--- a/api/v3/Address.php
+++ b/api/v3/Address.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 address functions
+ * This api exposes CiviCRM address.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Address
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Address.php 2011-02-16 ErikHommel $
  */
 
 /**
diff --git a/api/v3/Attachment.php b/api/v3/Attachment.php
index 2924813cc2..078d0fada8 100644
--- a/api/v3/Attachment.php
+++ b/api/v3/Attachment.php
@@ -80,8 +80,6 @@
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Attachment
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id: $
  */
 
 /**
diff --git a/api/v3/Batch.php b/api/v3/Batch.php
index d9524ffc51..84ab4051db 100644
--- a/api/v3/Batch.php
+++ b/api/v3/Batch.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 batch functions
+ * This api exposes CiviCRM batch.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Batch
diff --git a/api/v3/Campaign.php b/api/v3/Campaign.php
index e33b2edc75..96260393ad 100644
--- a/api/v3/Campaign.php
+++ b/api/v3/Campaign.php
@@ -26,11 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM campaign.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Campaign
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
diff --git a/api/v3/Case.php b/api/v3/Case.php
index 5454994394..4d756e9265 100644
--- a/api/v3/Case.php
+++ b/api/v3/Case.php
@@ -26,12 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 Case functions
+ * This api exposes CiviCRM Case.
  * Developed by woolman.org
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Case
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 
diff --git a/api/v3/CaseType.php b/api/v3/CaseType.php
index 90f8e1b7eb..74f5b4d2fe 100644
--- a/api/v3/CaseType.php
+++ b/api/v3/CaseType.php
@@ -26,12 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 Case functions
- * Developed by woolman.org
+ * This api exposes CiviCRM Case.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Case
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
diff --git a/api/v3/Constant.php b/api/v3/Constant.php
index 1b7363e4b0..d11571f745 100644
--- a/api/v3/Constant.php
+++ b/api/v3/Constant.php
@@ -29,10 +29,9 @@
  * CiviCRM APIv3 pseudoconstants
  *
  * @deprecated
+ *   The constant api is deprecated as of CiviCRM 4.4. Please use the getoptions api action instead.
  * @package CiviCRM_APIv3
  * @subpackage API_Constant
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Constant.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/Contact.php b/api/v3/Contact.php
index 5d97e5362a..acd04d03b3 100644
--- a/api/v3/Contact.php
+++ b/api/v3/Contact.php
@@ -26,18 +26,19 @@
  */
 
 /**
- * new version of civicrm apis. See blog post at
- * http://civicrm.org/node/131
- * @todo Write sth
+ * This api exposes CiviCRM contacts.
+ * Contacts are the main entity in CiviCRM and this api is more robust than most.
+ *   - Get action allows all params supported by advanced search.
+ *   - Create action allows creating several other entities at once (e.g. email).
+ *   - Create allows checking for duplicate contacts.
+ * Use getfields to list the full range of parameters and options supported by each action.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Contact
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id: Contact.php 30879 2010-11-22 15:45:55Z shot $
  */
 
 /**
- * Create or update a contact (note you should always call this via civicrm_api() & never directly).
+ * Create or update a contact.
  *
  * @param array $params
  *   Input parameters.
diff --git a/api/v3/ContactType.php b/api/v3/ContactType.php
index 116fd8f037..a14d833adb 100644
--- a/api/v3/ContactType.php
+++ b/api/v3/ContactType.php
@@ -26,11 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM contact type.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Survey
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
@@ -63,12 +62,11 @@ function civicrm_api3_contact_type_create($params) {
 }
 
 /**
- * Returns array of contact_types  matching a set of one or more group properties.
+ * Returns array of contact_types matching a set of one or more properties.
  *
  * @param array $params
- *   One or more valid.
- *                       property_name=>value pairs. If $params is set
- *                       as null, all contact_types will be returned
+ *   One or more valid property_name=>value pairs.
+ *   If $params is set as null, all contact_types will be returned
  *
  * @return array
  *   Array of matching contact_types
@@ -85,8 +83,7 @@ function civicrm_api3_contact_type_get($params) {
  * to be deleted is required field in $params array
  *
  * @param array $params
- *   Array containing id of the group.
- *                       to be deleted
+ *   [id]
  *
  * @return array
  *   API Result Array
diff --git a/api/v3/Contribution.php b/api/v3/Contribution.php
index 5c696661f5..3de323215a 100644
--- a/api/v3/Contribution.php
+++ b/api/v3/Contribution.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 Contribution functions
+ * This api exposes CiviCRM Contribution.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Contribute
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Contribution.php 30486 2010-11-02 16:12:09Z shot $
  */
 
 /**
diff --git a/api/v3/ContributionPage.php b/api/v3/ContributionPage.php
index 5c68330cb5..dd3f62571e 100644
--- a/api/v3/ContributionPage.php
+++ b/api/v3/ContributionPage.php
@@ -27,11 +27,10 @@
 
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM contribution pages.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_ContributionPage
- * @copyright CiviCRM LLC (c) 20042012
  */
 
 /**
diff --git a/api/v3/ContributionRecur.php b/api/v3/ContributionRecur.php
index 41e8bbaf06..fa1c6b8c49 100644
--- a/api/v3/ContributionRecur.php
+++ b/api/v3/ContributionRecur.php
@@ -26,11 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM recurring contributions.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_ContributionRecur
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
@@ -97,8 +96,7 @@ function civicrm_api3_contribution_recur_cancel($params) {
  * to be deleted is required field in $params array
  *
  * @param array $params
- *   Array containing id of the group.
- *                       to be deleted
+ *   [id]
  *
  * @return array
  *   API result array
diff --git a/api/v3/ContributionSoft.php b/api/v3/ContributionSoft.php
index 8d6187cf7c..a54e364942 100644
--- a/api/v3/ContributionSoft.php
+++ b/api/v3/ContributionSoft.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 soft credit functions.
+ * This api exposes CiviCRM soft credit.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_ContributionSoft
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: ContributionSoft.php 2013-05-01 Jon Goldberg $
  */
 
 /**
diff --git a/api/v3/Country.php b/api/v3/Country.php
index 5683691ebf..649d679feb 100644
--- a/api/v3/Country.php
+++ b/api/v3/Country.php
@@ -1,6 +1,4 @@
 <?php
-// $Id$
-
 /*
  +--------------------------------------------------------------------+
  | CiviCRM version 4.6                                                |
@@ -28,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 country functions
+ * This api exposes CiviCRM country.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Country
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Country.php 2011-02-16 ErikHommel $
  */
 
 /**
diff --git a/api/v3/CustomField.php b/api/v3/CustomField.php
index bfcf45e4cd..5adbbef484 100644
--- a/api/v3/CustomField.php
+++ b/api/v3/CustomField.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 custom group functions
+ * This api exposes CiviCRM custom field.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_CustomField
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: CustomField.php 30879 2010-11-22 15:45:55Z shot $
  */
 
 /**
@@ -94,7 +92,7 @@ function _civicrm_api3_custom_field_create_spec(&$params) {
 }
 
 /**
- * Use this API to delete an existing custom group field.
+ * Use this API to delete an existing custom field.
  *
  * @param array $params
  *   Array id of the field to be deleted.
diff --git a/api/v3/CustomGroup.php b/api/v3/CustomGroup.php
index dbe0bfb4cd..440850ba97 100644
--- a/api/v3/CustomGroup.php
+++ b/api/v3/CustomGroup.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 custom group functions
+ * This api exposes CiviCRM custom group.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_CustomGroup
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: CustomGroup.php 30879 2010-11-22 15:45:55Z shot $
  */
 
 /**
diff --git a/api/v3/CustomSearch.php b/api/v3/CustomSearch.php
index 3f34e85474..f54f04f474 100644
--- a/api/v3/CustomSearch.php
+++ b/api/v3/CustomSearch.php
@@ -1,4 +1,37 @@
 <?php
+/*
+ +--------------------------------------------------------------------+
+ | CiviCRM version 4.6                                                |
+ +--------------------------------------------------------------------+
+ | Copyright CiviCRM LLC (c) 2004-2014                                |
+ +--------------------------------------------------------------------+
+ | This file is a part of CiviCRM.                                    |
+ |                                                                    |
+ | CiviCRM is free software; you can copy, modify, and distribute it  |
+ | under the terms of the GNU Affero General Public License           |
+ | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
+ |                                                                    |
+ | CiviCRM is distributed in the hope that it will be useful, but     |
+ | WITHOUT ANY WARRANTY; without even the implied warranty of         |
+ | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
+ | See the GNU Affero General Public License for more details.        |
+ |                                                                    |
+ | You should have received a copy of the GNU Affero General Public   |
+ | License and the CiviCRM Licensing Exception along                  |
+ | with this program; if not, contact CiviCRM LLC                     |
+ | at info[AT]civicrm[DOT]org. If you have questions about the        |
+ | GNU Affero General Public License or the licensing of CiviCRM,     |
+ | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
+ +--------------------------------------------------------------------+
+ */
+
+/**
+ * This api exposes CiviCRM custom search.
+ *
+ * @package CiviCRM_APIv3
+ * @subpackage API_CustomSearch
+ *
+ */
 
 /**
  * Retrieve custom searches.
diff --git a/api/v3/CustomValue.php b/api/v3/CustomValue.php
index 748bbde23b..0e6912c3b7 100644
--- a/api/v3/CustomValue.php
+++ b/api/v3/CustomValue.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 custom value functions
+ * This api exposes CiviCRM custom value.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_CustomField
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: CustomField.php 30879 2010-11-22 15:45:55Z shot $
  */
 
 
@@ -42,7 +40,8 @@
  * @param array $params
  *   Expected keys are in format custom_fieldID:recordID or custom_groupName:fieldName:recordID.
  *
- * @example
+ * @example:
+ * @code
  *   // entity ID. You do not need to specify entity type, we figure it out based on the fields you're using
  *   'entity_id' => 123,
  *   // (omitting :id) inserts or updates a field in a single-valued group
@@ -56,10 +55,10 @@
  *   // inserts another new record in multi-valued group
  *   'custom_33:-2' => value,
  *   // you can use group_name:field_name instead of ID
- *   'custom_some_group:my_field => 'myinfo',
+ *   'custom_some_group:my_field' => 'myinfo',
  *   // updates record ID 8 in my_other_field in multi-valued some_big_group
- *   'custom_some_big_group:my_other_field:8 => 'myinfo',
- *
+ *   'custom_some_big_group:my_other_field:8' => 'myinfo',
+ * @endcode
  *
  * @throws Exception
  * @return array
diff --git a/api/v3/Dashboard.php b/api/v3/Dashboard.php
index 706d28e77f..08dbfa2c8c 100644
--- a/api/v3/Dashboard.php
+++ b/api/v3/Dashboard.php
@@ -1,6 +1,4 @@
 <?php
-// $Id$
-
 /*
  +--------------------------------------------------------------------+
  | CiviCRM version 4.6                                                |
@@ -28,12 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 Dashboard functions
+ * This api exposes CiviCRM Dashboard.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Activity
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Activity.php 30486 2010-11-02 16:12:09Z shot $
  */
 
 
diff --git a/api/v3/DashboardContact.php b/api/v3/DashboardContact.php
index 294930046b..f66fcac802 100644
--- a/api/v3/DashboardContact.php
+++ b/api/v3/DashboardContact.php
@@ -26,12 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 for Dashboard Contact
+ * This api exposes CiviCRM dashboard contacts.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_ActionSchedule
  *
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
diff --git a/api/v3/Domain.php b/api/v3/Domain.php
index 950dcb4d4f..bd2e75083a 100644
--- a/api/v3/Domain.php
+++ b/api/v3/Domain.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 domain functions
+ * This api exposes CiviCRM domain.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Domain
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Domain.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/Email.php b/api/v3/Email.php
index ff2ae35a27..c47b6a0694 100644
--- a/api/v3/Email.php
+++ b/api/v3/Email.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 email functions
+ * This api exposes CiviCRM email.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Email
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Email.php 2011-02-16 ErikHommel $
  */
 
 /**
diff --git a/api/v3/Entity.php b/api/v3/Entity.php
index ff3bb42511..03453eb835 100644
--- a/api/v3/Entity.php
+++ b/api/v3/Entity.php
@@ -3,8 +3,6 @@
 /**
  * Get list of deprecated entities.
  *
- * @deprecated api notice
- *
  * @param array $entities
  *
  * @return array
diff --git a/api/v3/EntityTag.php b/api/v3/EntityTag.php
index 41ac2e108f..9e1255b47a 100644
--- a/api/v3/EntityTag.php
+++ b/api/v3/EntityTag.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 entity tag functions
+ * This api exposes CiviCRM entity tag.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_EntityTag
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: EntityTag.php 30879 2010-11-22 15:45:55Z shot $
  */
 
 /**
diff --git a/api/v3/Event.php b/api/v3/Event.php
index ae02240f4a..1c20472bb3 100644
--- a/api/v3/Event.php
+++ b/api/v3/Event.php
@@ -27,13 +27,11 @@
 
 /**
  *
- * File for the CiviCRM APIv3 event functions
+ * This api exposes CiviCRM event.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Event
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Event.php 30964 2010-11-29 09:41:54Z shot $
  */
 
 /**
diff --git a/api/v3/Extension.php b/api/v3/Extension.php
index 2bbd45af13..79649f3645 100644
--- a/api/v3/Extension.php
+++ b/api/v3/Extension.php
@@ -29,13 +29,11 @@ define('API_V3_EXTENSION_DELIMITER', ',');
 
 
 /**
- * File for the CiviCRM APIv3 extension functions
+ * This api exposes CiviCRM extension.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Extension
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id$
  */
 
 /**
@@ -43,9 +41,9 @@ define('API_V3_EXTENSION_DELIMITER', ',');
  *
  * @param array $params
  *   Input parameters.
- *                          - key: string, eg "com.example.myextension"
- *                          - keys: mixed; array of string, eg array("com.example.myextension1", "com.example.myextension2") or string with comma-delimited list
- *                            using 'keys' should be more performant than making multiple API calls with 'key'
+ *   - key: string, eg "com.example.myextension"
+ *   - keys: mixed; array of string, eg array("com.example.myextension1", "com.example.myextension2") or string with comma-delimited list
+ *   Using 'keys' should be more performant than making multiple API calls with 'key'.
  *
  * @return array
  *   API result
diff --git a/api/v3/File.php b/api/v3/File.php
index 682775b1e7..b3f3476114 100644
--- a/api/v3/File.php
+++ b/api/v3/File.php
@@ -26,20 +26,19 @@
  */
 
 /**
+ * This api allows minimal handling with the CiviCRM file DAO.
+ * Creating and updating files is a complex process and this api is usually insufficient.
+ * Use the "Attachment" api instead for more robust file handling.
  *
- * Definition of the Tag of the CRM API.
- * More detailed documentation can be found
- * {@link http://objectledge.org/confluence/display/CRM/CRM+v1.0+Public+APIs
- * here}
- *
+ * @fixme no unit tests
  * @package CiviCRM_APIv3
  * @subpackage API_File
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id: $
  */
 
 /**
- * Create a file.
+ * Create a file record.
+ * Note: This is only one of several steps needed to create a file in CiviCRM.
+ * Use the "Attachment" api to better handle all steps.
  *
  * @param array $params
  *   Array per getfields metadata.
diff --git a/api/v3/FinancialAccount.php b/api/v3/FinancialAccount.php
index 96c708efbd..0e46b887d6 100644
--- a/api/v3/FinancialAccount.php
+++ b/api/v3/FinancialAccount.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 financial_account functions
+ * This api exposes CiviCRM financial_account.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_financial_account
diff --git a/api/v3/FinancialType.php b/api/v3/FinancialType.php
index 1af8001aaf..571e1c9759 100644
--- a/api/v3/FinancialType.php
+++ b/api/v3/FinancialType.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 financial_type functions
+ * This api exposes CiviCRM financial_type.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_financial_type
diff --git a/api/v3/Generic/Update.php b/api/v3/Generic/Update.php
index 3ccfece1ec..f8720865df 100644
--- a/api/v3/Generic/Update.php
+++ b/api/v3/Generic/Update.php
@@ -36,6 +36,8 @@
  * To do this, perform a 'get' action to load the existing values, then merge in the updates
  * and call 'create' to save the revised entity.
  *
+ * @deprecated
+ *
  * @param array $apiRequest
  *   Array with keys:
  *   - entity: string
diff --git a/api/v3/Grant.php b/api/v3/Grant.php
index 0d7520dc51..6ab0ce55c2 100644
--- a/api/v3/Grant.php
+++ b/api/v3/Grant.php
@@ -26,11 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM grant.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Grant
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
@@ -60,7 +59,7 @@ function _civicrm_api3_grant_create_spec(&$params) {
 }
 
 /**
- * Returns array of grants matching a set of one or more group properties.
+ * Returns array of grants matching a set of one or more properties.
  *
  * @param array $params
  *   Array per getfields metadata.
@@ -75,7 +74,7 @@ function civicrm_api3_grant_get($params) {
 /**
  * Delete an existing grant.
  *
- * This method is used to delete any existing grant. id of the group
+ * This method is used to delete any existing grant. id of the grant
  * to be deleted is required field in $params array
  *
  * @param array $params
diff --git a/api/v3/Group.php b/api/v3/Group.php
index 0bbc164041..c16cdc0247 100644
--- a/api/v3/Group.php
+++ b/api/v3/Group.php
@@ -26,20 +26,17 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM group.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Group
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Group.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
  * Create/update group.
  *
  * @param array $params
- *   Associative array of property.
- *                       name/value pairs to insert in new 'group'
+ *   name/value pairs to insert in new 'group'
  *
  * @return array
  *   API result array
@@ -89,8 +86,7 @@ function civicrm_api3_group_get($params) {
  * Delete an existing group.
  *
  * @param array $params
- *   Array containing id of the group.
- *                       to be deleted
+ *   [id]
  *
  * @return array
  *   API result array
diff --git a/api/v3/GroupContact.php b/api/v3/GroupContact.php
index 2fcd3400af..0a778333be 100644
--- a/api/v3/GroupContact.php
+++ b/api/v3/GroupContact.php
@@ -1,6 +1,4 @@
 <?php
-// $Id$
-
 /*
  +--------------------------------------------------------------------+
  | CiviCRM version 4.6                                                |
@@ -28,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group contact functions
+ * This api exposes CiviCRM group contact.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Group
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: GroupContact.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 
diff --git a/api/v3/GroupNesting.php b/api/v3/GroupNesting.php
index 9897ea4699..ec537581f0 100644
--- a/api/v3/GroupNesting.php
+++ b/api/v3/GroupNesting.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group nesting functions
+ * This api exposes CiviCRM group nesting.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Group
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: GroupNesting.php 21624 2009-08-07 22:02:55Z wmorgan $
  */
 
 /**
diff --git a/api/v3/GroupOrganization.php b/api/v3/GroupOrganization.php
index 451eefe300..8f8800ff92 100644
--- a/api/v3/GroupOrganization.php
+++ b/api/v3/GroupOrganization.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group contact functions
+ * This api exposes the relationships between organizations and CiviCRM groups.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Group
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: GroupContact.php 21624 2009-06-04 22:02:55Z mover $
  */
 
 
diff --git a/api/v3/Im.php b/api/v3/Im.php
index cf564f91f9..33aac88a6a 100644
--- a/api/v3/Im.php
+++ b/api/v3/Im.php
@@ -26,12 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 IM functions
+ * This api exposes CiviCRM IM.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_IM
  *
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
diff --git a/api/v3/Job.php b/api/v3/Job.php
index b12d4ae515..178d3c34e5 100644
--- a/api/v3/Job.php
+++ b/api/v3/Job.php
@@ -1,6 +1,4 @@
 <?php
-// $Id$
-
 /*
  +--------------------------------------------------------------------+
  | CiviCRM version 4.6                                                |
@@ -28,13 +26,10 @@
  */
 
 /**
- * new version of civicrm APIs. See blog post at
- * http://civicrm.org/node/131
+ * This api is used for triggering scheduled "cron" jobs.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Job
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id: Contact.php 30879 2010-11-22 15:45:55Z shot $
  */
 
 /**
diff --git a/api/v3/LineItem.php b/api/v3/LineItem.php
index c44c4e1ab5..cf76affa90 100644
--- a/api/v3/LineItem.php
+++ b/api/v3/LineItem.php
@@ -27,11 +27,10 @@
 
 
 /**
- * File for the CiviCRM APIv3 line item functions
+ * This api exposes CiviCRM line item.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_LineItem
- * @copyright CiviCRM LLC (c) 20042012
  */
 
 /**
diff --git a/api/v3/LocBlock.php b/api/v3/LocBlock.php
index fb7c5c1d48..456b0826f0 100644
--- a/api/v3/LocBlock.php
+++ b/api/v3/LocBlock.php
@@ -27,19 +27,17 @@
 
 
 /**
- * File for the CiviCRM APIv3 loc_block functions
+ * This api exposes CiviCRM loc_block.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_LocBlock
- * @copyright CiviCRM LLC (c) 20042012
  */
 
 /**
  * Create or update a loc_block.
  *
  * @param array $params
- *   Associative array of property.
- *                       name/value pairs to insert in new 'loc_block'
+ *   name/value pairs to insert in new 'loc_block'
  *
  * @return array
  *   API result array.
diff --git a/api/v3/LocationType.php b/api/v3/LocationType.php
index a2f466e93a..d64ab8a171 100644
--- a/api/v3/LocationType.php
+++ b/api/v3/LocationType.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 location type functions
+ * This api exposes CiviCRM location type.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_LocationType
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: LocationType.php 2012-11-02 Jon Goldberg $
  */
 
 /**
diff --git a/api/v3/MailSettings.php b/api/v3/MailSettings.php
index 37d46c697b..88f39c1e74 100644
--- a/api/v3/MailSettings.php
+++ b/api/v3/MailSettings.php
@@ -26,19 +26,17 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM mail settings.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_mail_settings
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
  * Create or update a mail_settings.
  *
  * @param array $params
- *   Array of property.
- *                       name/value pairs to insert in new 'mail_settings'
+ *   name/value pairs to insert in new 'mail_settings'
  *
  * @return array
  *   API result array.
@@ -63,9 +61,8 @@ function _civicrm_api3_mail_settings_create_spec(&$params) {
  * Returns array of mail_settings  matching a set of one or more group properties.
  *
  * @param array $params
- *   Array of one or more valid.
- *                       property_name=>value pairs. If $params is set
- *                       as null, all mail_settings will be returned
+ *   Array of one or more property_name=>value pairs.
+ *   If $params is set as null, all mail_settings will be returned
  *
  * @return array
  *   API result array.
@@ -78,8 +75,7 @@ function civicrm_api3_mail_settings_get($params) {
  * Delete an existing mail_settings.
  *
  * @param array $params
- *   Array containing id of the group.
- *                       to be deleted
+ *   [id]
  *
  * @return array
  *   API result array.
diff --git a/api/v3/Mailing.php b/api/v3/Mailing.php
index 7e36d2a7cb..c0ca279948 100755
--- a/api/v3/Mailing.php
+++ b/api/v3/Mailing.php
@@ -31,8 +31,6 @@
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Mailing
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
diff --git a/api/v3/MailingAB.php b/api/v3/MailingAB.php
index 8685246a11..8b73975ebb 100755
--- a/api/v3/MailingAB.php
+++ b/api/v3/MailingAB.php
@@ -31,8 +31,6 @@
  *
  * @package CiviCRM_APIv3
  * @subpackage API_MailingAB
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
diff --git a/api/v3/MailingComponent.php b/api/v3/MailingComponent.php
index 6e8744a477..93bfddab0e 100644
--- a/api/v3/MailingComponent.php
+++ b/api/v3/MailingComponent.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 mailing_component functions
+ * This api exposes CiviCRM mailing_component.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_mailing_component
diff --git a/api/v3/MailingContact.php b/api/v3/MailingContact.php
index cc8d00841d..dd7fe72a94 100644
--- a/api/v3/MailingContact.php
+++ b/api/v3/MailingContact.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 contact and mailing functions
+ * This api exposes CiviCRM contact and mailing.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_MailingContact
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id$
  */
 
 /**
diff --git a/api/v3/MailingEventConfirm.php b/api/v3/MailingEventConfirm.php
index 039741a2fe..9864bb9cd1 100644
--- a/api/v3/MailingEventConfirm.php
+++ b/api/v3/MailingEventConfirm.php
@@ -31,16 +31,13 @@
  *
  * @package CiviCRM_APIv3
  * @subpackage API_MailerGroup
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
  * Handle a confirm event.
  *
  * @param array $params
- *   Associative array of property.
- *                       name/value pairs to insert in new 'survey'
+ *   name/value pairs to insert in new 'survey'
  *
  * @throws Exception
  * @return array
diff --git a/api/v3/MailingEventQueue.php b/api/v3/MailingEventQueue.php
index ac3bb377fe..6e15045df8 100644
--- a/api/v3/MailingEventQueue.php
+++ b/api/v3/MailingEventQueue.php
@@ -30,8 +30,6 @@
  *
  * @package CiviCRM_APIv3
  * @subpackage API_MailerGroup
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
diff --git a/api/v3/MailingEventResubscribe.php b/api/v3/MailingEventResubscribe.php
index a8e06ba0b9..64a3659db6 100644
--- a/api/v3/MailingEventResubscribe.php
+++ b/api/v3/MailingEventResubscribe.php
@@ -31,8 +31,6 @@
  *
  * @package CiviCRM_APIv3
  * @subpackage API_MailerGroup
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
diff --git a/api/v3/MailingEventSubscribe.php b/api/v3/MailingEventSubscribe.php
index ea3c57326d..564ecb3376 100644
--- a/api/v3/MailingEventSubscribe.php
+++ b/api/v3/MailingEventSubscribe.php
@@ -31,8 +31,6 @@
  *
  * @package CiviCRM_APIv3
  * @subpackage API_MailerGroup
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
diff --git a/api/v3/MailingEventUnsubscribe.php b/api/v3/MailingEventUnsubscribe.php
index 2a0172f0ef..f6667587e5 100644
--- a/api/v3/MailingEventUnsubscribe.php
+++ b/api/v3/MailingEventUnsubscribe.php
@@ -31,8 +31,6 @@
  *
  * @package CiviCRM_APIv3
  * @subpackage API_MailerGroup
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
diff --git a/api/v3/MailingGroup.php b/api/v3/MailingGroup.php
index 51f64bb4ae..beb3f1374b 100644
--- a/api/v3/MailingGroup.php
+++ b/api/v3/MailingGroup.php
@@ -26,13 +26,11 @@
  */
 
 /**
- *
  * APIv3 functions for registering/processing mailing group events.
  *
+ * @deprecated
  * @package CiviCRM_APIv3
  * @subpackage API_MailerGroup
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
diff --git a/api/v3/MailingJob.php b/api/v3/MailingJob.php
index a8604a3efb..649c311387 100644
--- a/api/v3/MailingJob.php
+++ b/api/v3/MailingJob.php
@@ -27,12 +27,10 @@
 
 /**
  *
- * APIv3 functions for registering/processing mailing events.
+ * APIv3 functions for registering/processing mailing jobs.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Mailing
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 /**
@@ -65,7 +63,6 @@ function _civicrm_api3_mailing_job_create_spec(&$params) {
  * Returns array of Mailing Jobs matching a set of one or more group properties.
  *
  * @param array $params
- *   Array of one or more valid.
  *
  * @return array
  *   API return Array of matching mailing jobs.
diff --git a/api/v3/MailingRecipients.php b/api/v3/MailingRecipients.php
index f745f20388..6b39269b05 100644
--- a/api/v3/MailingRecipients.php
+++ b/api/v3/MailingRecipients.php
@@ -26,13 +26,10 @@
  */
 
 /**
- *
- * APIv3 functions for registering/processing mailing events.
+ * APIv3 functions for registering/processing mailing recipients.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Mailing
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id$
  */
 
 
diff --git a/api/v3/Membership.php b/api/v3/Membership.php
index 9e99405acd..3951239c31 100644
--- a/api/v3/Membership.php
+++ b/api/v3/Membership.php
@@ -27,13 +27,11 @@
 
 /**
  *
- * File for the CiviCRM APIv3 membership contact functions
+ * This api exposes CiviCRM membership contact.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Membership
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: MembershipContact.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/MembershipBlock.php b/api/v3/MembershipBlock.php
index a5d200512d..77cade9fdf 100644
--- a/api/v3/MembershipBlock.php
+++ b/api/v3/MembershipBlock.php
@@ -26,23 +26,21 @@
  */
 
 /**
- * File for the CiviCRM APIv3 membership type functions
+ * This api exposes CiviCRM membership block.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Membership
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: MembershipBlock.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
- * API to Create or update a Membership Type.
+ * API to Create or update a Membership Block.
  *
  * @param array $params
  *   An associative array of name/value property values of civicrm_membership_block.
  *
  * @return array
- *   newly created or updated membership type property values.
+ *   newly created or updated membership block property values.
  */
 function civicrm_api3_membership_block_create($params) {
   return _civicrm_api3_basic_create(_civicrm_api3_get_BAO(__FUNCTION__), $params);
@@ -63,9 +61,9 @@ function _civicrm_api3_membership_block_create_spec(&$params) {
 }
 
 /**
- * Get a Membership Type.
+ * Get a Membership Block.
  *
- * This api is used for finding an existing membership type.
+ * This api is used for finding an existing membership block.
  *
  * @param array $params
  *   An associative array of name/value property values of civicrm_membership_block.
@@ -79,10 +77,10 @@ function civicrm_api3_membership_block_get($params) {
 }
 
 /**
- * Deletes an existing membership type.
+ * Deletes an existing membership block.
  *
- * This API is used for deleting a membership type
- * Required parameters : id of a membership type
+ * This API is used for deleting a membership block
+ * Required parameters : id of a membership block
  *
  * @param array $params
  *
diff --git a/api/v3/MembershipPayment.php b/api/v3/MembershipPayment.php
index 2f2e8c0f94..3eb49d0421 100644
--- a/api/v3/MembershipPayment.php
+++ b/api/v3/MembershipPayment.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 membership contribution link functions
+ * This api exposes CiviCRM membership contribution link.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Membership
  * @todo delete function doesn't exist
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: MembershipContributionLink.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/MembershipStatus.php b/api/v3/MembershipStatus.php
index 3e8a7d2e7d..42c5172d44 100644
--- a/api/v3/MembershipStatus.php
+++ b/api/v3/MembershipStatus.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 membership status functions
+ * This api exposes CiviCRM membership status.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Membership
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: MembershipStatus.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/MembershipType.php b/api/v3/MembershipType.php
index e5f102197f..5442b5610c 100644
--- a/api/v3/MembershipType.php
+++ b/api/v3/MembershipType.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 membership type functions
+ * This api exposes CiviCRM membership type.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Membership
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: MembershipType.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/MessageTemplate.php b/api/v3/MessageTemplate.php
index 1a330542c6..26c4805fcb 100644
--- a/api/v3/MessageTemplate.php
+++ b/api/v3/MessageTemplate.php
@@ -25,7 +25,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 message_template functions
+ * This api exposes CiviCRM message_template.
  *
  * @package CiviCRM_SEPA
  */
diff --git a/api/v3/Note.php b/api/v3/Note.php
index 0322f11079..86fe2ee0bc 100644
--- a/api/v3/Note.php
+++ b/api/v3/Note.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 note functions
+ * This api exposes CiviCRM note.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Note
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Note.php 30879 2010-11-22 15:45:55Z shot $
  */
 
 /**
diff --git a/api/v3/OptionGroup.php b/api/v3/OptionGroup.php
index d3a5f495bd..c65ffee5e3 100644
--- a/api/v3/OptionGroup.php
+++ b/api/v3/OptionGroup.php
@@ -1,4 +1,38 @@
 <?php
+/*
+ +--------------------------------------------------------------------+
+ | CiviCRM version 4.6                                                |
+ +--------------------------------------------------------------------+
+ | Copyright CiviCRM LLC (c) 2004-2014                                |
+ +--------------------------------------------------------------------+
+ | This file is a part of CiviCRM.                                    |
+ |                                                                    |
+ | CiviCRM is free software; you can copy, modify, and distribute it  |
+ | under the terms of the GNU Affero General Public License           |
+ | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
+ |                                                                    |
+ | CiviCRM is distributed in the hope that it will be useful, but     |
+ | WITHOUT ANY WARRANTY; without even the implied warranty of         |
+ | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
+ | See the GNU Affero General Public License for more details.        |
+ |                                                                    |
+ | You should have received a copy of the GNU Affero General Public   |
+ | License and the CiviCRM Licensing Exception along                  |
+ | with this program; if not, contact CiviCRM LLC                     |
+ | at info[AT]civicrm[DOT]org. If you have questions about the        |
+ | GNU Affero General Public License or the licensing of CiviCRM,     |
+ | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
+ +--------------------------------------------------------------------+
+ */
+
+/**
+ * This api exposes CiviCRM option groups.
+ * Each group contains option values.
+ *
+ * @package CiviCRM_APIv3
+ * @subpackage API_OptionValue
+ *
+ */
 
 /**
  * Get option groups.
@@ -42,8 +76,7 @@ function _civicrm_api3_option_group_create_spec(&$params) {
  * to be deleted is required field in $params array
  *
  * @param array $params
- *   Array containing id of the group.
- *                       to be deleted
+ *   [id]
  *
  * @return array
  *   API Result Array
diff --git a/api/v3/OptionValue.php b/api/v3/OptionValue.php
index 785ec02241..37977cf046 100644
--- a/api/v3/OptionValue.php
+++ b/api/v3/OptionValue.php
@@ -1,4 +1,38 @@
 <?php
+/*
+ +--------------------------------------------------------------------+
+ | CiviCRM version 4.6                                                |
+ +--------------------------------------------------------------------+
+ | Copyright CiviCRM LLC (c) 2004-2014                                |
+ +--------------------------------------------------------------------+
+ | This file is a part of CiviCRM.                                    |
+ |                                                                    |
+ | CiviCRM is free software; you can copy, modify, and distribute it  |
+ | under the terms of the GNU Affero General Public License           |
+ | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
+ |                                                                    |
+ | CiviCRM is distributed in the hope that it will be useful, but     |
+ | WITHOUT ANY WARRANTY; without even the implied warranty of         |
+ | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
+ | See the GNU Affero General Public License for more details.        |
+ |                                                                    |
+ | You should have received a copy of the GNU Affero General Public   |
+ | License and the CiviCRM Licensing Exception along                  |
+ | with this program; if not, contact CiviCRM LLC                     |
+ | at info[AT]civicrm[DOT]org. If you have questions about the        |
+ | GNU Affero General Public License or the licensing of CiviCRM,     |
+ | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
+ +--------------------------------------------------------------------+
+ */
+
+/**
+ * This api exposes CiviCRM option values.
+ * Values are grouped by "OptionGroup"
+ *
+ * @package CiviCRM_APIv3
+ * @subpackage API_OptionValue
+ *
+ */
 
 /**
  * Retrieve one or more option values.
diff --git a/api/v3/Participant.php b/api/v3/Participant.php
index 5a5ec3bf07..3e84c789d0 100644
--- a/api/v3/Participant.php
+++ b/api/v3/Participant.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 participant functions
+ * This api exposes CiviCRM participant.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Participant
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Participant.php 30486 2010-11-02 16:12:09Z shot $
  */
 
 /**
diff --git a/api/v3/ParticipantPayment.php b/api/v3/ParticipantPayment.php
index 1720dfb132..70d2ac8e9c 100644
--- a/api/v3/ParticipantPayment.php
+++ b/api/v3/ParticipantPayment.php
@@ -26,20 +26,18 @@
  */
 
 /**
- * File for the CiviCRM APIv3 participant functions
+ * This api exposes CiviCRM participant payments.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Participant
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Participant.php 30486 2010-11-02 16:12:09Z shot $
  */
 
 /**
  * Create a Event Participant Payment.
  *
  * This API is used for creating a Participant Payment of Event.
- * Required parameters : participant_id, contribution_id.
+ * Required parameters: participant_id, contribution_id.
  *
  * @param array $params
  *   An associative array of name/value property values of civicrm_participant_payment.
diff --git a/api/v3/ParticipantStatusType.php b/api/v3/ParticipantStatusType.php
index f08ee8dd7d..8436457684 100644
--- a/api/v3/ParticipantStatusType.php
+++ b/api/v3/ParticipantStatusType.php
@@ -26,11 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM participant status options.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Event
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
@@ -41,8 +40,7 @@
  * be in $params array.
  *
  * @param array $params
- *   Array of property.
- *                       name/value pairs to insert in new 'participant_status'
+ *   name/value pairs to insert in new 'participant_status'
  *
  * @return array
  *   participant_status array
@@ -73,8 +71,7 @@ function civicrm_api3_participant_status_type_get($params) {
  * to be deleted is required field in $params array
  *
  * @param array $params
- *   Array containing id of the group.
- *                       to be deleted
+ *   [id]
  *
  * @return array
  *   api result array
diff --git a/api/v3/PaymentProcessor.php b/api/v3/PaymentProcessor.php
index 1ced6d606e..6ca6365098 100644
--- a/api/v3/PaymentProcessor.php
+++ b/api/v3/PaymentProcessor.php
@@ -26,12 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 PaymentProcessor functions
+ * This api exposes CiviCRM PaymentProcessor.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_PaymentProcessor
  *
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 /**
diff --git a/api/v3/PaymentProcessorType.php b/api/v3/PaymentProcessorType.php
index 5d671ebc66..34035ef1c4 100644
--- a/api/v3/PaymentProcessorType.php
+++ b/api/v3/PaymentProcessorType.php
@@ -26,13 +26,10 @@
  */
 
 /**
- * new version of civicrm apis. See blog post at
- * http://civicrm.org/node/131
+ * This api exposes CiviCRM payment processor types.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Contact
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id: PaymentProcessorType.php 30415 2010-10-29 12:02:47Z shot $
  */
 
 /**
diff --git a/api/v3/Phone.php b/api/v3/Phone.php
index 8e30768cf5..291b603c50 100644
--- a/api/v3/Phone.php
+++ b/api/v3/Phone.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 phone functions
+ * This api exposes CiviCRM phone.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Phone
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Phone.php 2011-03-16 ErikHommel $
  */
 
 /**
diff --git a/api/v3/Pledge.php b/api/v3/Pledge.php
index bee68ca562..5205c3f445 100644
--- a/api/v3/Pledge.php
+++ b/api/v3/Pledge.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 Pledge functions
+ * This api exposes CiviCRM Pledge.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Pledge
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Pledge.php
  */
 
 /**
diff --git a/api/v3/PledgePayment.php b/api/v3/PledgePayment.php
index e6c83db083..ffae5a08ae 100644
--- a/api/v3/PledgePayment.php
+++ b/api/v3/PledgePayment.php
@@ -26,21 +26,19 @@
  */
 
 /**
- * File for the CiviCRM APIv3 Pledge functions
+ * This api exposes CiviCRM Pledge payment.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Pledge_Payment
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: PledgePayment.php
  */
 
 /**
  * Add or update a pledge payment.
  *
- * Pledge Payment API doesn't actually add a pledge
- *  if the request is to 'create' and 'id' is not passed in
- * the oldest pledge with no associated contribution is updated
+ * Pledge Payment API doesn't actually add a pledge.
+ * If the request is to 'create' and 'id' is not passed in
+ * the oldest pledge with no associated contribution is updated.
  *
  * @todo possibly add ability to add payment if there are less payments than pledge installments
  * @todo possibly add ability to recalculate dates if the schedule is changed
diff --git a/api/v3/Premium.php b/api/v3/Premium.php
index 75d004343f..fdf91aa76d 100644
--- a/api/v3/Premium.php
+++ b/api/v3/Premium.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 premium functions
+ * This api exposes CiviCRM premium.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_premium
diff --git a/api/v3/PriceField.php b/api/v3/PriceField.php
index fd9d00e1f1..d6bd9e7d77 100644
--- a/api/v3/PriceField.php
+++ b/api/v3/PriceField.php
@@ -27,19 +27,17 @@
 
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM price set fields.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_PriceField
- * @copyright CiviCRM LLC (c) 20042012
  */
 
 /**
  * Create or update a price_field.
  *
  * @param array $params
- *   Associative array of property.
- *                       name/value pairs to insert in new 'price_field'
+ *   name/value pairs to insert in new 'price_field'
  *
  * @return array
  *   api result array
diff --git a/api/v3/PriceFieldValue.php b/api/v3/PriceFieldValue.php
index bdf219873e..9161af4870 100644
--- a/api/v3/PriceFieldValue.php
+++ b/api/v3/PriceFieldValue.php
@@ -27,19 +27,17 @@
 
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM price sets.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_PriceFieldValue
- * @copyright CiviCRM LLC (c) 20042012
  */
 
 /**
  * Create or update a price_field_value.
  *
  * @param array $params
- *   Array of property.
- *                       name/value pairs to insert in new 'price_field_value'
+ *   name/value pairs to insert in new 'price_field_value'
  *
  * @return array
  *   API result array.
diff --git a/api/v3/PriceSet.php b/api/v3/PriceSet.php
index 6a9d356b6f..be20e0557b 100644
--- a/api/v3/PriceSet.php
+++ b/api/v3/PriceSet.php
@@ -27,19 +27,17 @@
 
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM price sets.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_PriceSet
- * @copyright CiviCRM LLC (c) 20042012
  */
 
 /**
  * Create or update a price_set.
  *
  * @param array $params
- *   array of property.
- *                       name/value pairs to insert in new 'price_set'
+ *   name/value pairs to insert in new 'price_set'
  *
  * @return array
  *   api result array
diff --git a/api/v3/PrintLabel.php b/api/v3/PrintLabel.php
index 87a487ed68..c71d037fb7 100644
--- a/api/v3/PrintLabel.php
+++ b/api/v3/PrintLabel.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 print_label functions
+ * This api exposes CiviCRM print_label.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_print_label
diff --git a/api/v3/Product.php b/api/v3/Product.php
index 28006d0d22..47c7545e27 100644
--- a/api/v3/Product.php
+++ b/api/v3/Product.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 product functions
+ * This api exposes CiviCRM product.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_product
diff --git a/api/v3/Profile.php b/api/v3/Profile.php
index 82269c5d88..3532e5dbd0 100644
--- a/api/v3/Profile.php
+++ b/api/v3/Profile.php
@@ -26,12 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 activity profile functions
+ * This api exposes CiviCRM activity profile.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_ActivityProfile
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Profile.php 30486 2011-05-20 16:12:09Z rajan $
  */
 
 /**
diff --git a/api/v3/Relationship.php b/api/v3/Relationship.php
index 9e0456e176..f0b0437171 100644
--- a/api/v3/Relationship.php
+++ b/api/v3/Relationship.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 relationship functions
+ * This api exposes CiviCRM relationships.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Relationship
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Relationship.php 30486 2010-11-02 16:12:09Z shot $
  */
 
 /**
diff --git a/api/v3/RelationshipType.php b/api/v3/RelationshipType.php
index 799292f7ba..18afe90fbb 100644
--- a/api/v3/RelationshipType.php
+++ b/api/v3/RelationshipType.php
@@ -26,13 +26,10 @@
  */
 
 /**
- * new version of civicrm apis. See blog post at
- * http://civicrm.org/node/131
+ * This api exposes CiviCRM relationship types.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Contact
- * @copyright CiviCRM LLC (c) 2004-2014
- * $Id: Contact.php 30415 2010-10-29 12:02:47Z shot $
  */
 
 /**
diff --git a/api/v3/ReportInstance.php b/api/v3/ReportInstance.php
index ebf7a44c96..e13d66f4ee 100644
--- a/api/v3/ReportInstance.php
+++ b/api/v3/ReportInstance.php
@@ -1,4 +1,36 @@
 <?php
+/*
+ +--------------------------------------------------------------------+
+ | CiviCRM version 4.6                                                |
+ +--------------------------------------------------------------------+
+ | Copyright CiviCRM LLC (c) 2004-2014                                |
+ +--------------------------------------------------------------------+
+ | This file is a part of CiviCRM.                                    |
+ |                                                                    |
+ | CiviCRM is free software; you can copy, modify, and distribute it  |
+ | under the terms of the GNU Affero General Public License           |
+ | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
+ |                                                                    |
+ | CiviCRM is distributed in the hope that it will be useful, but     |
+ | WITHOUT ANY WARRANTY; without even the implied warranty of         |
+ | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
+ | See the GNU Affero General Public License for more details.        |
+ |                                                                    |
+ | You should have received a copy of the GNU Affero General Public   |
+ | License and the CiviCRM Licensing Exception along                  |
+ | with this program; if not, contact CiviCRM LLC                     |
+ | at info[AT]civicrm[DOT]org. If you have questions about the        |
+ | GNU Affero General Public License or the licensing of CiviCRM,     |
+ | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
+ +--------------------------------------------------------------------+
+ */
+
+/**
+ * This api exposes CiviCRM report instances.
+ *
+ * @package CiviCRM_APIv3_Core
+ * @subpackage API_Report
+ */
 
 /**
  * Retrieve a report instance.
diff --git a/api/v3/ReportTemplate.php b/api/v3/ReportTemplate.php
index 78707e8b35..0e85821ef6 100644
--- a/api/v3/ReportTemplate.php
+++ b/api/v3/ReportTemplate.php
@@ -1,4 +1,36 @@
 <?php
+/*
+ +--------------------------------------------------------------------+
+ | CiviCRM version 4.6                                                |
+ +--------------------------------------------------------------------+
+ | Copyright CiviCRM LLC (c) 2004-2014                                |
+ +--------------------------------------------------------------------+
+ | This file is a part of CiviCRM.                                    |
+ |                                                                    |
+ | CiviCRM is free software; you can copy, modify, and distribute it  |
+ | under the terms of the GNU Affero General Public License           |
+ | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
+ |                                                                    |
+ | CiviCRM is distributed in the hope that it will be useful, but     |
+ | WITHOUT ANY WARRANTY; without even the implied warranty of         |
+ | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
+ | See the GNU Affero General Public License for more details.        |
+ |                                                                    |
+ | You should have received a copy of the GNU Affero General Public   |
+ | License and the CiviCRM Licensing Exception along                  |
+ | with this program; if not, contact CiviCRM LLC                     |
+ | at info[AT]civicrm[DOT]org. If you have questions about the        |
+ | GNU Affero General Public License or the licensing of CiviCRM,     |
+ | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
+ +--------------------------------------------------------------------+
+ */
+
+/**
+ * This api exposes CiviCRM report templates.
+ *
+ * @package CiviCRM_APIv3_Core
+ * @subpackage API_Report
+ */
 
 /**
  * Retrieve a report template.
diff --git a/api/v3/Setting.php b/api/v3/Setting.php
index 7bf30316c5..a8343612a2 100644
--- a/api/v3/Setting.php
+++ b/api/v3/Setting.php
@@ -26,12 +26,10 @@
  */
 
 /**
- * File for CiviCRM APIv3 settings
+ * This api exposes CiviCRM configuration settings.
  *
  * @package CiviCRM_APIv3_Core
  * @subpackage API_Settings
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Settings.php
  */
 
 /**
diff --git a/api/v3/SmsProvider.php b/api/v3/SmsProvider.php
index 79840a91f7..95e4a96fc8 100644
--- a/api/v3/SmsProvider.php
+++ b/api/v3/SmsProvider.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 sms_provider functions
+ * This api exposes CiviCRM sms_provider.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_sms_provider
diff --git a/api/v3/Survey.php b/api/v3/Survey.php
index f270127a21..a6e1858e1f 100644
--- a/api/v3/Survey.php
+++ b/api/v3/Survey.php
@@ -26,11 +26,10 @@
  */
 
 /**
- * File for the CiviCRM APIv3 group functions
+ * This api exposes CiviCRM survey.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Survey
- * @copyright CiviCRM LLC (c) 2004-2014
  */
 
 
@@ -81,8 +80,7 @@ function civicrm_api3_survey_get($params) {
  * to be deleted is required field in $params array
  *
  * @param array $params
- *   Array containing id of the group.
- *                       to be deleted
+ *   [id]
  *
  * @return array
  *   api result array
diff --git a/api/v3/SurveyRespondant.php b/api/v3/SurveyRespondant.php
index 82bc9d1bd0..f6bdd31e49 100644
--- a/api/v3/SurveyRespondant.php
+++ b/api/v3/SurveyRespondant.php
@@ -26,7 +26,7 @@
  */
 
 /**
- * File for the CiviCRM APIv3 Survey Respondant functions
+ * This api exposes CiviCRM Survey Respondant.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Survey
diff --git a/api/v3/System.php b/api/v3/System.php
index 92f8c06591..e306cc1cd9 100644
--- a/api/v3/System.php
+++ b/api/v3/System.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 domain functions
+ * This api exposes CiviCRM system.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Domain
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Domain.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
@@ -40,8 +38,8 @@
  *
  * @param array $params
  *   Input parameters.
- *                          - triggers: bool, whether to drop/create SQL triggers; default: FALSE
- *                          - session:  bool, whether to reset the CiviCRM session data; defaul: FALSE
+ *   - triggers: bool, whether to drop/create SQL triggers; default: FALSE
+ *   - session:  bool, whether to reset the CiviCRM session data; default: FALSE
  *
  * @return array
  */
diff --git a/api/v3/SystemLog.php b/api/v3/SystemLog.php
index 94a84e766a..d7ff704455 100644
--- a/api/v3/SystemLog.php
+++ b/api/v3/SystemLog.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 SystemLog functions
+ * This api exposes CiviCRM SystemLog.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_SystemLog
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: SystemLog.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/Tag.php b/api/v3/Tag.php
index d9b0e2ca09..e366f1063b 100644
--- a/api/v3/Tag.php
+++ b/api/v3/Tag.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 tag functions
+ * This api exposes CiviCRM tag.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Tag
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Tag.php 30486 2010-11-02 16:12:09Z shot $
  */
 
 /**
diff --git a/api/v3/UFField.php b/api/v3/UFField.php
index 38790df841..2d5c55ed86 100644
--- a/api/v3/UFField.php
+++ b/api/v3/UFField.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 user framework group functions
+ * This api exposes CiviCRM profile field.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_UF
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: UFField.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/UFGroup.php b/api/v3/UFGroup.php
index 2ff2ac65dd..300ce89fb6 100644
--- a/api/v3/UFGroup.php
+++ b/api/v3/UFGroup.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 user framework group functions
+ * This api exposes CiviCRM profile group.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_UF
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: UFGroup.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/UFJoin.php b/api/v3/UFJoin.php
index 1623d0c699..9245725845 100644
--- a/api/v3/UFJoin.php
+++ b/api/v3/UFJoin.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 user framework join functions
+ * This api exposes CiviCRM user framework join.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_UF
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: UFJoin.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/UFMatch.php b/api/v3/UFMatch.php
index c4d69b6420..776b5eff36 100644
--- a/api/v3/UFMatch.php
+++ b/api/v3/UFMatch.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 user framework group functions
+ * This api exposes CiviCRM user framework match.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_UF
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: UFGroup.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/Website.php b/api/v3/Website.php
index ca4f07606c..4075573e4e 100644
--- a/api/v3/Website.php
+++ b/api/v3/Website.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 website functions
+ * This api exposes CiviCRM website.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_Website
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Website.php 2011-03-16 ErikHommel $
  */
 
 /**
diff --git a/api/v3/WordReplacement.php b/api/v3/WordReplacement.php
index 2314361396..e4aad58bcc 100644
--- a/api/v3/WordReplacement.php
+++ b/api/v3/WordReplacement.php
@@ -26,13 +26,11 @@
  */
 
 /**
- * File for the CiviCRM APIv3 domain functions
+ * This api exposes CiviCRM word replacement.
  *
  * @package CiviCRM_APIv3
  * @subpackage API_WordReplacement
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: Domain.php 30171 2010-10-14 09:11:27Z mover $
  */
 
 /**
diff --git a/api/v3/utils.php b/api/v3/utils.php
index fc41c821b2..ffe7f8d873 100644
--- a/api/v3/utils.php
+++ b/api/v3/utils.php
@@ -31,8 +31,6 @@
  * @package CiviCRM_APIv3
  * @subpackage API_utils
  *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id: utils.php 30879 2010-11-22 15:45:55Z shot $
  */
 
 /**
-- 
2.25.1