modify docs to reflect "restart" behavior