refactored internal part of Options
refactored legacy helpers to use new flags
added documentation behind mapping functions for previous API