Add warning regarding possible node id conflicts

Hendrik van Antwerpen · Hendrik van Antwerpen · commit 8ae046348e21 · 2023-05-17T11:32:02.000+02:00
diff --git a/tree-sitter-stack-graphs/src/lib.rs b/tree-sitter-stack-graphs/src/lib.rs
@@ -1148,6 +1148,9 @@ impl<'a> Builder<'a> {
 }
 
 pub trait FileAnalyzer {
+    /// Construct stack graph for the given file. Implementations must assume that nodes
+    /// for the given file may already exist, and make sure to prevent node id conflicts,
+    /// for example by using `StackGraph::new_node_id`.
     fn build_stack_graph_into<'a>(
         &self,
         stack_graph: &mut StackGraph,

Original file line number	Diff line number	Diff line change
`@@ -1148,6 +1148,9 @@ impl<'a> Builder<'a> {`
`1148`	`1148`	`}`
`1149`	`1149`
`1150`	`1150`	`pub trait FileAnalyzer {`
	`1151`	`+ /// Construct stack graph for the given file. Implementations must assume that nodes`
	`1152`	`+ /// for the given file may already exist, and make sure to prevent node id conflicts,`
	`1153`	+ /// for example by using `StackGraph::new_node_id`.
`1151`	`1154`	`fn build_stack_graph_into<'a>(`
`1152`	`1155`	`&self,`
`1153`	`1156`	`stack_graph: &mut StackGraph,`