This topic is now archived and is closed to further replies.


Context comments?

Recommended Posts

I have been programming for lots of years and seen many (all?) philosophies of commenting from non-existant to the over-redundant. I don''t have a problem reading un-commented code but what I really miss is someway to introduce the context into the comments in a clever way. Something like a call-graph but a little bit more complex and generalized I guess. It''s damned hard to find your way around when dealing with a couple of million lines of code you never seen before... Especially when you get things like ''if (y) { return f(x) }'' combos. (is f(x) an error handler or the ''expected'' returnvalue or ... ?) Anyone that have any expirences with a working system (without going super-verbose)? I pretty tired of grep:ing through all those files in all those directories...

Share this post

Link to post
Share on other sites