javadocs

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

contrib/dataimporthandler/src/main/java/org/apache/solr/handler/dataimport/XPathRecordReader.java

@@ -185,6 +185,10 @@ public class XPathRecordReader {
           }
         }
         Set<Node> childrenFound = new HashSet<Node>();
+        // for any normal event , parser.next() should be called in each iteration.
+        // But for CDATA | CHARACTERS | SPACE it should not do so because handling of
+        // CDATA itself would have consumed the next event. CDATA may throw multiple events
+        // so all the events are slurped till a  START_ELEMENT is encountered.
         boolean skipNextEvent = false;
         int event = -1;
         while (true) {