neolith의 방
![[레벨:13]](http://old.lameproof.com/modules/point/icons/default/13.gif "포인트:16257point (43%), 레벨:13/30"){kind=icon}
neolith![[레벨:0]](http://old.lameproof.com/modules/point/icons/default/0.gif "포인트:0point (0%), 레벨:0/30"){kind=icon}
265Ideally, comments should be used for expressing intention of programmer. Code itself shows implementation details, which tend to change. If codes hide implementation detail enough, additional comments will be redundancy.
Showing Implementation detail in code explicitly is as dangerous as putting magic number without using const or #define into code.
문법에 대해 딴지 부탁드려요.
Showing Implementation detail in code explicitly is as dangerous as putting magic number without using const or #define into code.
문법에 대해 딴지 부탁드려요.
imcgames 의 김학규입니다
2003.01.06 12:10:10 (*.241.151.61)
표현이 조금 딱딱해 보입니다. 프로그램코드내의 커맨트에 대한 의견을 얘기하고자 하시는것 같네요.
tend to change -> changeable
redundancy -> needless (redundancy가 과잉이라는 의미가 있지만, 만일을 대비한 여분의 의미도 있으니)
implemetation detail -> implementation in detail
그리고, 과감하게 불필요한 부분이나 중복되는 부분은 생략해도, 보는 사람이 이해합니다.
딴지는 아니고, 그냥 의견으로만 봐주시길... ;;
tend to change -> changeable
redundancy -> needless (redundancy가 과잉이라는 의미가 있지만, 만일을 대비한 여분의 의미도 있으니)
implemetation detail -> implementation in detail
그리고, 과감하게 불필요한 부분이나 중복되는 부분은 생략해도, 보는 사람이 이해합니다.
딴지는 아니고, 그냥 의견으로만 봐주시길... ;;
2003.01.06 14:10:09 (*.147.157.106)
neolith implementation detail 이라는 말은 프로그래머들사이에서 그냥 한 단어처럼 쓰는 경우가 많아서 쓴거고요.. 감사합니다
2003.01.07 02:59:17 (*.217.30.184)
![[레벨:6]](http://old.lameproof.com/modules/point/icons/default/6.gif "포인트:4071point (71%), 레벨:6/30"){kind=icon}
브루펜시럽 일반적으로 주석은 프로그래머의 의도를 말로 표현하는 데에 사용된다.
변할 수 있는 코드 그 자체가 상세한 수행 내용을 보여준다.
만약 코드에 그 상세한 수행 내용이 감추어져있다면, 주석을 추가하는 것은 불필요하다.
명쾌한 코드에 상세한 수행 내용을 설명하는 것은 상수(const/#define)의 사용 없이 특정 의미의 수를 넣는 것보다 위험하다.
--------------
영어를 너무 못해서.. 단어를 찾아도 해석하기가 힘드네요 ㅠ.ㅠ
해석은 맞나요..? -_-a '상세한 수행 내용'이 그 코드가 수행하는 내용을 말하는 것으로 생각하고 적었는 데..
needless 보기 전에는 hide가.. 코드가 엉망이라 수행 내용을 파악할 수 없다라는 것으로 이해를 하고서..
주석을 추가하는 것은 이해를 하기 위한 여분이 될 것이다 라고 생각했는 데.. ^^aa
제대로 한 것인가.. 틀리면 쪽팔린 뎅.. 많이 배우기야 하겠지만 ;;;;;;;
질문이 있는 데요.. 플립코드가 뭔가요.. 또.. 영작과는 무슨 연관성이 ...??
http://www.flipcode.com/ 라는 싸이트를 말씀하시는 건가요.. -_-a
변할 수 있는 코드 그 자체가 상세한 수행 내용을 보여준다.
만약 코드에 그 상세한 수행 내용이 감추어져있다면, 주석을 추가하는 것은 불필요하다.
명쾌한 코드에 상세한 수행 내용을 설명하는 것은 상수(const/#define)의 사용 없이 특정 의미의 수를 넣는 것보다 위험하다.
--------------
영어를 너무 못해서.. 단어를 찾아도 해석하기가 힘드네요 ㅠ.ㅠ
해석은 맞나요..? -_-a '상세한 수행 내용'이 그 코드가 수행하는 내용을 말하는 것으로 생각하고 적었는 데..
needless 보기 전에는 hide가.. 코드가 엉망이라 수행 내용을 파악할 수 없다라는 것으로 이해를 하고서..
주석을 추가하는 것은 이해를 하기 위한 여분이 될 것이다 라고 생각했는 데.. ^^aa
제대로 한 것인가.. 틀리면 쪽팔린 뎅.. 많이 배우기야 하겠지만 ;;;;;;;
질문이 있는 데요.. 플립코드가 뭔가요.. 또.. 영작과는 무슨 연관성이 ...??
http://www.flipcode.com/ 라는 싸이트를 말씀하시는 건가요.. -_-a
2003.01.07 13:23:17 (*.147.157.106)
neolith 원래의 의도는 이거였네요.
주석은 프로그래머의 의도를 표현하는데 사용될때 이상적이다. 코드 그 자체는 프로그래머의 의도보다 구현의 세부사항을 노출시키게 되는데, (구현의 세부사항은) 변화할 여지가 있다. 만약 코드가 충분히 세부사항을 노출시키지 않는 방향으로 짜여졌다면, 궂이 주석을 달 필요는 없다.
코드상에서 구현의 세부사항을 노출시키는 것은, 코드 안에 매직넘버들을 박아넣는것만큼이나 바람직하지 못한 일이다 (굳이 위험하다.. 라고 말할 필요는 없었던 듯)
예를 들어서 다음과 같은 경우입니다.
근로자의 세금을 계산한다고 할때, 주민세는 소득세의 10% 입니다. 이때
주민세 = 소득세 * 0.1; // 주민세는 소득세의 10%
이렇게 짜는 것이 제일 처음 버전이라고 하면
const float 주민세비율 = 0.1;
주민세 = 소득세 * 주민세비율;
이렇게 짜는게 그나마 조금 낫고요 (나중에 주민세 비율이 바뀌게 될때 const 문장 하나만 바꾸면 되니까)
float 계산_주민세(float 소득세)
{
const float 주민세비율 = 0.1;
return 소득세 * 주민세비율;
}
주민세 = 계산_주민세(소득세);
이렇게 짜는게 나중에는 더 좋습니다. 나중에 주민세를 계산할때의 방식이 간단히 소득세에 일정비율을 곱하는 것만으로는 안되게 바뀔 때에 대처하기 좋지요.
위와 같이 '주민세 = 계산_주민세(소득세);' 라고 짰을때에는 굳이 주석을 붙일 필요가 없다는 뜻입니다.
예제를 잘 고른건지 모르겠네요.. --;..
플립코드는 그 사이트 맞고요, 거기 포럼에 보면 실력 좋은 프로그래머들이 모여서 서로 질문 답변, 정보교환 잡담등을 하는 게시판이 매우 활성화되어있습니다. 옆에서 보고 있기만 해도 배울게 많은데, 저도 글을 좀 쓰려고 노력중
주석은 프로그래머의 의도를 표현하는데 사용될때 이상적이다. 코드 그 자체는 프로그래머의 의도보다 구현의 세부사항을 노출시키게 되는데, (구현의 세부사항은) 변화할 여지가 있다. 만약 코드가 충분히 세부사항을 노출시키지 않는 방향으로 짜여졌다면, 궂이 주석을 달 필요는 없다.
코드상에서 구현의 세부사항을 노출시키는 것은, 코드 안에 매직넘버들을 박아넣는것만큼이나 바람직하지 못한 일이다 (굳이 위험하다.. 라고 말할 필요는 없었던 듯)
예를 들어서 다음과 같은 경우입니다.
근로자의 세금을 계산한다고 할때, 주민세는 소득세의 10% 입니다. 이때
주민세 = 소득세 * 0.1; // 주민세는 소득세의 10%
이렇게 짜는 것이 제일 처음 버전이라고 하면
const float 주민세비율 = 0.1;
주민세 = 소득세 * 주민세비율;
이렇게 짜는게 그나마 조금 낫고요 (나중에 주민세 비율이 바뀌게 될때 const 문장 하나만 바꾸면 되니까)
float 계산_주민세(float 소득세)
{
const float 주민세비율 = 0.1;
return 소득세 * 주민세비율;
}
주민세 = 계산_주민세(소득세);
이렇게 짜는게 나중에는 더 좋습니다. 나중에 주민세를 계산할때의 방식이 간단히 소득세에 일정비율을 곱하는 것만으로는 안되게 바뀔 때에 대처하기 좋지요.
위와 같이 '주민세 = 계산_주민세(소득세);' 라고 짰을때에는 굳이 주석을 붙일 필요가 없다는 뜻입니다.
예제를 잘 고른건지 모르겠네요.. --;..
플립코드는 그 사이트 맞고요, 거기 포럼에 보면 실력 좋은 프로그래머들이 모여서 서로 질문 답변, 정보교환 잡담등을 하는 게시판이 매우 활성화되어있습니다. 옆에서 보고 있기만 해도 배울게 많은데, 저도 글을 좀 쓰려고 노력중
2003.01.07 16:13:10 (*.147.157.106)
neolith 글 써놓고 자세히 보고 있으니 코드가 점점 길어지는.. 하지만 이걸 기억하시길. 프로그래밍의 발전은 indirection 의 발전이라는 것을
2003.01.07 17:43:20 (*.217.30.184)
브루펜시럽 indirection : 1 우회적인 방법. 2 무목적(aimlessness). 3 부정직(한 태도), 기만, 거짓. -_-? ( 으아악 죽어야해.. ㅡ0ㅡ )
아...저는 코드에서 마이웨이를 걷는 프로그래머들을 지칭하고 적는 것인가 했어요.
무한 삽질을 통해서 소스의 가독성을 떨어트리는 행위에 대한 이야기인가.. 생각을 하고서 해석을 했거든요.
예를 보고서 다시 해석하니까 훨씬 다가오네요.. ( 단어가 익숙해져가고 있엉.. 으아아아 몇번이나 본거야 -_-;; )
explicitly 가.. '명쾌한'이 아니라 '숨김없이' 로 해석해야 되는 가요..? -_-aa
code를 수식하는 건지.. showing 에 대한 추가적인 서술인지.. ( 아아 주거야해.. 도대체 문법을 아는 게 뭐야 -_-aa 흑흑 )
아...저는 코드에서 마이웨이를 걷는 프로그래머들을 지칭하고 적는 것인가 했어요.
무한 삽질을 통해서 소스의 가독성을 떨어트리는 행위에 대한 이야기인가.. 생각을 하고서 해석을 했거든요.
예를 보고서 다시 해석하니까 훨씬 다가오네요.. ( 단어가 익숙해져가고 있엉.. 으아아아 몇번이나 본거야 -_-;; )
explicitly 가.. '명쾌한'이 아니라 '숨김없이' 로 해석해야 되는 가요..? -_-aa
code를 수식하는 건지.. showing 에 대한 추가적인 서술인지.. ( 아아 주거야해.. 도대체 문법을 아는 게 뭐야 -_-aa 흑흑 )
![[레벨:2]](http://old.lameproof.com/modules/point/icons/default/2.gif "포인트:554point (43%), 레벨:2/30"){kind=icon}
카즈군![[레벨:3]](http://old.lameproof.com/modules/point/icons/default/3.gif "포인트:1249point (69%), 레벨:3/30"){kind=icon}
ㅊㅋㅊㅋ