added comments in doxygen format for doc generation, added traces in debug mode, removed unuseful parameter