Documentation: document that sequence len field is unsigned

Fixes #471

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

diff --git a/doc/man/lttng-ust.3 b/doc/man/lttng-ust.3
index 5effb9f5a3b8b5c63f27cc686bd2a5daa46f0eeb..5be3cfaa081a669cb8d9b9e990117dd63f9bc735 100644 (file)
--- a/doc/man/lttng-ust.3
+++ b/doc/man/lttng-ust.3
@@ -123,6 +123,10 @@ TRACEPOINT_EVENT(
                 * ctf_sequence: a dynamically-sized array.
                 * args: (type, field name, argument expression,
                 *      type of length expression, length expression)
+                * The "type of length expression" needs to be an
+                * unsigned type. As a reminder, "unsigned char" should
+                * be preferred to "char", since the signedness of
+                * "char" is implementation-defined.
                 */ 
                ctf_sequence(char, seqfield1, text,
                             size_t, textlen)