add comments
diff --git a/src/main/java/org/yaml/snakeyaml/constructor/Construct.java b/src/main/java/org/yaml/snakeyaml/constructor/Construct.java
index 55e27b0..1913e5c 100644
--- a/src/main/java/org/yaml/snakeyaml/constructor/Construct.java
+++ b/src/main/java/org/yaml/snakeyaml/constructor/Construct.java
@@ -5,6 +5,21 @@
import org.yaml.snakeyaml.nodes.Node;
+/**
+ * Provide a way to construct a Java instance out of the composed Node. Support
+ * recursive objects if it is required. (create Native Data Structure out of
+ * Node Graph)
+ *
+ * @see http://yaml.org/spec/1.1/#id859109
+ */
public interface Construct {
+ /**
+ * Construct a Java instance with all the properties injected when it is
+ * possible.
+ *
+ * @param node
+ * - composed Node
+ * @return a complete Java instance
+ */
public Object construct(Node node);
}
diff --git a/src/main/java/org/yaml/snakeyaml/constructor/SafeConstructor.java b/src/main/java/org/yaml/snakeyaml/constructor/SafeConstructor.java
index d065bd6..7d6fd90 100644
--- a/src/main/java/org/yaml/snakeyaml/constructor/SafeConstructor.java
+++ b/src/main/java/org/yaml/snakeyaml/constructor/SafeConstructor.java
@@ -23,6 +23,8 @@
import org.yaml.snakeyaml.util.Base64Coder;
/**
+ * Construct standard Java classes
+ *
* @see <a href="http://pyyaml.org/wiki/PyYAML">PyYAML</a> for more information
*/
public class SafeConstructor extends BaseConstructor {
diff --git a/src/main/java/org/yaml/snakeyaml/nodes/MappingNode.java b/src/main/java/org/yaml/snakeyaml/nodes/MappingNode.java
index 79f3c77..9304b42 100644
--- a/src/main/java/org/yaml/snakeyaml/nodes/MappingNode.java
+++ b/src/main/java/org/yaml/snakeyaml/nodes/MappingNode.java
@@ -32,6 +32,7 @@
@SuppressWarnings("unchecked")
@Override
+ // TODO should we return Tuple instead of array ?
public List<Node[]> getValue() {
List<Node[]> mapping = (List<Node[]>) super.getValue();
for (Node[] nodes : mapping) {