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 2c8e0e2d37..64c5afacde 100644 --- 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 cell. See the code in + * src/examples/src/org/apache/poi/xssf/eventusermodel/XLSX2CSV.java + * 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 */