Issue #11: document how the 'pause' function works.