[tor-commits] [tor/master] More clarification on 13802

nickm at torproject.org nickm at torproject.org
Tue Apr 25 14:43:30 UTC 2017


commit 6bf82a4910db3f20c2cb81d7569224f4322681f2
Author: Nick Mathewson <nickm at torproject.org>
Date:   Tue Apr 25 10:40:27 2017 -0400

    More clarification on 13802
---
 changes/ticket13802    | 10 ++++++----
 doc/HACKING/Tracing.md | 11 ++++++-----
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/changes/ticket13802 b/changes/ticket13802
index 581d5bd..35cd2b5 100644
--- a/changes/ticket13802
+++ b/changes/ticket13802
@@ -1,5 +1,7 @@
   o Minor features (testing):
-    - Add general tracing instrumentation to Tor. For now, this subsystem is
-      not being used by any part of the code, it is for future use or external
-      testing that is not part of the upstream code base. Any tracing
-      framework needs to be enabled at compile time. Closes #13802.
+    - Add a general event-tracing instrumentation support to Tor.  This
+      subsystem will enable developers and researchers to add fine-grained
+      instrumentation to their Tor instances, for use when examining Tor
+      network performance issues.  There are no trace events yet, and
+      event-tracing is off by default unless enabled at compile time.
+      Implements ticket 13802.
diff --git a/doc/HACKING/Tracing.md b/doc/HACKING/Tracing.md
index f4a55b7..a5fb516 100644
--- a/doc/HACKING/Tracing.md
+++ b/doc/HACKING/Tracing.md
@@ -1,13 +1,14 @@
 # Tracing #
 
-This document describes how the tracing subsystem works in tor so developers
-can add events to the code base but also hook them to a tracing framework.
+This document describes how the event tracing subsystem works in tor so
+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
-subsystem can be found in `src/trace`. The `events.h` header file is the
-main file that maps the different tracers to trace events.
+Event tracing is seperated in two concepts, trace events and a tracer. The
+tracing subsystem can be found in `src/trace`. The `events.h` header file is
+the main file that maps the different tracers to trace events.
 
 ### Events ###
 



More information about the tor-commits mailing list