-// and determine the loop depth of various nodes of the CFG. Note that the
-// loops identified may actually be several natural loops that share the same
-// header node... not just a single natural loop.
+// and determine the loop depth of various nodes of the CFG. Note that natural
+// loops may actually be several loops that share the same header node...
+//
+// This analysis calculates the nesting structure of loops in a function. For
+// each natural loop identified, this analysis identifies natural loops
+// contained entirely within the function, the basic blocks the make up the
+// loop, the nesting depth of the loop, and the successor blocks of the loop.
+//
+// It can calculate on the fly a variety of different bits of information, such
+// as whether there is a preheader for the loop, the number of back edges to the
+// header, and whether or not a particular block branches out of the loop.