--- | Loop forever, writing the buffer to file whenever a new XML
--- prologue is seen. This is the low-level "loop forever" function
--- that we stay in as long as we are connected to one feed.
+-- | Loop forever, writing the buffer to file whenever a </message>
+-- tag is seen. This is the low-level "loop forever" function that
+-- we stay in as long as we are connected to one feed.
+--
+-- The documentation at
+-- <http://www.sportsnetworkdata.com/feeds/xml-levels.asp> states
+-- that \<message\> will always be the root element of the XML
+-- documents, and \</message\> will be the final line transmitted
+-- for a given document. We therefore rely on this to simplify
+-- processing.