X-Git-Url: https://git.lttng.org/?p=ust.git;a=blobdiff_plain;f=doc%2Fman%2Fustctl.1.md;h=208e1dd88c05b6fb01ff3f0e2de65a3919570852;hp=f215b7daee6fa6d6c0caf6331d5bf463dc1f777c;hb=4a8b1e481a205712205ed75593b8ecea2851e6b3;hpb=d99cad3d410921d1778a9e12dd746a862a9401d3

diff --git a/doc/man/ustctl.1.md b/doc/man/ustctl.1.md
index f215b7d..208e1dd 100644
--- a/doc/man/ustctl.1.md
+++ b/doc/man/ustctl.1.md
@@ -86,11 +86,14 @@ being recorded in the buffer. The daemon automatically collects these events.
 
 The trace may be stopped with `--stop-trace`, either definitely after all the
 wanted information is collected, or temporarily, before being started again
-with `--start-trace`. This results in effectively "pausing" the recording.
+with `--start-trace`. This results in effectively 'pausing' the recording.
+After using `--stop-trace`, if a daemon is collecting the trace, it may not
+have flushed to the disk the full contents of the buffer yet.
 
 Finally, when `--destroy-trace` is used, the trace buffers are unallocated.
 However, the memory may not be effectively freed until the daemon finishes to
-collect them.
+collect them. When the trace is being collected by `ustd`, this command
+guarantees its full contents is flushed to the disk.
 
 ## STRUCTURE OF A TRACE