Added comment

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@654190 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/src/java/org/apache/fop/fo/flow/Wrapper.java b/src/java/org/apache/fop/fo/flow/Wrapper.java
index dfe837315d7cd9a6011d344afb934fa347f8b2a2..5ed594eccc1613084ccdb7b35b0913b3106db08b 100644 (file)
--- a/src/java/org/apache/fop/fo/flow/Wrapper.java
+++ b/src/java/org/apache/fop/fo/flow/Wrapper.java
@@ -67,8 +67,13 @@ public class Wrapper extends FObjMixed {
                         "(#PCDATA|%inline;|%block;)");
                 }
             } else if (isBlockOrInlineItem(nsURI, localName)) {
+                /* delegate validation to parent, but keep the error reporting
+                 * tidy. If we would simply call validateChildNode() on the
+                 * parent, the user would get a wrong impression, as only the
+                 * locator (if any) will contain a reference to the offending
+                 * fo:wrapper.
+                 */
                 try {
-                    //delegate validation to parent
                     FONode.validateChildNode(this.parent, loc, nsURI, localName);
                 } catch (ValidationException vex) {
                     invalidChildError(loc, getName(), FO_URI, localName, "rule.wrapperInvalidChildForParent");