documentation and tests now use discard_old