Today I was looking at some .Net 3.5 source code and ran into these great comments.
//ok, this is a hairy, dirty, and nasty piece of code
//the alternatives are substantially worse than this though
//i.e. when you do your own provider, LINQ assumes that
//you are going to implement your own expression tree visitor and
//do it all yourself. Frankly, I still have xmas shopping to do
//and I really don't want us to be foobared when we get
//even more extension methods added to LINQ
//therefore, we are pulling execute based on taking the calling the standard execute on
//enumerable, but using our own class
//
This is great because it is truthful and explains the exact intent or thought process of the developer.
//pray. If something is going to break, it will do so here
return genericMethodInfo.Invoke(null, paramList.ToArray());
We have all put comments in here
I know this post was kinda pointless, but thought it would cause some to smile
Till next time,