document keyed_replace
remove "young and volatile" warning