Dans les langages qui distinguent un fichier "source" et "en-tête" (principalement C et C ++), est-il préférable de documenter les fonctions dans le fichier en-tête: (dérobé de CCAN ) /** * time_now - return the current time * * Example: * printf("Now is %lu seconds since epoch\n",...