also move the detailed description in the source file documentation