<commit_before>package com.thoughtworks.xstream.io.xml;

import java.util.Iterator;
import java.util.List;

import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;


/**
 * A generic interface for all {@link HierarchicalStreamReader} implementations reading a DOM.
 * 
 * @author <NAME>
 * @since upcoming
 */
public interface DocumentReader extends HierarchicalStreamReader {

    /**
     * Retrieve the current element. In the standrad use case this list will only contain a single element.
     * Additional elements can only occur, if {@link HierarchicalStreamWriter#startNode(String)} of the implementing
     * {@link HierarchicalStreamWriter} was called multiple times with an empty node stack. Such a situation occurs
     * calling {@link com.thoughtworks.xstream.XStream#marshal(Object, HierarchicalStreamWriter)} multiple times
     * directly.
     * 
     * @return a {@link List} with top nodes
     * @since upcoming
     */
    public Object getCurrent();
}<commit_msg>Fix javadoc.<commit_after>package com.thoughtworks.xstream.io.xml;

import com.thoughtworks.xstream.io.HierarchicalStreamReader;


/**
 * A generic interface for all {@link HierarchicalStreamReader} implementations reading a DOM.
 * 
 * @author J&ouml;<NAME>
 * @since upcoming
 */
public interface DocumentReader extends HierarchicalStreamReader {

    /**
     * Retrieve the current processed node of the DOM.
     * 
     * @return the current node
     * @since upcoming
     */
    public Object getCurrent();
}
{'fraction_non_alphanumeric': 0.08795411089866156, 'fraction_numerical': 0.0, 'mean_word_length': 3.952681388012618, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5013015', 'n_tokens_mistral': 438, 'n_tokens_neox': 416, 'n_words': 134}