X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=doc%2Fman%2Flttng-view.1.txt;h=afb39fe0a349869683fefd0632015459eb915091;hb=188419c4eee5d623605d6c7bd797c18ae8564647;hp=86d62536b8d38ceac342ce72a5f7a607db23c2d4;hpb=59b19c3c82a824b602b4e3cd70e1cb22448fcb9d;p=lttng-tools.git

diff --git a/doc/man/lttng-view.1.txt b/doc/man/lttng-view.1.txt
index 86d62536b..afb39fe0a 100644
--- a/doc/man/lttng-view.1.txt
+++ b/doc/man/lttng-view.1.txt
@@ -1,47 +1,60 @@
 lttng-view(1)
 =============
+:revdate: 29 April 2021
 
 
 NAME
 ----
-lttng-view - View the traces of an LTTng tracing session
+lttng-view - Launch an LTTng trace reader
 
 
 SYNOPSIS
 --------
 [verse]
-*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *view* [option:--viewer='CMD'] [option:--trace-path='PATH' | 'SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *view* [option:--viewer='READER']
+      ['SESSION' | option:--trace-path='DIR']
 
 
 DESCRIPTION
 -----------
-The `lttng view` command launches an external trace viewer to view the
-current trace of a tracing session.
+The `lttng view` command launches an external trace reader to read the
+current traces of:
 
-If 'SESSION' is omitted, the viewer is launched for the current tracing
-session (see man:lttng-create(1) for more information
-about the current tracing session). Otherwise, it is launched for the
-existing tracing session named 'SESSION'. `lttng list`
-outputs all the existing tracing sessions (see man:lttng-list(1)).
+With the option:--session='SESSION' option::
+    The tracing session named 'SESSION'.
 
-By default, the man:babeltrace(1) trace viewer is launched.
-Another trace viewer command can be specified using the
-option:--viewer option.
+With the option:--trace-path='DIR' option::
+    The local file system directory 'DIR'.
 
-By default, the trace path of the chosen tracing session is given
-as the first positional argument to the trace viewer. This path can
-be overridden using the option:--trace-path option.
+Otherwise::
+    The current tracing session (see man:concepts(1) to learn more about
+    the current tracing session).
+
+With the option:--session option or without the option:--trace-path
+option, the mode of the selected tracing session may :not: be network
+streaming or live.
+
+By default, the `view` command attempts to launch man:babeltrace2(1) or,
+if it's not available, man:babeltrace(1). Override which trace reader to
+launch with the option:--viewer option.
 
 
 include::common-cmd-options-head.txt[]
 
 
-option:-t 'PATH', option:--trace-path='PATH'::
-    View trace at path 'PATH' instead of using the chosen tracing
-    session's trace path.
+option:-t 'DIR', option:--trace-path='DIR'::
+    Pass 'DIR' as the last argument of the trace reader command instead
+    of the output directory of the selected tracing session.
 
-option:-e 'CMD', option:--viewer='CMD'::
-    Use 'CMD' as the trace viewer.
+option:-e 'READER', option:--viewer='READER'::
+    Use the trace reader 'READER' to read the traces.
++
+'READER' is the absolute path to the reader command to use, and it can
+contain command arguments as well. The `view` command passes the trace
+directory path to read to the 'READER' command as its last argument.
++
+Without this option, the `view` command uses man:babeltrace2(1) if it's
+available. Otherwise, it tries to use man:babeltrace(1).
 
 
 include::common-cmd-help-options.txt[]
@@ -52,4 +65,5 @@ include::common-cmd-footer.txt[]
 
 SEE ALSO
 --------
+man:babeltrace2(1),
 man:lttng(1)