document reply interface. Closes #2156