regression fix and documentation note