Miért rossz a doxygen?
Van esetleg olyan dokumentum-generáló, ami nem a forrásfájlokból dolgozik?
Szerintem néhány sornyi dolog sokszor nem árthat, ha van a forrásban (néhány sor < 5-10). De valóban, azon már én is gondolkodtam, hogy amikor több tíz sort érdemes odaírni (pontosság miatt), akkor mit lehetne inkább csinálni, mert az már tényleg sok.