new operator assignment idiom
Updated clients doc to show newer usages