More commenting, slightly clearer method names.

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

1 files changed, 9 insertions, 6 deletions

diff --git a/src/java/org/apache/fop/area/Resolvable.java b/src/java/org/apache/fop/area/Resolvable.java
index 61de613a0..def072885 100644
--- a/src/java/org/apache/fop/area/Resolvable.java
+++ b/src/java/org/apache/fop/area/Resolvable.java
@@ -45,11 +45,14 @@ public interface Resolvable {
     String[] getIDs();
 
     /**
-     * This resolves reference with a list of pages.
-     * The pages (PageViewport) contain the rectangle of the area.
-     * @param id the id to resolve
-     * @param pages the list of pages with the id area
-     *              may be null if not found
+     * This method provides the opportunity for a Resolvable object
+     * to resolve one of its unresolved idrefs with the actual set of
+     * PageViewports containing the target ID.
+     *
+     * @param id an ID possibly matching one of the Resolvable object's
+     *      unresolved idref's.
+     * @param pages the list of PageViewports with the given ID
+     *      may be null if ID is not tied to any
      */
-    void resolve(String id, List pages);
+    void resolveIDRef(String id, List pages);
 }