document the replace feature