use same parameter docs as in refresh and copy reference