Document trickiness.

bar.html

@@ -59,6 +59,14 @@
         $('#comments span').text(info.num_comments);
 
         window.setTimeout(function() {
+          // Note: there's an interesting interaction here: if a size change is necessary, this will lead to
+          // a resize() event, calling update() again. If the outerWidth/outerHeight haven't changed, a second
+          // call will presumably have no effect, and not call resize(). However, if the dimensions *have* changed,
+          // we'll spin around again and again until the outerWidth/outerHeight are unaffected by the size change.
+          //
+          // This comes into affect often when the number of lines changes due to wrapping and width change. Thanks
+          // to the recursive-ish sizing, the height will successfully update if a prior width change caused line 
+          // flow to change.
           msgJSON({action:'size', width:$('#bar').outerWidth(), height:$('#bar').outerHeight()});
           $('body').width('100%');
         }, 10);