src/java.desktop/share/classes/javax/swing/text/ZoneView.java

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -92,10 +92,11 @@
         loadedZones = new Vector<View>();
     }
 
     /**
      * Get the current maximum zone size.
+     * @return the current maximum zone size
      */
     public int getMaximumZoneSize() {
         return maxZoneSize;
     }
 

@@ -115,10 +116,12 @@
     }
 
     /**
      * Get the current setting of the number of zones
      * allowed to be loaded at the same time.
+     * @return current setting of the number of zones
+     * allowed to be loaded at the same time
      */
     public int getMaxZonesLoaded() {
         return maxZonesLoaded;
     }
 

@@ -182,10 +185,13 @@
      * Determine if a zone is in the loaded state.
      * The zones are expected to represent a subset of the
      * child elements of the element this view is responsible for.
      * Therefore, the default implementation is to return
      * true if the view has children.
+     * param zone the child view
+     * @param zone the zone
+     * @return whether or not the zone is in the loaded state.
      */
     protected boolean isZoneLoaded(View zone) {
         return (zone.getViewCount() > 0);
     }
 

@@ -201,10 +207,12 @@
      *  be >= getStartOffset() and < getEndOffset().  This
      *  value should also be < p1.
      * @param p1 the end of the desired zone.  This should
      *  be > getStartOffset() and <= getEndOffset().  This
      *  value should also be > p0.
+     * @return a view to represent a zone for the given range within
+     * the model
      */
     protected View createZone(int p0, int p1) {
         Document doc = getDocument();
         View zone;
         try {