document that tracepoint names should ideally not be re-used

Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>

diff --git a/doc/man/lttng-ust.3 b/doc/man/lttng-ust.3
index 818ef103ae407498c133ba9e64580595f3b47254..08927c64c4a18b60afbb2bc70f12ddb5dc330c51 100644 (file)
--- a/doc/man/lttng-ust.3
+++ b/doc/man/lttng-ust.3
@@ -238,6 +238,10 @@ For instance, add within a function:
 As a call to the tracepoint. It will only be activated when requested by
 lttng(1) through lttng-sessiond(8).
 
+Even though LTTng-UST supports tracepoint() call site duplicates having
+the same provider and event name, it is recommended to use a
+provider event name pair only once within the source code to help
+mapping events back to their call sites when analyzing the trace.
 .fi
 
 .SH "BUILDING/LINKING THE TRACEPOINT PROVIDER"