From: Simon Pepping <spepping@apache.org>
Date: Mon, 27 Dec 2004 10:09:31 +0000 (+0000)
Subject: Added some comments.
X-Git-Tag: Root_Temp_KnuthStylePageBreaking~296
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=9dda491acd94e74030790d411487af483d4c7bc9;p=xmlgraphics-fop.git

Added some comments.


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

diff --git a/src/java/org/apache/fop/fo/flow/RetrieveMarker.java b/src/java/org/apache/fop/fo/flow/RetrieveMarker.java
index 0ad5b3afa..744728ae2 100644
--- a/src/java/org/apache/fop/fo/flow/RetrieveMarker.java
+++ b/src/java/org/apache/fop/fo/flow/RetrieveMarker.java
@@ -139,9 +139,10 @@ public class RetrieveMarker extends FObjMixed {
 
     /**
      * Clone the subtree of marker,
-     * attach the new subtree to this node,
-     * reparent the property lists of the direct children
-     * to the property list of this node.
+     * and attach the new subtree to this node.
+     * The property lists are not cloned;
+     * the existing property lists of the direct children
+     * are reparented to the property list of this node.
      * @param marker the marker that is to be cloned
      * @param descPLists the map of the new nodes to property lists
      */
@@ -185,7 +186,12 @@ public class RetrieveMarker extends FObjMixed {
 
     /**
      * Clone the subtree of marker
-     * and bind the nodes to the property values in this context
+     * and bind the nodes to the property values in this context.
+     * The property lists are not cloned,
+     * but the subtree is attached to the property list of this node.
+     * This is only needed for the binding of the FO nodes.
+     * After that a subsequent retrieve-marker
+     * may reparent the property lists.
      * @param marker the marker that is to be cloned
      */
     public void bindMarker(Marker marker) {