Internal documentation for debug possibilities

Documentation regarding usage of -d option with [f]lex
Initial documentation regarding the -d options with doxygen