Bug 61937: Add more javadoc

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

diff --git a/src/ooxml/java/org/apache/poi/xssf/eventusermodel/XSSFSheetXMLHandler.java b/src/ooxml/java/org/apache/poi/xssf/eventusermodel/XSSFSheetXMLHandler.java
index 2c8e0e2d37dcdda194da7ff26cd96ee44f8b0bec..64c5afacdef5c73de78e845b09bc180e6b36a006 100644 (file)
--- a/src/ooxml/java/org/apache/poi/xssf/eventusermodel/XSSFSheetXMLHandler.java
+++ b/src/ooxml/java/org/apache/poi/xssf/eventusermodel/XSSFSheetXMLHandler.java
@@ -511,7 +511,13 @@ public class XSSFSheetXMLHandler extends DefaultHandler {
 
       /**
        * A cell, with the given formatted value (may be null), 
-       *  and possibly a comment (may be null), was encountered */
+       * and possibly a comment (may be null), was encountered.
+       *
+       * Sheets that have missing or empty cells may result in
+       * sparse calls to <code>cell</code>. See the code in
+       * <code>src/examples/src/org/apache/poi/xssf/eventusermodel/XLSX2CSV.java</code>
+       * for an example of how to handle this scenario.
+       */
       public void cell(String cellReference, String formattedValue, XSSFComment comment);
 
       /** A header or footer has been encountered */