implemening and testing FlagList functions
updating documentation and API doc