PR FIXUP - Document withStackTrace

sourcenetwork · Dec 20, 2022 · 15380b0 · 15380b0
1 parent dae4290
commit 15380b0
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/errors/errors.go b/errors/errors.go
@@ -74,6 +74,10 @@ func newError(message string, depthToSkip int, keyvals ...KV) *defraError {
 	return withStackTrace(message, depthToSkip+1, keyvals...)
 }
 
+// withStackTrace creates a `defraError` with a stacktrace and the given key-value pairs.
+// The stacktrace will skip the top `depthToSkip` frames, allowing frames/calls generated from
+// within this package to not polute the resultant stacktrace.
+//
 // This function will not be inlined by the compiler as it will spoil any stacktrace
 // generated.
 //go:noinline