docs: define durationToPrev timing semantics

1 files changed, 3 insertions, 0 deletions

diff --git a/internal/event/pair.go b/internal/event/pair.go
index 1e9a544..4b93013 100644
--- a/internal/event/pair.go
+++ b/internal/event/pair.go
@@ -33,8 +33,11 @@ func NewPair(enterEv Event) *Pair {
 }
 
 func (e *Pair) CalculateDurations(prevPairTime uint64) {
+	// Duration is syscall runtime: exit(current) - enter(current).
 	e.Duration = e.ExitEv.GetTime() - e.EnterEv.GetTime()
 	if prevPairTime > 0 {
+		// DurationToPrev is the inter-syscall gap on the same TID:
+		// enter(current) - exit(previous).
 		e.DurationToPrev = e.EnterEv.GetTime() - prevPairTime
 	}
 }