From 5a38ca041cb4333b40ba2e00559d8dd219765809 Mon Sep 17 00:00:00 2001
From: Peter Bernard West <pbwest@apache.org>
Date: Sun, 16 Jun 2002 23:21:19 +0000
Subject: [PATCH] Expanded comments on the rationale of this property value

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/FOP_0-20-0_Alt-Design@194886 13f79535-47bb-0310-9956-ffa450edef68
---
 src/org/apache/fop/datatypes/FromNearestSpecified.java |  8 ++++++--
 src/org/apache/fop/datatypes/FromParent.java           | 10 +++++++---
 2 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/src/org/apache/fop/datatypes/FromNearestSpecified.java b/src/org/apache/fop/datatypes/FromNearestSpecified.java
index c4688d1db..46a9153d4 100644
--- a/src/org/apache/fop/datatypes/FromNearestSpecified.java
+++ b/src/org/apache/fop/datatypes/FromNearestSpecified.java
@@ -26,7 +26,7 @@ import org.apache.fop.fo.Properties;
  * from-nearest-specified-value() function call on each of the properties to
  * which the shorthand resolves.
  * <p>
- * The use of the pseudo-property should ensure that the function call is not
+ * The use of the pseudo-type should ensure that the function call is not
  * involved in any arithmetic components of a more complex expression.  I.e,
  * the function evaluator in the parser must check to see whether the
  * property for which the from-nearest-specified-value() function is being
@@ -43,8 +43,12 @@ import org.apache.fop.fo.Properties;
  * that the constraint on the from-nearest-specified-value() function, with
  * respect to shorthands, is met.
  * <p>
- * See also <tt>FromParent</tt> pseudo-class.
+ * This pseudo-datatype is also used as the first stage of shorthand
+ * expansion.  After a shorthand's expression is parsed, the next stage of
+ * resolution will generate a FromNearestSpecified object for each property
+ * in the expansion of the shorthand.
  *
+ * @see FromParent
  * @author <a href="mailto:pbwest@powerup.com.au">Peter B. West</a>
  * @version $Revision$ $Name$
  */
diff --git a/src/org/apache/fop/datatypes/FromParent.java b/src/org/apache/fop/datatypes/FromParent.java
index 6c0530797..532c321a4 100644
--- a/src/org/apache/fop/datatypes/FromParent.java
+++ b/src/org/apache/fop/datatypes/FromParent.java
@@ -25,7 +25,7 @@ import org.apache.fop.fo.Properties;
  * from-parent() function call on each of the properties to
  * which the shorthand resolves.
  * <p>
- * The use of the pseudo-property should ensure that the function call is not
+ * The use of the pseudo-type should ensure that the function call is not
  * involved in any arithmetic components of a more complex expression.  I.e,
  * the function evaluator in the parser must check to see whether the
  * property for which the from-parent() function is being
@@ -42,8 +42,12 @@ import org.apache.fop.fo.Properties;
  * that the constraint on the from-parent() function, with
  * respect to shorthands, is met.
  * <p>
- * See also <tt>FromNearestSpecified</tt> pseudo-class.
- * </p>
+ * This pseudo-datatype is also used as the first stage of shorthand
+ * expansion.  After a shorthand's expression is parsed, the next stage of
+ * resolution will generate a FromNearestSpecified object for each property
+ * in the expansion of the shorthand.
+ *
+ * @see FromNearestSpecified
  * @author <a href="mailto:pbwest@powerup.com.au">Peter B. West</a>
  * @version $Revision$ $Name$
  */
-- 
2.39.5