http://www.perlmonks.org?node_id=878665


in reply to On comments

Ok, so if everyone agrees that the

movq $5, %rax ! set value of rax register to 5
style comments are unnecessary, then why do people recommend YAPE::Regex::Explain so much?

Replies are listed 'Best First'.
Re^2: On comments
by Your Mother (Archbishop) on Dec 22, 2010 at 21:21 UTC

    A part of it: It's a dynamic/current, programmatic explanation. It isn't lying to you, misdirecting you, or offering an opinion. It's also mostly recommended to novices. A verbose (and perfectly accurate) comment on every line code would be useful for a beginner.