8
헤더 파일이나 소스 파일에 함수를 문서화하는 것이 더 낫습니까?
"소스"와 "헤더"파일 (주로 C와 C ++)을 구분하는 언어에서는 헤더 파일에 함수를 문서화하는 것이 좋습니다. ( CCAN 에서 인용 ) /** * time_now - return the current time * * Example: * printf("Now is %lu seconds since epoch\n", (long)time_now().tv_sec); */ struct timeval time_now(void); 또는 소스 파일에서? (PostgreSQL에서 인용) /* * Convert …