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

[lttng-tools.git] / doc / man / lttng-set-session.1.txt

diff --git a/doc/man/lttng-set-session.1.txt b/doc/man/lttng-set-session.1.txt
index 998266affb5b1a243197988b5e0894a54c5af019..10f710abe940b24018dd84dd6706ad09d826cee7 100644 (file)
--- a/doc/man/lttng-set-session.1.txt
+++ b/doc/man/lttng-set-session.1.txt
@@ -1,5 +1,6 @@
 lttng-set-session(1)
 ====================
+:revdate: 29 April 2021
 
 
 NAME
@@ -15,14 +16,17 @@ SYNOPSIS
 
 DESCRIPTION
 -----------
-The `lttng set-session` command sets the current tracing session.
+The `lttng set-session` command sets the current tracing session of your
+Unix user to the tracing session named 'SESSION'.
 
-'SESSION' is the name of an existing tracing session. `lttng list`
-outputs all the existing tracing sessions (see linklttng:lttng-list(1)).
+See man:lttng-concepts(7) to learn more about the current tracing session.
 
-The current tracing session is used by default when a session can be
-specified in other commands. See linklttng:lttng-create(1) for more
-information about the current tracing session.
+The `set-session` command effectively updates the `$LTTNG_HOME/.lttngrc`
+file.
+
+List the tracing sessions of your Unix user, or of all users if
+your Unix user is `root`, within the connected session daemon with the
+man:lttng-list(1) command.
 
 
 include::common-cmd-options-head.txt[]
@@ -36,6 +40,6 @@ include::common-cmd-footer.txt[]
 
 SEE ALSO
 --------
-linklttng:lttng-create(1),
-linklttng:lttng-destroy(1),
-linklttng:lttng(1)
+man:lttng(1),
+man:lttng-create(1),
+man:lttng-concepts(7)