add documentation for special flags