doc updates for replace methods, plus fixes