diff --git a/opentracing-api/src/main/java/io/opentracing/Span.java b/opentracing-api/src/main/java/io/opentracing/Span.java index c7c10b10..8dfc2b3d 100644 --- a/opentracing-api/src/main/java/io/opentracing/Span.java +++ b/opentracing-api/src/main/java/io/opentracing/Span.java @@ -69,7 +69,8 @@ public interface Span extends AutoCloseable { /** * Log key:value pairs to the Span with the current walltime timestamp. * - * CAUTIONARY NOTE: not all Tracer implementations support key:value log fields end-to-end. Caveat emptor. + *

CAUTIONARY NOTE: not all Tracer implementations support key:value log fields end-to-end. + * Caveat emptor. * *

A contrived example (using Guava, which is not required): *

{@code
@@ -91,7 +92,8 @@ public interface Span extends AutoCloseable {
     /**
      * Like log(Map<String, Object>), but with an explicit timestamp.
      *
-     * CAUTIONARY NOTE: not all Tracer implementations support key:value log fields end-to-end. Caveat emptor.
+     * 

CAUTIONARY NOTE: not all Tracer implementations support key:value log fields end-to-end. + * Caveat emptor. * * @param timestampMicroseconds The explicit timestamp for the log record. Must be greater than or equal to the * Span's start timestamp.