From 9014e3a8950e970d06ddef4224c1e45f9e7240a0 Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Wed, 4 May 2016 12:39:03 -0400 Subject: [PATCH] lttng-load(1): use lists to explain the input path behaviour MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Philippe Proulx Signed-off-by: Jérémie Galarneau --- doc/man/lttng-load.1.txt | 30 +++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt index 1435defbd..ec8741b07 100644 --- a/doc/man/lttng-load.1.txt +++ b/doc/man/lttng-load.1.txt @@ -38,19 +38,23 @@ When this option is specified, the default directories are :not: searched for configuration files. When it's not specified, _both_ default directories are searched for configuration files. -If the input path is a directory, then if 'SESSION' is specified, the -tracing session configuration named 'SESSION' is searched in all the -files of this directory and loaded if found. If 'SESSION' is not -specified, the option:--all option is implicit: all the tracing session -configurations found in all the files in this directory are loaded. - -If the input path is a file, then if 'SESSION' is specified, the tracing -session configuration named 'SESSION' is searched in this file and -loaded if found. If 'SESSION' is not specified, the option:--all option -is implicit: all the tracing session configurations found in this file -are loaded. - -By default, existing tracing sessions are not overwritten when loading; +If the input path is a *directory*, then: + +* If 'SESSION' is specified, the tracing session configuration named + 'SESSION' is searched for in all the files of this directory and + loaded if found. +* If 'SESSION' is not specified, the option:--all option is implicit: + all the tracing session configurations found in all the files in this + directory are loaded. + +If the input path is a *file*, then: + +* If 'SESSION' is specified, the tracing session configuration named + 'SESSION' is searched for in this file and loaded if found. +* If 'SESSION' is not specified, the option:--all option is implicit: + all the tracing session configurations found in this file are loaded. + +By default, existing tracing sessions are not overwritten when loading: the command fails. The option:--force option can be used to allow this. -- 2.34.1