updated documentation for new behavior of 'before' and 'after' options