add $aciton to add*() methods, and update docblocks