Nas linguagens que distinguem entre um arquivo "fonte" e "cabeçalho" (principalmente C e C ++), é melhor documentar funções no arquivo de cabeçalho: (roubado do CCAN ) /** * time_now - return the current time * * Example: * printf("Now is %lu seconds since epoch\n", (long)time_now().tv_sec);...