updates put_multi comments and docs correspondingly