add  soft credit api examples
CRM-12545 fix tests broken by work on activity contact restructuring
CRM12547, CRM-12357 fix Mailing Contact api to comply with api conformance tests
fix includes -
- using spec function to provide documentation, enforce required fields, provide default, enforce options
- using standard api function to process 'limit', 'sort' etc
- skipping checks for getByID because in this area the api cannot be made standard
NOTE that the default limit has been set to the api default (25). Making
this non standard for a particular use-case doesn't make sense.

Preferred calling method is
$params['options' => array('sort' => 'contact_id DESC', 'limit' => 50,
'offset' => 200)

re-fix mailing contact api
CRM-12628 hack to deal with poorly named BAO class
CRM-12392 further problems arising from non-std BAO-naming
CRM-12509 default custom group api to is_active =1
CRM-12547 , CRM-12357 add a test for getCount
remove some references to debug from tests