From 6205cb44a6e41966fb2dcce508e258ea17b775a3 Mon Sep 17 00:00:00 2001 From: Ted Young Date: Tue, 16 Jan 2018 14:32:18 -0800 Subject: [PATCH 1/3] Add a CHANGELOG file In the same manner as the golang changelog: https://github.com/opentracing/opentracing-go/blob/master/CHANGELOG.md --- CHANGELOG.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 00000000..33ed75a6 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,13 @@ +Changes by Version +================== + +v0.31.0 (2018-01-12) +-------------------- + +- `BaseSpan` and `ActiveSpan` are simplified into a single `Span` class. +- `Scope` replaces `ActiveSpan`, removing the continuation concept. There is no longer a capture phase. Scopes are only activated and then closed. +- `ScopeManager` replaces `ActiveSpanSource`, and is expected to be passed to the tracer at initialization time. +- `ScopeManager.activate(Span,bool)` creates a `Scope` for the current context. The `finishOnClose` flag optionally calls `Span.finish()` on `Scope.close()`. +- `ScopeManager.active()` returns the `Scope` associated with the current context. +- `Tracer.activeSpan()` returns the current value of `Tracer.scopeManager().active().span()` as a convenience. +- `ThreadLocalScopeManager` replaces `ThreadLocalActiveSpanSource`. It still uses thread-local storage for tracking active spans, but removes the reference counting used previously for span lifetime handling. From e4fdeeb5f79cafb73b6b0b7f692693fad1c9b087 Mon Sep 17 00:00:00 2001 From: Ted Young Date: Tue, 30 Jan 2018 10:49:57 -0800 Subject: [PATCH 2/3] incorporating feedback from comments --- CHANGELOG.md | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 33ed75a6..31fe12da 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,13 +1,9 @@ -Changes by Version -================== +#Changes by Version -v0.31.0 (2018-01-12) --------------------- - -- `BaseSpan` and `ActiveSpan` are simplified into a single `Span` class. -- `Scope` replaces `ActiveSpan`, removing the continuation concept. There is no longer a capture phase. Scopes are only activated and then closed. -- `ScopeManager` replaces `ActiveSpanSource`, and is expected to be passed to the tracer at initialization time. -- `ScopeManager.activate(Span,bool)` creates a `Scope` for the current context. The `finishOnClose` flag optionally calls `Span.finish()` on `Scope.close()`. -- `ScopeManager.active()` returns the `Scope` associated with the current context. -- `Tracer.activeSpan()` returns the current value of `Tracer.scopeManager().active().span()` as a convenience. -- `ThreadLocalScopeManager` replaces `ThreadLocalActiveSpanSource`. It still uses thread-local storage for tracking active spans, but removes the reference counting used previously for span lifetime handling. +## v0.31.0 (2018-01-12) +* `BaseSpan` and `ActiveSpan` are simplified into a single `Span` class. +* `Scope` replaces `ActiveSpan`, removing `Continuations`. +* `ScopeManager` replaces `ActiveSpanSource`. +* `Tracer.activeSpan()` returns the current value of `Tracer.scopeManager().active().span()` as a convenience. +* `startManual()` deprecated in favor of `start()` +* new examples directory From a47aa4446e14d052b6801c1bf4f30210722b2197 Mon Sep 17 00:00:00 2001 From: Ted Young Date: Tue, 30 Jan 2018 10:50:11 -0800 Subject: [PATCH 3/3] typo --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 31fe12da..b09379f7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,4 @@ -#Changes by Version +# Changes by Version ## v0.31.0 (2018-01-12) * `BaseSpan` and `ActiveSpan` are simplified into a single `Span` class.