nodestack: document pop_restofstack()
authorBrian Norris <banorris@uci.edu>
Tue, 31 Jul 2012 22:41:35 +0000 (15:41 -0700)
committerBrian Norris <banorris@uci.edu>
Tue, 31 Jul 2012 23:15:57 +0000 (16:15 -0700)
nodestack.cc

index 5a65821..1de5169 100644 (file)
@@ -220,7 +220,13 @@ ModelAction * NodeStack::explore_action(ModelAction *act)
        return NULL;
 }
 
-
+/**
+ * Empties the stack of all trailing nodes after a given position and calls the
+ * destructor for each. This function is provided an offset which determines
+ * how many nodes (relative to the current replay state) to save before popping
+ * the stack.
+ * @param numAhead The number of nodes to skip forward before popping the stack.
+ */
 void NodeStack::pop_restofstack(int numAhead)
 {
        /* Diverging from previous execution; clear out remainder of list */
@@ -230,7 +236,6 @@ void NodeStack::pop_restofstack(int numAhead)
        clear_node_list(&node_list, it, node_list.end());
 }
 
-
 Node * NodeStack::get_head()
 {
        if (node_list.empty())