add documentation for new "earliest" option