More clarification on 13802

changes/ticket13802

@@ -1,5 +1,7 @@
   o Minor features (testing):
-    - Add general tracing instrumentation to Tor. For now, this subsystem is
+    - Add a general event-tracing instrumentation support to Tor.  This
-      not being used by any part of the code, it is for future use or external
+      subsystem will enable developers and researchers to add fine-grained
-      testing that is not part of the upstream code base. Any tracing
+      instrumentation to their Tor instances, for use when examining Tor
-      framework needs to be enabled at compile time. Closes #13802.
+      network performance issues.  There are no trace events yet, and
+      event-tracing is off by default unless enabled at compile time.
+      Implements ticket 13802.

doc/HACKING/Tracing.md

@@ -1,13 +1,14 @@
 # Tracing #
 
-This document describes how the tracing subsystem works in tor so developers
+This document describes how the event tracing subsystem works in tor so
-can add events to the code base but also hook them to a tracing framework.
+developers can add events to the code base but also hook them to an event
+tracing framework.
 
 ## Basics ###
 
-Tracing is seperated in two concepts, trace events and a tracer. The tracing
+Event tracing is seperated in two concepts, trace events and a tracer. The
-subsystem can be found in `src/trace`. The `events.h` header file is the
+tracing subsystem can be found in `src/trace`. The `events.h` header file is
-main file that maps the different tracers to trace events.
+the main file that maps the different tracers to trace events.
 
 ### Events ###