You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by je...@apache.org on 2010/08/14 19:17:13 UTC

svn commit: r985537 [4/11] - in /xmlgraphics/fop/trunk: ./ src/codegen/java/org/apache/fop/tools/ src/codegen/unicode/data/ src/codegen/unicode/java/org/apache/fop/hyphenation/ src/codegen/unicode/java/org/apache/fop/text/linebreak/ src/codegen/unicode...

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/PrimaryGridUnit.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/PrimaryGridUnit.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/PrimaryGridUnit.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/PrimaryGridUnit.java Sat Aug 14 17:17:00 2010
@@ -85,6 +85,10 @@ public class PrimaryGridUnit extends Gri
         return (TablePart) node;
     }
 
+    /**
+     * Get cell's layout manager.
+     * @return the cell's layout manager
+     */
     public TableCellLayoutManager getCellLM() {
         assert cellLM != null;
         return cellLM;
@@ -109,6 +113,10 @@ public class PrimaryGridUnit extends Gri
         this.elements = elements;
     }
 
+    /**
+     * Obtain the Knuth elements.
+     * @return a list of Knuth elements
+     */
     public List getElements() {
         return this.elements;
     }
@@ -247,6 +255,10 @@ public class PrimaryGridUnit extends Gri
         return this.rows;
     }
 
+    /**
+     * Add a row.
+     * @param row the row to be added
+     */
     public void addRow(GridUnit[] row) {
         if (rows == null) {
             rows = new java.util.ArrayList();

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableAndCaption.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableAndCaption.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableAndCaption.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableAndCaption.java Sat Aug 14 17:17:00 2010
@@ -30,7 +30,7 @@ import org.apache.fop.fo.ValidationExcep
 /**
  * Class modelling the <a href="http://www.w3.org/TR/xsl/#fo_table-and-caption">
  * <code>fo:table-and-caption</code></a> property.
- * @todo needs implementation
+ * @asf.todo needs implementation
  */
 public class TableAndCaption extends FObj /*implements BreakPropertySet*/ {
     // The value of properties relevant for fo:table-and-caption.
@@ -50,7 +50,7 @@ public class TableAndCaption extends FOb
     //     private int textAlign;
     // End of property values
 
-    static boolean notImplementedWarningGiven = false;
+    private static boolean notImplementedWarningGiven = false;
 
     /** used for FO validation */
     private boolean tableCaptionFound = false;

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableCaption.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableCaption.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableCaption.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableCaption.java Sat Aug 14 17:17:00 2010
@@ -49,7 +49,7 @@ public class TableCaption extends FObj {
     /** used for FO validation */
     private boolean blockItemFound = false;
 
-    static boolean notImplementedWarningGiven = false;
+    private static boolean notImplementedWarningGiven = false;
 
     /**
      * Create a TableCaption instance with the given {@link FONode}

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableCellContainer.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableCellContainer.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableCellContainer.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableCellContainer.java Sat Aug 14 17:17:00 2010
@@ -30,14 +30,26 @@ import org.apache.fop.fo.FONode;
  */
 public abstract class TableCellContainer extends TableFObj implements ColumnNumberManagerHolder {
 
+    /** list of pending spans */
     protected List pendingSpans;
 
+    /** column number manager */
     protected ColumnNumberManager columnNumberManager;
 
+    /**
+     * Construct table cell container.
+     * @param parent the parent node of the cell container
+     */
     public TableCellContainer(FONode parent) {
         super(parent);
     }
 
+    /**
+     * Add cell to current row.
+     * @param cell a table cell to add
+     * @param firstRow true is first row
+     * @throws FOPException if exception occurs
+     */
     protected void addTableCellChild(TableCell cell, boolean firstRow) throws FOPException {
         int colNumber = cell.getColumnNumber();
         int colSpan = cell.getNumberColumnsSpanned();

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableEventProducer.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableEventProducer.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableEventProducer.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableEventProducer.java Sat Aug 14 17:17:00 2010
@@ -32,7 +32,10 @@ import org.apache.fop.fo.expr.PropertyEx
 public interface TableEventProducer extends EventProducer {
 
     /** Provider class for the event producer. */
-    class Provider {
+    static final class Provider {
+
+        private Provider() {
+        }
 
         /**
          * Returns an event producer.

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableFObj.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableFObj.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableFObj.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TableFObj.java Sat Aug 14 17:17:00 2010
@@ -50,12 +50,12 @@ public abstract class TableFObj extends 
     private Numeric borderStartPrecedence;
     private String ptr;
 
-    ConditionalBorder borderBefore;
-    ConditionalBorder borderAfter;
-    BorderSpecification borderStart;
-    BorderSpecification borderEnd;
+    ConditionalBorder borderBefore;             // CSOK: VisibilityModifier
+    ConditionalBorder borderAfter;              // CSOK: VisibilityModifier
+    BorderSpecification borderStart;            // CSOK: VisibilityModifier
+    BorderSpecification borderEnd;              // CSOK: VisibilityModifier
 
-    CollapsingBorderModel collapsingBorderModel;
+    CollapsingBorderModel collapsingBorderModel; // CSOK: VisibilityModifier
 
     /**
      * Create a TableFObj instance that is a child
@@ -205,9 +205,10 @@ public abstract class TableFObj extends 
                 int foId = propertyList.getFObj().getNameId();
                 if (i <= 0) {
                     if (foId == FO_TABLE_CELL || foId == FO_TABLE_COLUMN) {
-                        ColumnNumberManagerHolder parent =
-                            (ColumnNumberManagerHolder) propertyList.getParentFObj();
-                        ColumnNumberManager columnIndexManager = parent.getColumnNumberManager();
+                        ColumnNumberManagerHolder parent
+                            = (ColumnNumberManagerHolder) propertyList.getParentFObj();
+                        ColumnNumberManager columnIndexManager
+                            = parent.getColumnNumberManager();
                         i = columnIndexManager.getCurrentColumnNumber();
                     } else {
                         /* very exceptional case:
@@ -216,10 +217,11 @@ public abstract class TableFObj extends 
                          */
                         i = 1;
                     }
-                    TableEventProducer eventProducer =
-                        TableEventProducer.Provider.get(fo.getUserAgent().getEventBroadcaster());
-                    eventProducer.forceNextColumnNumber(this, propertyList.getFObj().getName(),
-                                                        val, i, propertyList.getFObj().getLocator());
+                    TableEventProducer eventProducer
+                        = TableEventProducer.Provider.get(fo.getUserAgent().getEventBroadcaster());
+                    eventProducer.forceNextColumnNumber
+                        (this, propertyList.getFObj().getName(),
+                         val, i, propertyList.getFObj().getLocator());
                 }
                 return NumberProperty.getInstance(i);
             }
@@ -229,7 +231,9 @@ public abstract class TableFObj extends 
     }
 
     /** {@inheritDoc} */
-    public void processNode(String elementName, Locator locator, Attributes attlist, PropertyList pList) throws FOPException {
+    public void processNode
+        (String elementName, Locator locator, Attributes attlist, PropertyList pList)
+        throws FOPException {
         super.processNode(elementName, locator, attlist, pList);
         Table table = getTable();
         if (!inMarker() && !table.isSeparateBorderModel()) {

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TablePart.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TablePart.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TablePart.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/flow/table/TablePart.java Sat Aug 14 17:17:00 2010
@@ -46,10 +46,9 @@ public abstract class TablePart extends 
     //    private int visibility;
     // End of property values
 
-    /**
-     * used for validation
-     */
+    /** table rows found */
     protected boolean tableRowsFound = false;
+    /** table cells found */
     protected boolean tableCellsFound = false;
 
     private boolean firstRow = true;
@@ -124,6 +123,10 @@ public abstract class TablePart extends 
         return this;
     }
 
+    /**
+     * Finish last row group.
+     * @throws ValidationException if content validation exception
+     */
     protected void finishLastRowGroup() throws ValidationException {
         if (!inMarker()) {
             RowGroupBuilder rowGroupBuilder = getTable().getRowGroupBuilder();
@@ -214,6 +217,7 @@ public abstract class TablePart extends 
         rowGroups.add(rowGroup);
     }
 
+    /** @return list of row groups */
     public List getRowGroups() {
         return rowGroups;
     }

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/AbstractPageSequence.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/AbstractPageSequence.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/AbstractPageSequence.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/AbstractPageSequence.java Sat Aug 14 17:17:00 2010
@@ -34,7 +34,9 @@ import org.apache.fop.fo.PropertyList;
 public abstract class AbstractPageSequence extends FObj {
 
     // The value of properties relevant for fo:page-sequence.
+    /** initial page number */
     protected Numeric initialPageNumber;
+    /** forced page count */
     protected int forcePageCount;
     private String format;
     private int letterValue;
@@ -45,6 +47,7 @@ public abstract class AbstractPageSequen
 
     private PageNumberGenerator pageNumberGenerator;
 
+    /** starting page number */
     protected int startingPageNumber = 0;
 
     /**

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/PageSequence.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/PageSequence.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/PageSequence.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/PageSequence.java Sat Aug 14 17:17:00 2010
@@ -151,7 +151,7 @@ public class PageSequence extends Abstra
 
     /**
      * {@inheritDoc}
-     * @todo see if addChildNode() should also be called for fo's other than
+     * @asf.todo see if addChildNode() should also be called for fo's other than
      *  fo:flow.
      */
     public void addChildNode(FONode child) throws FOPException {
@@ -254,10 +254,9 @@ public class PageSequence extends Abstra
      * @return the SimplePageMaster to use for this page
      * @throws PageProductionException if there's a problem determining the page master
      */
-    public SimplePageMaster getNextSimplePageMaster(int page,
-                                                    boolean isFirstPage,
-                                                    boolean isLastPage,
-                                                    boolean isBlank) throws PageProductionException {
+    public SimplePageMaster getNextSimplePageMaster
+        (int page, boolean isFirstPage, boolean isLastPage, boolean isBlank)
+        throws PageProductionException {
 
         if (pageSequenceMaster == null) {
             return simplePageMaster;

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/RegionBody.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/RegionBody.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/RegionBody.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/RegionBody.java Sat Aug 14 17:17:00 2010
@@ -106,8 +106,10 @@ public class RegionBody extends Region {
          * Also the values are resolved relative to the page size
          * and reference orientation.
          */
-        PercentBaseContext pageWidthContext = getPageWidthContext(LengthBase.CONTAINING_BLOCK_WIDTH);
-        PercentBaseContext pageHeightContext = getPageHeightContext(LengthBase.CONTAINING_BLOCK_WIDTH);
+        PercentBaseContext pageWidthContext
+            = getPageWidthContext(LengthBase.CONTAINING_BLOCK_WIDTH);
+        PercentBaseContext pageHeightContext
+            = getPageHeightContext(LengthBase.CONTAINING_BLOCK_WIDTH);
 
         int start;
         int end;

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/Root.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/Root.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/Root.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/pagination/Root.java Sat Aug 14 17:17:00 2010
@@ -144,7 +144,11 @@ public class Root extends FObj {
     }
 
 
-    /** @inheritDoc */
+    /**
+     * @param loc location in the source file
+     * @param child the {@link FONode} to validate against
+     * @throws ValidationException if the incoming node is not a valid child for the given FO
+     */
     protected void validateChildNode(Locator loc, FONode child) throws ValidationException {
         if (child instanceof AbstractPageSequence) {
             pageSequenceFound = true;
@@ -207,7 +211,8 @@ public class Root extends FObj {
      * @param additionalPages the total pages generated by the sequence (for statistics)
      * @throws IllegalArgumentException for negative additional page counts
      */
-    public void notifyPageSequenceFinished(int lastPageNumber, int additionalPages) {
+    public void notifyPageSequenceFinished(int lastPageNumber, int additionalPages)
+      throws IllegalArgumentException {
 
         if (additionalPages >= 0) {
             totalPagesGenerated += additionalPages;

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BackgroundPositionShorthand.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BackgroundPositionShorthand.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BackgroundPositionShorthand.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BackgroundPositionShorthand.java Sat Aug 14 17:17:00 2010
@@ -57,7 +57,8 @@ public class BackgroundPositionShorthand
          * specified, <code>background-position-vertical</code> is set
          * to "50%".
          */
-        public Property make(PropertyList propertyList, String value, FObj fo) throws PropertyException {
+        public Property make(PropertyList propertyList, String value, FObj fo)
+            throws PropertyException {
             Property p = super.make(propertyList, value, fo);
             if (p.getList().size() == 1) {
                 /* only background-position-horizontal specified

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BorderSpacingShorthandParser.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BorderSpacingShorthandParser.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BorderSpacingShorthandParser.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BorderSpacingShorthandParser.java Sat Aug 14 17:17:00 2010
@@ -29,6 +29,7 @@ import org.apache.fop.fo.expr.PropertyEx
  */
 public class BorderSpacingShorthandParser extends GenericShorthandParser {
 
+    /** {@inheritDoc} */
     protected Property convertValueForProperty(int propId, Property property,
             PropertyMaker maker, PropertyList propertyList)
             throws PropertyException {

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BorderWidthPropertyMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BorderWidthPropertyMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BorderWidthPropertyMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/BorderWidthPropertyMaker.java Sat Aug 14 17:17:00 2010
@@ -28,7 +28,8 @@ import org.apache.fop.fo.expr.PropertyEx
  * border width described in 7.7.20.
  */
 public class BorderWidthPropertyMaker extends LengthProperty.Maker {
-    int borderStyleId = 0;
+
+    private int borderStyleId = 0;
 
     /**
      * Create a length property which check the value of the border-*-style
@@ -41,7 +42,7 @@ public class BorderWidthPropertyMaker ex
 
     /**
      * Set the propId of the style property for the same side.
-     * @param borderStyleId
+     * @param borderStyleId the border style id
      */
     public void setBorderStyleId(int borderStyleId) {
         this.borderStyleId = borderStyleId;
@@ -55,8 +56,7 @@ public class BorderWidthPropertyMaker ex
 
     public Property get(int subpropId, PropertyList propertyList,
                         boolean bTryInherit, boolean bTryDefault)
-        throws PropertyException
-    {
+        throws PropertyException {
         Property p = super.get(subpropId, propertyList,
                                bTryInherit, bTryDefault);
 

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CharacterProperty.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CharacterProperty.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CharacterProperty.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CharacterProperty.java Sat Aug 14 17:17:00 2010
@@ -24,6 +24,8 @@ import org.apache.fop.fo.PropertyList;
 
 /**
  * Superclass for properties that wrap a character value
+ * @asf.todo convert character value to int in order to denote unicode scalar value
+ * instead of a single UTF-16 code element
  */
 public final class CharacterProperty extends Property {
 
@@ -39,6 +41,7 @@ public final class CharacterProperty ext
             super(propId);
         }
 
+        /** {@inheritDoc} */
         public Property make(PropertyList propertyList, String value,
                              FObj fo) {
             char c = value.charAt(0);
@@ -48,7 +51,8 @@ public final class CharacterProperty ext
     }
 
     /** cache containing all canonical CharacterProperty instances */
-    private static final PropertyCache cache = new PropertyCache(CharacterProperty.class);
+    private static final PropertyCache cache // CSOK: ConstantName
+        = new PropertyCache(CharacterProperty.class);
 
     private final char character;
 
@@ -59,6 +63,11 @@ public final class CharacterProperty ext
         this.character = character;
     }
 
+    /**
+     * Get character property instance for character.
+     * @param character the character
+     * @return the character property instance
+     */
     public static CharacterProperty getInstance(char character) {
         return (CharacterProperty) cache.fetch(
                         new CharacterProperty(character));

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/ColorProperty.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/ColorProperty.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/ColorProperty.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/ColorProperty.java Sat Aug 14 17:17:00 2010
@@ -33,7 +33,8 @@ import org.apache.fop.util.ColorUtil;
 public final class ColorProperty extends Property  {
 
     /** cache holding canonical ColorProperty instances */
-    private static final PropertyCache cache = new PropertyCache(ColorProperty.class);
+    private static final PropertyCache cache // CSOK: ConstantName
+        = new PropertyCache(ColorProperty.class);
 
     /**
      * The color represented by this property.
@@ -97,7 +98,8 @@ public final class ColorProperty extends
      * @throws PropertyException if the value can't be parsed
      * @see ColorUtil#parseColorString(FOUserAgent, String)
      */
-    public static ColorProperty getInstance(FOUserAgent foUserAgent, String value) throws PropertyException {
+    public static ColorProperty getInstance(FOUserAgent foUserAgent, String value)
+        throws PropertyException {
         ColorProperty instance = new ColorProperty(
                                        ColorUtil.parseColorString(
                                                foUserAgent, value));

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAbsolutePosition.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAbsolutePosition.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAbsolutePosition.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAbsolutePosition.java Sat Aug 14 17:17:00 2010
@@ -33,31 +33,32 @@ public class CommonAbsolutePosition {
     /**
      * The "absolute-position" property.
      */
-    public int absolutePosition;
+    public int absolutePosition;                                // CSOK: VisibilityModifier
 
     /**
      * The "top" property.
      */
-    public Length top;
+    public Length top;                                          // CSOK: VisibilityModifier
 
     /**
      * The "right" property.
      */
-    public Length right;
+    public Length right;                                        // CSOK: VisibilityModifier
 
     /**
      * The "bottom" property.
      */
-    public Length bottom;
+    public Length bottom;                                       // CSOK: VisibilityModifier
 
     /**
      * The "left" property.
      */
-    public Length left;
+    public Length left;                                         // CSOK: VisibilityModifier
 
     /**
      * Create a CommonAbsolutePosition object.
      * @param pList The PropertyList with propery values.
+     * @throws PropertyException if a property exception is raised
      */
     public CommonAbsolutePosition(PropertyList pList) throws PropertyException {
         absolutePosition = pList.get(Constants.PR_ABSOLUTE_POSITION).getEnum();
@@ -67,6 +68,7 @@ public class CommonAbsolutePosition {
         right = pList.get(Constants.PR_RIGHT).getLength();
     }
 
+    /** {@inheritDoc} */
     public String toString() {
         StringBuffer sb = new StringBuffer("CommonAbsolutePosition{");
         sb.append(" absPos=");

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAccessibility.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAccessibility.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAccessibility.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAccessibility.java Sat Aug 14 17:17:00 2010
@@ -32,16 +32,17 @@ public class CommonAccessibility {
     /**
      * The "source-doc" property.
      */
-    public String sourceDoc = null;
+    public String sourceDoc = null;                             // CSOK: VisibilityModifier
 
     /**
      * The "role" property.
      */
-    public String role = null;
+    public String role = null;                                  // CSOK: VisibilityModifier
 
     /**
      * Create a <code>CommonAccessibility</code> object.
      * @param pList The PropertyList with propery values.
+     * @throws PropertyException if a property exception is raised
      */
     public CommonAccessibility(PropertyList pList) throws PropertyException {
         sourceDoc = pList.get(Constants.PR_SOURCE_DOCUMENT).getString();

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAural.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAural.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAural.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonAural.java Sat Aug 14 17:17:00 2010
@@ -30,92 +30,92 @@ public class CommonAural {
     /**
      * The "azimuth" property.
      */
-    public int azimuth;
+    public int azimuth;                                         // CSOK: VisibilityModifier
 
     /**
      * The "cueAfter" property.
      */
-    public String cueAfter;
+    public String cueAfter;                                     // CSOK: VisibilityModifier
 
     /**
      * The "cueBefore" property.
      */
-    public String cueBefore;
+    public String cueBefore;                                    // CSOK: VisibilityModifier
 
     /**
      * The "elevation" property.
      */
-    public int elevation;
+    public int elevation;                                       // CSOK: VisibilityModifier
 
     /**
      * The "pauseAfter" property.
      */
-    public int pauseAfter;
+    public int pauseAfter;                                      // CSOK: VisibilityModifier
 
     /**
      * The "pauseBefore" property.
      */
-    public int pauseBefore;
+    public int pauseBefore;                                     // CSOK: VisibilityModifier
 
     /**
      * The "pitch" property.
      */
-    public int pitch;
+    public int pitch;                                           // CSOK: VisibilityModifier
 
     /**
      * The "pitch-range" property.
      */
-    public int pitchRange;
+    public int pitchRange;                                      // CSOK: VisibilityModifier
 
     /**
      * The "playDuring" property.
      */
-    public int playDuring;
+    public int playDuring;                                      // CSOK: VisibilityModifier
 
     /**
      * The "richness" property.
      */
-    public int richness;
+    public int richness;                                        // CSOK: VisibilityModifier
 
     /**
      * The "speak" property.
      */
-    public int speak;
+    public int speak;                                           // CSOK: VisibilityModifier
 
     /**
      * The "speak-header" property.
      */
-    public int speakHeader;
+    public int speakHeader;                                     // CSOK: VisibilityModifier
 
     /**
      * The "speak-numeral" property.
      */
-    public int speakNumeral;
+    public int speakNumeral;                                    // CSOK: VisibilityModifier
 
     /**
      * The "speak-punctuation" property.
      */
-    public int speakPunctuation;
+    public int speakPunctuation;                                // CSOK: VisibilityModifier
 
     /**
      * The "speech-rate" property.
      */
-    public int speechRate;
+    public int speechRate;                                      // CSOK: VisibilityModifier
 
     /**
      * The "stress" property.
      */
-    public int stress;
+    public int stress;                                          // CSOK: VisibilityModifier
 
     /**
      * The "voice-family" property.
      */
-    public int voiceFamily;
+    public int voiceFamily;                                     // CSOK: VisibilityModifier
 
     /**
      * The "volume" property.
      */
-    public int volume;
+    public int volume;                                          // CSOK: VisibilityModifier
 
     /**
      * Create a CommonAbsolutePosition object.

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonBorderPaddingBackground.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonBorderPaddingBackground.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonBorderPaddingBackground.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonBorderPaddingBackground.java Sat Aug 14 17:17:00 2010
@@ -42,45 +42,46 @@ import org.apache.fop.fo.expr.PropertyEx
  * Stores all common border and padding properties.
  * See Sec. 7.7 of the XSL-FO Standard.
  */
-public class CommonBorderPaddingBackground {
+public class CommonBorderPaddingBackground {                    // CSOK: FinalClassCheck
 
     /**
      *  cache holding all canonical instances
      *  (w/ absolute background-position-* and padding-*)
      */
-    private static final PropertyCache cache = new PropertyCache(CommonBorderPaddingBackground.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(CommonBorderPaddingBackground.class);
 
     private int hash = -1;
 
     /**
      * The "background-attachment" property.
      */
-    public final int backgroundAttachment;
+    public final int backgroundAttachment;                      // CSOK: VisibilityModifier
 
     /**
      * The "background-color" property.
      */
-    public final Color backgroundColor;
+    public final Color backgroundColor;                         // CSOK: VisibilityModifier
 
     /**
      * The "background-image" property.
      */
-    public final String backgroundImage;
+    public final String backgroundImage;                        // CSOK: VisibilityModifier
 
     /**
      * The "background-repeat" property.
      */
-    public final int backgroundRepeat;
+    public final int backgroundRepeat;                          // CSOK: VisibilityModifier
 
     /**
      * The "background-position-horizontal" property.
      */
-    public final Length backgroundPositionHorizontal;
+    public final Length backgroundPositionHorizontal;           // CSOK: VisibilityModifier
 
     /**
      * The "background-position-vertical" property.
      */
-    public final Length backgroundPositionVertical;
+    public final Length backgroundPositionVertical;             // CSOK: VisibilityModifier
 
 
     private ImageInfo backgroundImageInfo;
@@ -96,12 +97,13 @@ public class CommonBorderPaddingBackgrou
     public static final int END = 3;
 
     /**
-     *
+     * Utility class to express border info.
      */
-    public static class BorderInfo {
+    public static final class BorderInfo {
 
         /** cache holding all canonical instances */
-        private static final PropertyCache cache = new PropertyCache(BorderInfo.class);
+        private static final PropertyCache cache                // CSOK: ConstantName
+            = new PropertyCache(BorderInfo.class);
 
         private int mStyle; // Enum for border style
         private Color mColor; // Border color
@@ -212,7 +214,7 @@ public class CommonBorderPaddingBackgrou
      * A border info with style "none". Used as a singleton, in the collapsing-border model,
      * for elements which don't specify any border on some of their sides.
      */
-    private static final BorderInfo defaultBorderInfo
+    private static final BorderInfo defaultBorderInfo           // CSOK: ConstantName        
             = BorderInfo.getInstance(Constants.EN_NONE, new ConditionalNullLength(), null);
 
     /**
@@ -352,12 +354,18 @@ public class CommonBorderPaddingBackgrou
         CommonBorderPaddingBackground cachedInstance = null;
         /* if padding-* and background-position-* resolve to absolute lengths
          * the whole instance can be cached */
-        if ((newInstance.padding[BEFORE] == null || newInstance.padding[BEFORE].getLength().isAbsolute())
-                && (newInstance.padding[AFTER] == null || newInstance.padding[AFTER].getLength().isAbsolute())
-                && (newInstance.padding[START] == null || newInstance.padding[START].getLength().isAbsolute())
-                && (newInstance.padding[END] == null || newInstance.padding[END].getLength().isAbsolute())
-                && (newInstance.backgroundPositionHorizontal == null || newInstance.backgroundPositionHorizontal.isAbsolute())
-                && (newInstance.backgroundPositionVertical == null || newInstance.backgroundPositionVertical.isAbsolute())) {
+        if ((newInstance.padding[BEFORE] == null
+             || newInstance.padding[BEFORE].getLength().isAbsolute())
+                && (newInstance.padding[AFTER] == null
+                    || newInstance.padding[AFTER].getLength().isAbsolute())
+                && (newInstance.padding[START] == null
+                    || newInstance.padding[START].getLength().isAbsolute())
+                && (newInstance.padding[END] == null
+                    || newInstance.padding[END].getLength().isAbsolute())
+                && (newInstance.backgroundPositionHorizontal == null
+                    || newInstance.backgroundPositionHorizontal.isAbsolute())
+                && (newInstance.backgroundPositionVertical == null
+                    || newInstance.backgroundPositionVertical.isAbsolute())) {
             cachedInstance = cache.fetch(newInstance);
         }
 
@@ -515,6 +523,7 @@ public class CommonBorderPaddingBackgrou
     }
 
     /**
+     * @param side the side to retrieve
      * @param discard indicates whether the .conditionality component should be
      * considered (end of a reference-area)
      * @return the width of the start-border, taking into account the specified conditionality
@@ -755,8 +764,12 @@ public class CommonBorderPaddingBackgrou
             hash = 37 * hash + backgroundAttachment;
             hash = 37 * hash + (backgroundColor == null ? 0 : backgroundColor.hashCode());
             hash = 37 * hash + (backgroundImage == null ? 0 : backgroundImage.hashCode());
-            hash = 37 * hash + (backgroundPositionHorizontal == null ? 0 : backgroundPositionHorizontal.hashCode());
-            hash = 37 * hash + (backgroundPositionVertical == null ? 0 : backgroundPositionVertical.hashCode());
+            hash = 37 * hash
+                + (backgroundPositionHorizontal == null
+                   ? 0 : backgroundPositionHorizontal.hashCode());
+            hash = 37 * hash
+                + (backgroundPositionVertical == null
+                   ? 0 : backgroundPositionVertical.hashCode());
             hash = 37 * hash + backgroundRepeat;
             hash = 37 * hash + (borderInfo[BEFORE] == null ? 0 : borderInfo[BEFORE].hashCode());
             hash = 37 * hash + (borderInfo[AFTER] == null ? 0 : borderInfo[AFTER].hashCode());

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonFont.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonFont.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonFont.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonFont.java Sat Aug 14 17:17:00 2010
@@ -37,7 +37,8 @@ public final class CommonFont {
 
     /** cache holding canonical CommonFont instances (only those with
      *  absolute font-size and font-size-adjust) */
-    private static final PropertyCache cache = new PropertyCache(CommonFont.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(CommonFont.class);
 
     /** hashcode of this instance */
     private int hash = 0;
@@ -61,10 +62,10 @@ public final class CommonFont {
     private final EnumProperty fontWeight;
 
     /** The "font-size" property. */
-    public final Length fontSize;
+    public final Length fontSize;                               // CSOK: VisibilityModifier
 
     /** The "font-size-adjust" property. */
-    public final Numeric fontSizeAdjust;
+    public final Numeric fontSizeAdjust;                        // CSOK: VisibilityModifier
 
 
     /**
@@ -79,7 +80,7 @@ public final class CommonFont {
      * @param fontSize  the font-size (possibly non-cached)
      * @param fontSizeAdjust    the font-size-adjust (possibly non-cached)
      */
-    private CommonFont(FontFamilyProperty fontFamily,
+    private CommonFont(FontFamilyProperty fontFamily,           // CSOK: ParameterNumber
                        EnumProperty fontSelectionStrategy,
                        EnumProperty fontStretch,
                        EnumProperty fontStyle,
@@ -110,7 +111,8 @@ public final class CommonFont {
      */
     public static CommonFont getInstance(PropertyList pList) throws PropertyException {
         FontFamilyProperty fontFamily = (FontFamilyProperty) pList.get(Constants.PR_FONT_FAMILY);
-        EnumProperty fontSelectionStrategy = (EnumProperty) pList.get(Constants.PR_FONT_SELECTION_STRATEGY);
+        EnumProperty fontSelectionStrategy
+            = (EnumProperty) pList.get(Constants.PR_FONT_SELECTION_STRATEGY);
         EnumProperty fontStretch = (EnumProperty) pList.get(Constants.PR_FONT_STRETCH);
         EnumProperty fontStyle = (EnumProperty) pList.get(Constants.PR_FONT_STYLE);
         EnumProperty fontVariant = (EnumProperty) pList.get(Constants.PR_FONT_VARIANT);
@@ -183,23 +185,22 @@ public final class CommonFont {
     /**
      * Create and return an array of <code>FontTriplets</code> based on
      * the properties stored in the instance variables.
-     *
-     * @param fontInfo
-     * @return a Font object.
+     * @param fontInfo a font info object
+     * @return a font triplet
      */
     public FontTriplet[] getFontState(FontInfo fontInfo) {
-        int font_weight;
+        int fw;
         switch (fontWeight.getEnum()) {
-        case Constants.EN_100: font_weight = 100; break;
-        case Constants.EN_200: font_weight = 200; break;
-        case Constants.EN_300: font_weight = 300; break;
-        case Constants.EN_400: font_weight = 400; break;
-        case Constants.EN_500: font_weight = 500; break;
-        case Constants.EN_600: font_weight = 600; break;
-        case Constants.EN_700: font_weight = 700; break;
-        case Constants.EN_800: font_weight = 800; break;
-        case Constants.EN_900: font_weight = 900; break;
-        default: font_weight = 400;
+        case Constants.EN_100: fw = 100; break;
+        case Constants.EN_200: fw = 200; break;
+        case Constants.EN_300: fw = 300; break;
+        case Constants.EN_400: fw = 400; break;
+        case Constants.EN_500: fw = 500; break;
+        case Constants.EN_600: fw = 600; break;
+        case Constants.EN_700: fw = 700; break;
+        case Constants.EN_800: fw = 800; break;
+        case Constants.EN_900: fw = 900; break;
+        default: fw = 400;
         }
 
         String style;
@@ -221,7 +222,7 @@ public final class CommonFont {
         //int fontVariant = propertyList.get("font-variant").getEnum();
         FontTriplet[] triplets = fontInfo.fontLookup(
                                     getFontFamily(),
-                                    style, font_weight);
+                                    style, fw);
         return triplets;
     }
 
@@ -259,7 +260,8 @@ public final class CommonFont {
             hash = 37 * hash + (fontSize == null ? 0 : fontSize.hashCode());
             hash = 37 * hash + (fontSizeAdjust == null ? 0 : fontSizeAdjust.hashCode());
             hash = 37 * hash + (fontFamily == null ? 0 : fontFamily.hashCode());
-            hash = 37 * hash + (fontSelectionStrategy == null ? 0 : fontSelectionStrategy.hashCode());
+            hash = 37 * hash + (fontSelectionStrategy == null
+                                ? 0 : fontSelectionStrategy.hashCode());
             hash = 37 * hash + (fontStretch == null ? 0 : fontStretch.hashCode());
             hash = 37 * hash + (fontStyle == null ? 0 : fontStyle.hashCode());
             hash = 37 * hash + (fontVariant == null ? 0 : fontVariant.hashCode());

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonHyphenation.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonHyphenation.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonHyphenation.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonHyphenation.java Sat Aug 14 17:17:00 2010
@@ -36,32 +36,34 @@ import org.apache.fop.fonts.Typeface;
 public final class CommonHyphenation {
 
     /** Logger */
-    protected static Log log = LogFactory.getLog(CommonHyphenation.class);
+    private static final Log log                                // CSOK: ConstantName
+        = LogFactory.getLog(CommonHyphenation.class);
 
-    private static final PropertyCache cache = new PropertyCache(CommonHyphenation.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(CommonHyphenation.class);
 
     private int hash = 0;
 
     /** The "language" property */
-    public final StringProperty language;
+    public final StringProperty language;                       // CSOK: VisibilityModifier
 
     /** The "country" property */
-    public final StringProperty country;
+    public final StringProperty country;                        // CSOK: VisibilityModifier
 
     /** The "script" property */
-    public final StringProperty script;
+    public final StringProperty script;                         // CSOK: VisibilityModifier
 
     /** The "hyphenate" property */
-    public final EnumProperty hyphenate;
+    public final EnumProperty hyphenate;                        // CSOK: VisibilityModifier
 
     /** The "hyphenation-character" property */
-    public final CharacterProperty hyphenationCharacter;
+    public final CharacterProperty hyphenationCharacter;        // CSOK: VisibilityModifier
 
     /** The "hyphenation-push-character-count" property */
-    public final NumberProperty hyphenationPushCharacterCount;
+    public final NumberProperty hyphenationPushCharacterCount;  // CSOK: VisibilityModifier
 
     /** The "hyphenation-remain-character-count" property*/
-    public final NumberProperty hyphenationRemainCharacterCount;
+    public final NumberProperty hyphenationRemainCharacterCount; // CSOK: VisibilityModifier
 
     /**
      * Construct a CommonHyphenation object holding the given properties
@@ -87,24 +89,26 @@ public final class CommonHyphenation {
      * Gets the canonical <code>CommonHyphenation</code> instance corresponding
      * to the values of the related properties present on the given
      * <code>PropertyList</code>
-     *
      * @param propertyList  the <code>PropertyList</code>
+     * @return a common hyphenation instance
+     * @throws PropertyException if a a property exception occurs
      */
-    public static CommonHyphenation getInstance(PropertyList propertyList) throws PropertyException {
-        StringProperty language =
-            (StringProperty) propertyList.get(Constants.PR_LANGUAGE);
-        StringProperty country =
-            (StringProperty) propertyList.get(Constants.PR_COUNTRY);
-        StringProperty script =
-            (StringProperty) propertyList.get(Constants.PR_SCRIPT);
-        EnumProperty hyphenate =
-            (EnumProperty) propertyList.get(Constants.PR_HYPHENATE);
-        CharacterProperty hyphenationCharacter =
-            (CharacterProperty) propertyList.get(Constants.PR_HYPHENATION_CHARACTER);
-        NumberProperty hyphenationPushCharacterCount =
-            (NumberProperty) propertyList.get(Constants.PR_HYPHENATION_PUSH_CHARACTER_COUNT);
-        NumberProperty hyphenationRemainCharacterCount =
-            (NumberProperty) propertyList.get(Constants.PR_HYPHENATION_REMAIN_CHARACTER_COUNT);
+    public static CommonHyphenation getInstance(PropertyList propertyList)
+        throws PropertyException {
+        StringProperty language
+            = (StringProperty) propertyList.get(Constants.PR_LANGUAGE);
+        StringProperty country
+            = (StringProperty) propertyList.get(Constants.PR_COUNTRY);
+        StringProperty script
+            = (StringProperty) propertyList.get(Constants.PR_SCRIPT);
+        EnumProperty hyphenate
+            = (EnumProperty) propertyList.get(Constants.PR_HYPHENATE);
+        CharacterProperty hyphenationCharacter
+            = (CharacterProperty) propertyList.get(Constants.PR_HYPHENATION_CHARACTER);
+        NumberProperty hyphenationPushCharacterCount
+            = (NumberProperty) propertyList.get(Constants.PR_HYPHENATION_PUSH_CHARACTER_COUNT);
+        NumberProperty hyphenationRemainCharacterCount
+            = (NumberProperty) propertyList.get(Constants.PR_HYPHENATION_REMAIN_CHARACTER_COUNT);
 
         CommonHyphenation instance = new CommonHyphenation(
                                 language,
@@ -209,12 +213,15 @@ public final class CommonHyphenation {
             hash = 37 * hash + (script == null ? 0 : script.hashCode());
             hash = 37 * hash + (country == null ? 0 : country.hashCode());
             hash = 37 * hash + (hyphenate == null ? 0 : hyphenate.hashCode());
-            hash = 37 * hash +
-                (hyphenationCharacter == null ? 0 : hyphenationCharacter.hashCode());
-            hash = 37 * hash +
-                (hyphenationPushCharacterCount == null ? 0 : hyphenationPushCharacterCount.hashCode());
-            hash = 37 * hash +
-                (hyphenationRemainCharacterCount == null ? 0 : hyphenationRemainCharacterCount.hashCode());
+            hash = 37 * hash
+                + (hyphenationCharacter == null
+                   ? 0 : hyphenationCharacter.hashCode());
+            hash = 37 * hash
+                + (hyphenationPushCharacterCount == null
+                 ? 0 : hyphenationPushCharacterCount.hashCode());
+            hash = 37 * hash
+                + (hyphenationRemainCharacterCount == null
+                 ? 0 : hyphenationRemainCharacterCount.hashCode());
             this.hash = hash;
         }
         return this.hash;

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonMarginBlock.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonMarginBlock.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonMarginBlock.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonMarginBlock.java Sat Aug 14 17:17:00 2010
@@ -33,46 +33,47 @@ public class CommonMarginBlock {
     /**
      * The "margin-top" property.
      */
-    public Length marginTop;
+    public Length marginTop;                                    // CSOK: VisibilityModifier
 
     /**
      * The "margin-bottom" property.
      */
-    public Length marginBottom;
+    public Length marginBottom;                                 // CSOK: VisibilityModifier
 
     /**
      * The "margin-left" property.
      */
-    public Length marginLeft;
+    public Length marginLeft;                                   // CSOK: VisibilityModifier
 
     /**
      * The "margin-right" property.
      */
-    public Length marginRight;
+    public Length marginRight;                                  // CSOK: VisibilityModifier
 
     /**
      * The "space-before" property.
      */
-    public SpaceProperty spaceBefore;
+    public SpaceProperty spaceBefore;                           // CSOK: VisibilityModifier
 
     /**
      * The "space-after" property.
      */
-    public SpaceProperty spaceAfter;
+    public SpaceProperty spaceAfter;                            // CSOK: VisibilityModifier
 
     /**
      * The "start-indent" property.
      */
-    public Length startIndent;
+    public Length startIndent;                                  // CSOK: VisibilityModifier
 
     /**
      * The "end-indent" property.
      */
-    public Length endIndent;
+    public Length endIndent;                                    // CSOK: VisibilityModifier
 
     /**
      * Create a CommonMarginBlock object.
      * @param pList The PropertyList with propery values.
+     * @throws PropertyException if a property exception occurs
      */
     public CommonMarginBlock(PropertyList pList) throws PropertyException {
         marginTop = pList.get(Constants.PR_MARGIN_TOP).getLength();

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonMarginInline.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonMarginInline.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonMarginInline.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonMarginInline.java Sat Aug 14 17:17:00 2010
@@ -34,36 +34,37 @@ public class CommonMarginInline {
     /**
      * The "margin-top" property.
      */
-    public Length marginTop;
+    public Length marginTop;                                    // CSOK: VisibilityModifier
 
     /**
      * The "margin-bottom" property.
      */
-    public Length marginBottom;
+    public Length marginBottom;                                 // CSOK: VisibilityModifier
 
     /**
      * The "margin-left" property.
      */
-    public Length marginLeft;
+    public Length marginLeft;                                   // CSOK: VisibilityModifier
 
     /**
      * The "margin-right" property.
      */
-    public Length marginRight;
+    public Length marginRight;                                  // CSOK: VisibilityModifier
 
     /**
      * The "space-start" property.
      */
-    public SpaceProperty spaceStart;
+    public SpaceProperty spaceStart;                            // CSOK: VisibilityModifier
 
     /**
      * The "space-end" property.
      */
-    public SpaceProperty spaceEnd;
+    public SpaceProperty spaceEnd;                              // CSOK: VisibilityModifier
 
     /**
      * Create a CommonMarginInline object.
      * @param pList The PropertyList with propery values.
+     * @throws PropertyException if a property exception occurs
      */
     public CommonMarginInline(PropertyList pList) throws PropertyException {
         marginTop = pList.get(Constants.PR_MARGIN_TOP).getLength();

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonRelativePosition.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonRelativePosition.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonRelativePosition.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CommonRelativePosition.java Sat Aug 14 17:17:00 2010
@@ -33,31 +33,32 @@ public class CommonRelativePosition {
     /**
      * The "relative-position" property.
      */
-    public int relativePosition;
+    public int relativePosition;                                // CSOK: VisibilityModifier
 
     /**
      * The "top" property.
      */
-    public Length top;
+    public Length top;                                          // CSOK: VisibilityModifier
 
     /**
      * The "right" property.
      */
-    public Length right;
+    public Length right;                                        // CSOK: VisibilityModifier
 
     /**
      * The "bottom" property.
      */
-    public Length bottom;
+    public Length bottom;                                       // CSOK: VisibilityModifier
 
     /**
      * The "left" property.
      */
-    public Length left;
+    public Length left;                                         // CSOK: VisibilityModifier
 
     /**
      * Create a CommonRelativePosition object.
      * @param pList The PropertyList with propery values.
+     * @throws PropertyException if a property exception occurs
      */
     public CommonRelativePosition(PropertyList pList) throws PropertyException {
         relativePosition = pList.get(Constants.PR_RELATIVE_POSITION).getEnum();

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CompoundPropertyMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CompoundPropertyMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CompoundPropertyMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CompoundPropertyMaker.java Sat Aug 14 17:17:00 2010
@@ -32,8 +32,8 @@ public class CompoundPropertyMaker exten
     /**
      *  The list of subproperty makers supported by this compound maker.
      */
-    private PropertyMaker[] subproperties =
-                    new PropertyMaker[Constants.COMPOUND_COUNT];
+    private PropertyMaker[] subproperties
+        = new PropertyMaker[Constants.COMPOUND_COUNT];
 
     /**
      *  The first subproperty maker which has a setByShorthand of true.
@@ -66,7 +66,7 @@ public class CompoundPropertyMaker exten
 
     /**
      * Add a subproperty to this maker.
-     * @param subproperty
+     * @param subproperty the sub property
      */
     public void addSubpropMaker(PropertyMaker subproperty) {
         // Place the base propId in the propId of the subproperty.
@@ -105,8 +105,7 @@ public class CompoundPropertyMaker exten
      * @return the array index.
      */
     private int getSubpropIndex(int subpropertyId) {
-        return ((subpropertyId & Constants.COMPOUND_MASK) >>
-                                    Constants.COMPOUND_SHIFT)-1;
+        return ((subpropertyId & Constants.COMPOUND_MASK) >> Constants.COMPOUND_SHIFT) - 1;
     }
 
     /**
@@ -137,11 +136,12 @@ public class CompoundPropertyMaker exten
      * @param propertyList The PropertyList object being built for this FO.
      * @param tryInherit true if inherited properties should be examined.
      * @param tryDefault true if the default value should be returned.
+     * @return the property
+     * @throws PropertyException if a property exception occurs
      */
     public Property get(int subpropertyId, PropertyList propertyList,
                         boolean tryInherit, boolean tryDefault)
-        throws PropertyException
-    {
+        throws PropertyException {
         Property p = super.get(subpropertyId, propertyList, tryInherit, tryDefault);
         if (subpropertyId != 0 && p != null) {
             p = getSubprop(p, subpropertyId);
@@ -261,7 +261,8 @@ public class CompoundPropertyMaker exten
             PropertyMaker subpropertyMaker = subproperties[i];
             if (subpropertyMaker != null) {
                 Property subproperty = subpropertyMaker.make(propertyList);
-                data.setComponent(subpropertyMaker.getPropId() & Constants.COMPOUND_MASK, subproperty, true);
+                data.setComponent(subpropertyMaker.getPropId()
+                                  & Constants.COMPOUND_MASK, subproperty, true);
             }
         }
         return p;

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CondLengthProperty.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CondLengthProperty.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CondLengthProperty.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CondLengthProperty.java Sat Aug 14 17:17:00 2010
@@ -33,7 +33,8 @@ import org.apache.fop.fo.expr.PropertyEx
 public class CondLengthProperty extends Property implements CompoundDatatype {
 
     /** cache holding canonical instances (for absolute conditional lengths) */
-    private static final PropertyCache cache = new PropertyCache(CondLengthProperty.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(CondLengthProperty.class);
 
     /** components */
     private Property length;

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CorrespondingPropertyMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CorrespondingPropertyMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CorrespondingPropertyMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/CorrespondingPropertyMaker.java Sat Aug 14 17:17:00 2010
@@ -27,23 +27,38 @@ import org.apache.fop.fo.expr.PropertyEx
 /**
  */
 public class CorrespondingPropertyMaker {
+    /** base property maker */
     protected PropertyMaker baseMaker;
-    protected int lr_tb;
-    protected int rl_tb;
-    protected int tb_rl;
+    /** corresponding property for lr-tb writing mode */
+    protected int lrtb;
+    /** corresponding property for rl-tb writing mode */
+    protected int rltb;
+    /** corresponding property for tb-rl writing mode */
+    protected int tbrl;
+    /** user parent property list */
     protected boolean useParent;
     private boolean relative;
 
+    /**
+     * Construct a corresponding property maker.
+     * @param baseMaker the base property maker
+     */
     public CorrespondingPropertyMaker(PropertyMaker baseMaker) {
         this.baseMaker = baseMaker;
         baseMaker.setCorresponding(this);
     }
 
 
-    public void setCorresponding(int lr_tb, int rl_tb, int tb_rl) {
-        this.lr_tb = lr_tb;
-        this.rl_tb = rl_tb;
-        this.tb_rl = tb_rl;
+    /**
+     * Set corresponding property identifiers.
+     * @param lrtb the property that corresponds with lr-tb writing mode
+     * @param rltb the property that corresponds with rl-tb writing mode
+     * @param tbrl the property that corresponds with tb-lr writing mode
+     */
+    public void setCorresponding(int lrtb, int rltb, int tbrl) {
+        this.lrtb = lrtb;
+        this.rltb = rltb;
+        this.tbrl = tbrl;
     }
 
     /**
@@ -55,6 +70,10 @@ public class CorrespondingPropertyMaker 
         this.useParent = useParent;
     }
 
+    /**
+     * Set relative flag.
+     * @param relative true if relative direction
+     */
     public void setRelative(boolean relative) {
         this.relative = relative;
     }
@@ -83,7 +102,7 @@ public class CorrespondingPropertyMaker 
 
         PropertyList pList = getWMPropertyList(propertyList);
         if (pList != null) {
-            int correspondingId = pList.getWritingMode(lr_tb, rl_tb, tb_rl);
+            int correspondingId = pList.getWritingMode(lrtb, rltb, tbrl);
 
             if (pList.getExplicit(correspondingId) != null) {
                 return true;
@@ -100,14 +119,14 @@ public class CorrespondingPropertyMaker 
      * @param propertyList The PropertyList for the FO.
      * @return Property A computed Property value or null if no rules
      * are specified (in foproperties.xml) to compute the value.
-     * @throws FOPException for invalid or inconsistent FO input
+     * @throws PropertyException if a property exception occurs
      */
     public Property compute(PropertyList propertyList) throws PropertyException {
         PropertyList pList = getWMPropertyList(propertyList);
         if (pList == null) {
             return null;
         }
-        int correspondingId = pList.getWritingMode(lr_tb, rl_tb, tb_rl);
+        int correspondingId = pList.getWritingMode(lrtb, rltb, tbrl);
 
         Property p = propertyList.getExplicitOrShorthand(correspondingId);
         if (p != null) {
@@ -120,6 +139,8 @@ public class CorrespondingPropertyMaker 
     /**
      * Return the property list to use for fetching writing mode depending property
      * ids.
+     * @param pList a property list
+     * @return the property list to use
      */
     protected PropertyList getWMPropertyList(PropertyList pList) {
         if (useParent) {

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/DimensionPropertyMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/DimensionPropertyMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/DimensionPropertyMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/DimensionPropertyMaker.java Sat Aug 14 17:17:00 2010
@@ -30,27 +30,44 @@ import org.apache.fop.fo.expr.PropertyEx
  * Window - Preferences - Java - Code Generation - Code and Comments
  */
 public class DimensionPropertyMaker extends CorrespondingPropertyMaker {
-    int[][] extraCorresponding = null;
+    
+    private int[][] extraCorresponding = null;
 
+    /**
+     * Construct a dimension property maker.
+     * @param baseMaker the base property maker
+     */
     public DimensionPropertyMaker(PropertyMaker baseMaker) {
         super(baseMaker);
     }
 
+    /**
+     * Set extra correspondences.
+     * @param extraCorresponding the extra correspondences
+     */
     public void setExtraCorresponding(int[][] extraCorresponding) {
         this.extraCorresponding = extraCorresponding;
     }
 
+    /**
+     * Determine if corresponding property is forced.
+     * @param propertyList the property list to use
+     * @return true if it is forced
+     */
     public boolean isCorrespondingForced(PropertyList propertyList) {
-        if (super.isCorrespondingForced(propertyList))
+        if (super.isCorrespondingForced(propertyList)) {
             return true;
+        }
         for (int i = 0; i < extraCorresponding.length; i++) {
             int wmcorr = extraCorresponding[i][0]; //propertyList.getWritingMode()];
-            if (propertyList.getExplicit(wmcorr) != null)
+            if (propertyList.getExplicit(wmcorr) != null) {
                 return true;
+            }
         }
         return false;
     }
 
+    /** {@inheritDoc} */
     public Property compute(PropertyList propertyList) throws PropertyException {
         // Based on [width|height]
         Property p = super.compute(propertyList);

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumLength.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumLength.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumLength.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumLength.java Sat Aug 14 17:17:00 2010
@@ -27,6 +27,10 @@ import org.apache.fop.datatypes.PercentB
 public class EnumLength extends LengthProperty {
     private Property enumProperty;
 
+    /**
+     * Construct an enumerated length from an enum property.
+     * @param enumProperty the enumeration property
+     */
     public EnumLength(Property enumProperty) {
         this.enumProperty = enumProperty;
     }
@@ -38,6 +42,7 @@ public class EnumLength extends LengthPr
         return enumProperty.getEnum();
     }
 
+    /** @return true if absolute */
     public boolean isAbsolute() {
         return false;
     }

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumNumber.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumNumber.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumNumber.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumNumber.java Sat Aug 14 17:17:00 2010
@@ -29,7 +29,8 @@ import org.apache.fop.fo.expr.PropertyEx
 public final class EnumNumber extends Property implements Numeric {
 
     /** cache holding all canonical EnumNumber instances */
-    private static final PropertyCache cache = new PropertyCache(EnumNumber.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(EnumNumber.class);
 
     private final EnumProperty enumProperty;
 

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumProperty.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumProperty.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumProperty.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/EnumProperty.java Sat Aug 14 17:17:00 2010
@@ -29,7 +29,8 @@ import org.apache.fop.fo.expr.PropertyEx
 public final class EnumProperty extends Property {
 
     /** cache holding all canonical EnumProperty instances */
-    private static final PropertyCache cache = new PropertyCache(EnumProperty.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(EnumProperty.class);
 
     /**
      * Inner class for creating EnumProperty instances
@@ -54,6 +55,14 @@ public final class EnumProperty extends 
             return super.checkEnumValues(value);
         }
 
+        /**
+         * Convert a property.
+         * @param p the property to convert
+         * @param propertyList the property list to use in conversion
+         * @param fo the FO to use in conversion
+         * @return the converted property
+         * @throws PropertyException if a property conversion exception occurs
+         */
         public Property convertProperty(Property p,
                                         PropertyList propertyList,
                                         FObj fo) throws PropertyException {
@@ -77,6 +86,12 @@ public final class EnumProperty extends 
         this.text = text;
     }
 
+    /**
+     * Construct an enumeration property.
+     * @param explicitValue the value
+     * @param text the text
+     * @return an enumeration property
+     */
     public static EnumProperty getInstance(int explicitValue, String text) {
         return (EnumProperty) cache.fetch(
                         new EnumProperty(explicitValue, text));

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FixedLength.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FixedLength.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FixedLength.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FixedLength.java Sat Aug 14 17:17:00 2010
@@ -45,7 +45,8 @@ public final class FixedLength extends L
     public static final String MPT = "mpt";
 
     /** cache holding all canonical FixedLength instances */
-    private static final PropertyCache cache = new PropertyCache(FixedLength.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(FixedLength.class);
 
     /** canonical zero-length instance */
     public static final FixedLength ZERO_FIXED_LENGTH = new FixedLength(0, FixedLength.MPT, 1.0f);

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontFamilyProperty.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontFamilyProperty.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontFamilyProperty.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontFamilyProperty.java Sat Aug 14 17:17:00 2010
@@ -31,7 +31,8 @@ import org.apache.fop.fo.expr.PropertyEx
 public final class FontFamilyProperty extends ListProperty {
 
     /** cache holding all canonical FontFamilyProperty instances */
-    private static final PropertyCache cache = new PropertyCache(FontFamilyProperty.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(FontFamilyProperty.class);
 
     private int hash = 0;
 
@@ -50,7 +51,8 @@ public final class FontFamilyProperty ex
         /**
          * {@inheritDoc}
          */
-        public Property make(PropertyList propertyList, String value, FObj fo) throws PropertyException {
+        public Property make(PropertyList propertyList, String value, FObj fo)
+            throws PropertyException {
             if ("inherit".equals(value)) {
                 return super.make(propertyList, value, fo);
             } else {

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontSizePropertyMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontSizePropertyMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontSizePropertyMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontSizePropertyMaker.java Sat Aug 14 17:17:00 2010
@@ -50,7 +50,8 @@ public class FontSizePropertyMaker
      * here already: if the property evaluates to a {@link PercentLength},
      * it is immediately replaced by the resolved {@link FixedLength}.
      */
-    public Property make(PropertyList propertyList, String value, FObj fo) throws PropertyException {
+    public Property make(PropertyList propertyList, String value, FObj fo)
+        throws PropertyException {
         Property p = super.make(propertyList, value, fo);
         if (p instanceof PercentLength) {
             Property pp = propertyList.getFromParent(this.propId);

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontWeightPropertyMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontWeightPropertyMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontWeightPropertyMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/FontWeightPropertyMaker.java Sat Aug 14 17:17:00 2010
@@ -13,7 +13,8 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *
+ */
+
 /* $Id$ */
 
 package org.apache.fop.fo.properties;
@@ -25,6 +26,9 @@ import org.apache.fop.fo.expr.PropertyEx
 import org.apache.fop.fo.expr.PropertyInfo;
 import org.apache.fop.fo.expr.PropertyParser;
 
+/**
+ * Font weight property maker.
+ */
 public class FontWeightPropertyMaker extends EnumProperty.Maker {
 
     /**
@@ -45,10 +49,8 @@ public class FontWeightPropertyMaker ext
         } else {
             String pValue = checkValueKeywords(value);
             Property newProp = checkEnumValues(pValue);
-            int enumValue = -1;
-            if (newProp != null
-                    && ((enumValue = newProp.getEnum()) == Constants.EN_BOLDER
-                        || enumValue == Constants.EN_LIGHTER)) {
+            int enumValue = ( newProp != null ) ? newProp.getEnum() : -1;
+            if (enumValue == Constants.EN_BOLDER || enumValue == Constants.EN_LIGHTER) {
                 /* check for relative enum values, compute in relation to parent */
                 Property parentProp = pList.getInherited(Constants.PR_FONT_WEIGHT);
                 if (enumValue == Constants.EN_BOLDER) {

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/IndentPropertyMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/IndentPropertyMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/IndentPropertyMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/IndentPropertyMaker.java Sat Aug 14 17:17:00 2010
@@ -68,6 +68,9 @@ public class IndentPropertyMaker extends
 
     /**
      * Calculate the corresponding value for start-indent and end-indent.
+     * @param propertyList the property list to use in the computation
+     * @return the computed indent property
+     * @throws PropertyException if a property exception occurs
      * @see CorrespondingPropertyMaker#compute(PropertyList)
      */
     public Property compute(PropertyList propertyList) throws PropertyException {
@@ -81,6 +84,9 @@ public class IndentPropertyMaker extends
 
     /**
      * Calculate the corresponding value for start-indent and end-indent.
+     * @param propertyList the property list to use in the computation
+     * @return the computed indent property
+     * @throws PropertyException if a property exception occurs
      * @see CorrespondingPropertyMaker#compute(PropertyList)
      */
     public Property computeConforming(PropertyList propertyList) throws PropertyException {
@@ -93,7 +99,7 @@ public class IndentPropertyMaker extends
         Numeric padding = getCorresponding(paddingCorresponding, propertyList).getNumeric();
         Numeric border = getCorresponding(borderWidthCorresponding, propertyList).getNumeric();
 
-        int marginProp = pList.getWritingMode(lr_tb, rl_tb, tb_rl);
+        int marginProp = pList.getWritingMode(lrtb, rltb, tbrl);
         // Calculate the absolute margin.
         if (propertyList.getExplicitOrShorthand(marginProp) == null) {
             Property indent = propertyList.getExplicit(baseMaker.propId);
@@ -136,6 +142,9 @@ public class IndentPropertyMaker extends
      * This method calculates indent following an alternative rule set that
      * tries to mimic many commercial solutions that chose to violate the
      * XSL specification.
+     * @param propertyList the property list to use in the computation
+     * @return the computed indent property
+     * @throws PropertyException if a property exception occurs
      * @see CorrespondingPropertyMaker#compute(PropertyList)
      */
     public Property computeAlternativeRuleset(PropertyList propertyList) throws PropertyException {
@@ -149,7 +158,7 @@ public class IndentPropertyMaker extends
         Numeric padding = getCorresponding(paddingCorresponding, propertyList).getNumeric();
         Numeric border = getCorresponding(borderWidthCorresponding, propertyList).getNumeric();
 
-        int marginProp = pList.getWritingMode(lr_tb, rl_tb, tb_rl);
+        int marginProp = pList.getWritingMode(lrtb, rltb, tbrl);
 
         //Determine whether the nearest anscestor indent was specified through
         //start-indent|end-indent or through a margin property.

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/KeepProperty.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/KeepProperty.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/KeepProperty.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/KeepProperty.java Sat Aug 14 17:17:00 2010
@@ -30,7 +30,8 @@ import org.apache.fop.fo.expr.PropertyEx
 public final class KeepProperty extends Property implements CompoundDatatype {
 
     /** class holding all canonical KeepProperty instances*/
-    private static final PropertyCache cache = new PropertyCache(KeepProperty.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(KeepProperty.class);
 
     private boolean isCachedValue = false;
     private Property withinLine;
@@ -61,8 +62,7 @@ public final class KeepProperty extends 
          * {@inheritDoc}
          */
         public Property convertProperty(Property p, PropertyList propertyList, FObj fo)
-            throws PropertyException
-        {
+            throws PropertyException {
             if (p instanceof KeepProperty) {
                 return p;
             }
@@ -154,10 +154,10 @@ public final class KeepProperty extends 
      * @return String representation
      */
     public String toString() {
-        return "Keep[" +
-            "withinLine:" + getWithinLine().getObject() +
-            ", withinColumn:" + getWithinColumn().getObject() +
-            ", withinPage:" + getWithinPage().getObject() + "]";
+        return "Keep["
+            + "withinLine:" + getWithinLine().getObject()
+            + ", withinColumn:" + getWithinColumn().getObject()
+            + ", withinPage:" + getWithinPage().getObject() + "]";
     }
 
     /**

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/LineHeightPropertyMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/LineHeightPropertyMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/LineHeightPropertyMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/LineHeightPropertyMaker.java Sat Aug 14 17:17:00 2010
@@ -64,6 +64,7 @@ public class LineHeightPropertyMaker ext
     /**
      * Recalculate the line-height value based on the nearest specified
      * value.
+     * {@inheritDoc}
      */
     protected Property compute(PropertyList propertyList) throws PropertyException {
         // recalculate based on last specified value

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/NumberProperty.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/NumberProperty.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/NumberProperty.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/NumberProperty.java Sat Aug 14 17:17:00 2010
@@ -68,6 +68,9 @@ public final class NumberProperty extend
 
     }
 
+    /**
+     * A positive integer property maker.
+     */
     public static class PositiveIntegerMaker extends PropertyMaker {
 
         /**
@@ -103,7 +106,8 @@ public final class NumberProperty extend
     }
 
     /** cache holding all canonical NumberProperty instances */
-    private static final PropertyCache cache = new PropertyCache(NumberProperty.class);
+    private static final PropertyCache cache                    // CSOK: ConstantName
+        = new PropertyCache(NumberProperty.class);
 
     private final Number number;
 

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PageDimensionMaker.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PageDimensionMaker.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PageDimensionMaker.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PageDimensionMaker.java Sat Aug 14 17:17:00 2010
@@ -43,7 +43,13 @@ public class PageDimensionMaker extends 
      * Check the value of the page-width / page-height property.
      * Return the default or user-defined fallback in case the value
      * was specified as "auto"
-     *
+     * @param subpropId  The subproperty id of the property being retrieved.
+     *        Is 0 when retriving a base property.
+     * @param propertyList The PropertyList object being built for this FO.
+     * @param tryInherit true if inherited properties should be examined.
+     * @param tryDefault true if the default value should be returned.
+     * @return the property
+     * @throws PropertyException if a property exception occurs
      * @see PropertyMaker#get(int, PropertyList, boolean, boolean)
      */
     public Property get(int subpropId, PropertyList propertyList,

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PercentLength.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PercentLength.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PercentLength.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PercentLength.java Sat Aug 14 17:17:00 2010
@@ -118,8 +118,7 @@ public class PercentLength extends Lengt
      * @return the String equivalent of this
      */
     public String toString() {
-        StringBuffer sb =
-            new StringBuffer(PercentLength.class.getName())
+        StringBuffer sb = new StringBuffer(PercentLength.class.getName())
                 .append("[factor=").append(factor)
                 .append(",lbase=").append(lbase).append("]");
         return sb.toString();

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PropertyCache.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PropertyCache.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PropertyCache.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/PropertyCache.java Sat Aug 14 17:17:00 2010
@@ -98,8 +98,13 @@ public final class PropertyCache {
     }
 
     /* Wrapper objects to synchronize on */
-    private static class CacheSegment {
+    private static final class CacheSegment {
+        CacheSegment() {
+        }
         private int count = 0;
+        int getCount() {
+            return count;
+        }
     }
 
     private void cleanSegment(int segmentIndex) {
@@ -209,10 +214,11 @@ public final class PropertyCache {
 
         /* try non-synched first */
         for (CacheEntry e = entry; e != null; e = e.nextEntry) {
-            if (e.hash == hash
-                    && (q = e.get()) != null
-                    &&  eq(q, o)) {
-                return q;
+            if ( e.hash == hash ) {
+                q = e.get();
+                if ( ( q != null ) &&  eq ( q, o ) ) {
+                    return q;
+                }
             }
         }
 
@@ -223,10 +229,11 @@ public final class PropertyCache {
         synchronized (segment) {
             entry = table[index];
             for (CacheEntry e = entry; e != null; e = e.nextEntry) {
-                if (e.hash == hash
-                        && (q = e.get()) != null
-                        &&  eq(q, o)) {
-                    return q;
+                if ( e.hash == hash ) {
+                    q = e.get();
+                    if ( ( q != null ) &&  eq ( q, o ) ) {
+                        return q;
+                    }
                 }
             }
         }
@@ -261,7 +268,8 @@ public final class PropertyCache {
                     newLength--;
                     for (int i = table.length; --i >= 0;) {
                         for (CacheEntry c = table[i]; c != null; c = c.nextEntry) {
-                            if ((o = c.get()) != null) {
+                            o = c.get();
+                            if (o != null) {
                                 hash = c.hash;
                                 idx = hash & newLength;
                                 newTable[idx] = new CacheEntry(o, newTable[idx]);
@@ -384,7 +392,7 @@ public final class PropertyCache {
     }
 
     /**
-     *  Checks if the given {@link Marker.MarkerAttribute} is present
+     *  Checks if the given {@link org.apache.fop.fo.flow.Marker.MarkerAttribute} is present
      *  in the cache - if so, returns a reference to the cached instance.
      *  Otherwise the given object is added to the cache and returned.
      *

Modified: xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/ShorthandParser.java
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/ShorthandParser.java?rev=985537&r1=985536&r2=985537&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/ShorthandParser.java (original)
+++ xmlgraphics/fop/trunk/src/java/org/apache/fop/fo/properties/ShorthandParser.java Sat Aug 14 17:17:00 2010
@@ -30,9 +30,11 @@ public interface ShorthandParser {
 
     /**
      * @param propId the property ID in the Constants interface
+     * @param property from which value is obtained
      * @param maker Maker object for the Property
      * @param propertyList list of properties
      * @return Property object corresponding to propName
+     * @throws PropertyException in case a property exception occurs
      */
     Property getValueForProperty(int propId,
                                  Property property,



---------------------------------------------------------------------
To unsubscribe, e-mail: fop-commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: fop-commits-help@xmlgraphics.apache.org