# HG changeset patch
# User Doug Simon <doug.simon@oracle.com>
# Date 1334923962 -7200
# Node ID 97b1e0ab7442b4cc57b858cfa0e2ac84f002aff1
# Parent  a549662f6c6f9e3523bc940dedced6d2c7a4357a
added javadoc to some of the API for removing nodes from a graph

diff -r a549662f6c6f -r 97b1e0ab7442 graal/com.oracle.graal.graph/src/com/oracle/graal/graph/Node.java
--- a/graal/com.oracle.graal.graph/src/com/oracle/graal/graph/Node.java	Fri Apr 20 14:10:57 2012 +0200
+++ b/graal/com.oracle.graal.graph/src/com/oracle/graal/graph/Node.java	Fri Apr 20 14:12:42 2012 +0200
@@ -332,6 +332,10 @@
         return true;
     }
 
+    /**
+     * Removes this node from its graph.
+     * This node must have no {@linkplain Node#usages() usages} and no {@linkplain #predecessor() predecessor}.
+     */
     public void safeDelete() {
         assert checkDeletion();
         clearInputs();
diff -r a549662f6c6f -r 97b1e0ab7442 graal/com.oracle.graal.nodes/src/com/oracle/graal/nodes/StructuredGraph.java
--- a/graal/com.oracle.graal.nodes/src/com/oracle/graal/nodes/StructuredGraph.java	Fri Apr 20 14:10:57 2012 +0200
+++ b/graal/com.oracle.graal.nodes/src/com/oracle/graal/nodes/StructuredGraph.java	Fri Apr 20 14:12:42 2012 +0200
@@ -166,6 +166,12 @@
         node.safeDelete();
     }
 
+    /**
+     * Unlinks a node from all its control flow neighbours and then removes it from its graph.
+     * The node must have no {@linkplain Node#usages() usages}.
+     *
+     * @param node the node to be unlinked and removed
+     */
     public void removeFixed(FixedWithNextNode node) {
         assert node != null;
         if (node instanceof BeginNode) {