En los lenguajes que distinguen entre un archivo "fuente" y "encabezado" (principalmente C y C ++), es mejor documentar las funciones en el archivo encabezado: (robado de CCAN ) /** * time_now - return the current time * * Example: * printf("Now is %lu seconds since epoch\n",...