Canonical import path
=====================

The canonical import path for this library is github.com/uber/jaeger-client-go,
although the git repo is located at http://github.com/jaegertracing/jaeger-client-go.

Deprecated status
=================

Upstream has deprecated this library, and will only accept security fixes. The
library is currently a dependency of Grafana Dskit (ITP#1001989, required by newer
versions of LXD and Incus), although there is work to switch to the OpenTelemetry
libraries (https://github.com/grafana/dskit/pull/385). When that happens, if there are
no other reverse dependencies, this package can then be RMed from the archive.

Embedded thrift library
=======================

This library includes a partial copy of Apache Thrift, version 0.14.1, in the thrift/
directory. That was an unfortunate decision, and attempts to remove the vendored code
during packaging in favor of the existing src:thrift package have been unsuccessful
due to changes since thrift 0.14.1. Totally removing all thrift-related code was
also briefly explored, but would have been very messy.

For the time being I have decided to keep the vendored copy, as given the deprecated
status of this library any efforts to fully migrate to a current version of thrift
would be wasted effort. Hopefully in the near future Dskit will migrate away from
jaeger-client-go, and this package then can be removed from the archive.

Missing thrift source files
===========================

There are generated source files under thrift-gen/ produced from source files pinned
to commit https://github.com/jaegertracing/jaeger-idl/tree/cfd3d58c9ac66bb410ff378de1d77ad378142c15
in the upstream repo and included in Debian packaging under d/missing-sources/.
Attempting to re-generate the thrift code with a current version of the thrift
compiler encounters errors, so they aren't re-generated at build time.
