comment on replaceCurrent

1 files changed, 4 insertions, 1 deletions

diff --git a/src/wasm-traversal.h b/src/wasm-traversal.h
index 7b160ed3d..a2e29ea77 100644
--- a/src/wasm-traversal.h
+++ b/src/wasm-traversal.h
@@ -156,7 +156,10 @@ struct Walker : public VisitorType {
 
   // Useful methods for visitor implementions
 
-  // Replace the current node
+  // Replace the current node. You can call this in your visit*() methods.
+  // Note that the visit*() for the result node is not called for you (i.e.,
+  // just one visit*() method is called by the traversal; if you replace a node,
+  // and you want to process the output, you must do that explicitly).
   void replaceCurrent(Expression *expression) {
     replace = expression;
   }