document "swapping" option