add shared specs, update rdoc