--- a/FOPRunXSLTExt/examples/example5.xsl	Wed Mar 05 22:12:22 2014 +0000
+++ b/FOPRunXSLTExt/examples/example5.xsl	Wed Mar 05 22:13:08 2014 +0000
@@ -2,11 +2,12 @@
 <!-- ============================================================= -->
 <!-- FOPRunXSLTExt Saxon example 5                                 -->
 <!--                                                               -->
-<!-- See http://www.w3.org/community/ppl/wiki/FOPRunXSLTExt        -->
+<!-- See http://www.w3.org/community/ppl/wiki/XSLTExtensions       -->
 <!--                                                               -->
 <!-- Requires Saxon 9.5 or later and FOP 1.0 or AHF 6.1            -->
 <!--                                                               -->
 <!-- Produced by the Print and Page Layout Community Group @ W3C   -->
+<!-- http://www.w3.org/community/ppl/                              -->
 <!-- ============================================================= -->
 <xsl:stylesheet
     xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
@@ -16,6 +17,10 @@
     xmlns:xs="http://www.w3.org/2001/XMLSchema"
     exclude-result-prefixes="ppl xs">
 
+<!-- ============================================================= -->
+<!-- IMPORTS                                                       -->
+<!-- ============================================================= -->
+
 <!-- Print and Page Layout Community Group extensions. -->
 <xsl:import href="ppl-extensions.xsl" />
 
@@ -56,6 +61,11 @@
   <xsl:message select="concat('tolerance: ', $tolerance)" />
   <xsl:message select="concat('font-size-tolerance: ', $font-size-tolerance)" />
 
+  <!-- 'do-box' templates recursively calls itself until: the
+       formatted area fits within the box within $tolerance; the
+       change in $font-size between successive runs is less than
+       $font-size-tolerance; or $iteration-max iterations is
+       reached. -->
   <xsl:call-template name="do-box">
     <xsl:with-param name="font-size" select="$font-size" as="xs:double" />
     <xsl:with-param

--- a/FOPRunXSLTExt/examples/formatting.xsl	Wed Mar 05 22:12:22 2014 +0000
+++ b/FOPRunXSLTExt/examples/formatting.xsl	Wed Mar 05 22:13:08 2014 +0000
@@ -46,6 +46,11 @@
 
 <xsl:template match="box">
   <xsl:param name="overrides" select="$overrides" as="document-node()" tunnel="yes"/>
+
+  <!--
+  <xsl:message select="key('overrides', @id, $overrides)"/>
+  -->
+
   <fo:block-container role="{local-name()}" border="medium solid black"
 	    width="{@width}" height="{@height}" padding="12pt"
 	    id="{@id}">