你遇到过的源代码中最好的注释是什么?
当前回答
注意上面代码中的bug;我只是证明了它是正确的,并没有尝试过。
这是唐纳德·克努斯写的。
其他回答
//FIXME: fix this before the 1.0 release
他们在第4版
我所见过的最好的评论是
/*
There is no accounting for pointers
*/
def format_ticket_content(text, recursive = true)
if text.is_a?(TicketNote)
note = text
text = note.content
else
note = nil
end
## Safety pig has arrived!
text = h(text)
## _
## _._ _..._ .-', _.._(`))
## '-. ` ' /-._.-' ',/
## ) \ '.
## / _ _ | \
## | a a / |
## \ .-. ;
## '-('' ).-' ,' ;
## '-; | .'
## \ \ /
## | 7 .__ _.-\ \
## | | | ``/ /` /
## /,_| | /,_/ /
## /,_/ '`-'
##
double t = 0.0; /* that's generally my opinion of the diner, too. */
#如你所见:我注释了代码!