doc/man: follow man-pages(7) for section names/order and for "SEE ALSO"

[lttng-tools.git] / doc / man / lttng-remove-trigger.1.txt

diff --git a/doc/man/lttng-remove-trigger.1.txt b/doc/man/lttng-remove-trigger.1.txt
index 645ef152f0e64f5ee1ad1c037c2ebe9690a98070..faf67b2f86d70bede1e18733b3a65965e2a27b1c 100644 (file)
--- a/doc/man/lttng-remove-trigger.1.txt
+++ b/doc/man/lttng-remove-trigger.1.txt
@@ -1,29 +1,43 @@
 lttng-remove-trigger(1)
-========================
-:revdate: 20 January 2020
+=======================
+:revdate: 29 April 2021
 
 
 NAME
 ----
-lttng-remove-trigger - Remove LTTng triggers
+lttng-remove-trigger - Remove an LTTng trigger
 
 
 SYNOPSIS
 --------
-
 [verse]
-*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *remove-trigger* 'ID'
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *remove-trigger* [option:--owner-uid='UID'] 'NAME'
 
 
 DESCRIPTION
 -----------
+The `lttng remove-trigger` command removes the trigger named 'NAME'.
+
+See man:lttng-concepts(7) to learn more about LTTng triggers.
 
-The `lttng remove-trigger` command removes the trigger with the given
-'ID'.
+List the triggers of your Unix user, or of all users if your
+Unix user is `root`, with the man:lttng-list-triggers(1) command.
+
+The `remove-trigger` command removes a trigger which belong to your Unix
+user. If your Unix user is `root`, you can remove the trigger of another
+user with the option:--owner-uid option.
 
 
 OPTIONS
 -------
+Identification
+~~~~~~~~~~~~~~
+option:--owner-uid='UID'::
+    Remove the trigger named 'NAME' of the Unix user having the user ID
+    'UID'.
++
+You may only use this option if your Unix user is `root`.
+
 
 include::common-cmd-help-options.txt[]
 
@@ -33,6 +47,7 @@ include::common-cmd-footer.txt[]
 
 SEE ALSO
 --------
+man:lttng(1),
 man:lttng-add-trigger(1),
-man:lttng-list-trigger(1),
-man:lttng(1)
+man:lttng-list-triggers(1),
+man:lttng-concepts(7)