Barrapunto

No siempre poner un comentario en un codigo es tarea simple, me a ocurrido mas de una vez que para comentar lo que hace una funcion necesito muchas mas lineas de texto que lineas tiene la propia funcion, y estoy habalando que para una funcion de solo 20-30 lineas he llegado a necesitar hasta 500 lineas x 80 caracteres explicando claramente la funcion y lo peor es que hay gente que ni asi se entera, tambien hay que decir que mi c es algo ofuscado, pero por lo contrario es muy eficaz a la hora de usas recursos de la maquina.