From f5511eeafdb40b9589306519633566c3be48756c Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Thu, 6 May 2021 14:45:26 -0400 Subject: [PATCH] doc/man: lttng(1) command pages: always include `common-footer.txt` MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit The end of an lttng(1) command manual page source now looks like this: include::common-lttng-cmd-help-options.txt[] include::common-lttng-cmd-after-options.txt[] include::common-footer.txt[] `common-lttng-cmd-after-options.txt` contains the "EXIT STATUS", "ENVIRONMENT", and "FILES" sections. `common-footer.txt` begins with the "RESOURCES" section. This will make it possible to insert an "EXAMPLES" section between `common-lttng-cmd-after-options.txt` and `common-footer.txt`. Signed-off-by: Philippe Proulx Signed-off-by: Jérémie Galarneau Change-Id: I1eee42d7386f4671d9825e9d3e131e54f868ee39 --- doc/man/Makefile.am | 6 +++--- doc/man/README.md | 7 ++++--- ...ooter.txt => common-lttng-cmd-after-options.txt} | 2 -- ...ptions.txt => common-lttng-cmd-help-options.txt} | 0 doc/man/common-lttng-cmd-options-head.txt | 3 +++ doc/man/common-lttng-cmd-opts-head.txt | 3 +++ doc/man/lttng-add-context.1.txt | 9 ++++++--- doc/man/lttng-add-trigger.1.txt | 7 +++++-- doc/man/lttng-clear.1.txt | 9 ++++++--- doc/man/lttng-create.1.txt | 9 ++++++--- doc/man/lttng-destroy.1.txt | 9 ++++++--- doc/man/lttng-disable-channel.1.txt | 9 ++++++--- doc/man/lttng-disable-event.1.txt | 9 ++++++--- doc/man/lttng-disable-rotation.1.txt | 9 ++++++--- doc/man/lttng-enable-channel.1.txt | 9 ++++++--- doc/man/lttng-enable-event.1.txt | 9 ++++++--- doc/man/lttng-enable-rotation.1.txt | 9 ++++++--- doc/man/lttng-help.1.txt | 9 ++++++--- doc/man/lttng-list-triggers.1.txt | 13 +++++++++---- doc/man/lttng-list.1.txt | 9 ++++++--- doc/man/lttng-load.1.txt | 9 ++++++--- doc/man/lttng-metadata.1.txt | 9 ++++++--- doc/man/lttng-regenerate.1.txt | 9 ++++++--- doc/man/lttng-remove-trigger.1.txt | 7 +++++-- doc/man/lttng-rotate.1.txt | 9 ++++++--- doc/man/lttng-save.1.txt | 9 ++++++--- doc/man/lttng-set-session.1.txt | 9 ++++++--- doc/man/lttng-snapshot.1.txt | 9 ++++++--- doc/man/lttng-start.1.txt | 9 ++++++--- doc/man/lttng-status.1.txt | 9 ++++++--- doc/man/lttng-stop.1.txt | 9 ++++++--- doc/man/lttng-track.1.txt | 9 ++++++--- doc/man/lttng-untrack.1.txt | 9 ++++++--- doc/man/lttng-version.1.txt | 9 ++++++--- doc/man/lttng-view.1.txt | 9 ++++++--- doc/man/lttng.1.txt | 5 ++++- 36 files changed, 192 insertions(+), 95 deletions(-) rename doc/man/{common-cmd-footer.txt => common-lttng-cmd-after-options.txt} (98%) rename doc/man/{common-cmd-help-options.txt => common-lttng-cmd-help-options.txt} (100%) create mode 100644 doc/man/common-lttng-cmd-options-head.txt create mode 100644 doc/man/common-lttng-cmd-opts-head.txt diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am index 97aa59b66..037d84d9f 100644 --- a/doc/man/Makefile.am +++ b/doc/man/Makefile.am @@ -59,9 +59,9 @@ MAN_XML = $(patsubst $(srcdir)/%.txt,%.xml,$(MAN_TXT)) # common AsciiDoc source files COMMON_TXT = \ $(srcdir)/common-footer.txt \ - $(srcdir)/common-cmd-footer.txt \ - $(srcdir)/common-cmd-options-head.txt \ - $(srcdir)/common-cmd-help-options.txt \ + $(srcdir)/common-lttng-cmd-after-options.txt \ + $(srcdir)/common-lttng-cmd-options-head.txt \ + $(srcdir)/common-lttng-cmd-help-options.txt \ $(srcdir)/common-help-option.txt \ $(srcdir)/common-intro.txt \ $(srcdir)/common-daemon-cfg.txt diff --git a/doc/man/README.md b/doc/man/README.md index c904d77a6..1b0233b8e 100644 --- a/doc/man/README.md +++ b/doc/man/README.md @@ -77,9 +77,10 @@ which is not so easy to do otherwise. Includes -------- - * `common-cmd-footer.txt`: common `lttng` command footer. - * `common-cmd-help-options.txt`: common program information section - of `lttng` command options. + * `common-lttng-cmd-after-options.txt`: common part after the options + section of an `lttng` command. + * `common-lttng-cmd-help-options.txt`: common program information + section of `lttng` command options. * `common-cmd-options-head.txt`: common `lttng` command head of options section. * `common-footer.txt`: common footer for all commands. diff --git a/doc/man/common-cmd-footer.txt b/doc/man/common-lttng-cmd-after-options.txt similarity index 98% rename from doc/man/common-cmd-footer.txt rename to doc/man/common-lttng-cmd-after-options.txt index 86b4a8188..2122cee2c 100644 --- a/doc/man/common-cmd-footer.txt +++ b/doc/man/common-lttng-cmd-after-options.txt @@ -81,5 +81,3 @@ man:lttng-create(1) command. NOTE: `$LTTNG_HOME` defaults to the value of the `HOME` environment variable. - -include::common-footer.txt[] diff --git a/doc/man/common-cmd-help-options.txt b/doc/man/common-lttng-cmd-help-options.txt similarity index 100% rename from doc/man/common-cmd-help-options.txt rename to doc/man/common-lttng-cmd-help-options.txt diff --git a/doc/man/common-lttng-cmd-options-head.txt b/doc/man/common-lttng-cmd-options-head.txt new file mode 100644 index 000000000..c910e7137 --- /dev/null +++ b/doc/man/common-lttng-cmd-options-head.txt @@ -0,0 +1,3 @@ +OPTIONS +------- +See man:lttng(1) for 'linkgenoptions:(GENERAL OPTIONS)'. diff --git a/doc/man/common-lttng-cmd-opts-head.txt b/doc/man/common-lttng-cmd-opts-head.txt new file mode 100644 index 000000000..c910e7137 --- /dev/null +++ b/doc/man/common-lttng-cmd-opts-head.txt @@ -0,0 +1,3 @@ +OPTIONS +------- +See man:lttng(1) for 'linkgenoptions:(GENERAL OPTIONS)'. diff --git a/doc/man/lttng-add-context.1.txt b/doc/man/lttng-add-context.1.txt index b1d11e931..ad83445b5 100644 --- a/doc/man/lttng-add-context.1.txt +++ b/doc/man/lttng-add-context.1.txt @@ -107,7 +107,7 @@ to be recorded to the event records of a given channel once its tracing session has been started (see man:lttng-start(1)) at least once. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -158,10 +158,13 @@ option:-t 'TYPE', option:--type='TYPE':: Repeat this option to add more than one context field. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-add-trigger.1.txt b/doc/man/lttng-add-trigger.1.txt index aee2380b3..0b7363e81 100644 --- a/doc/man/lttng-add-trigger.1.txt +++ b/doc/man/lttng-add-trigger.1.txt @@ -300,10 +300,13 @@ option:--action='ACTTYPE':: See the <> section above to learn more. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-clear.1.txt b/doc/man/lttng-clear.1.txt index f60a55b96..4fb52671a 100644 --- a/doc/man/lttng-clear.1.txt +++ b/doc/man/lttng-clear.1.txt @@ -55,7 +55,7 @@ sends tracing data over the network for the selected tracing session(s) to an LTTng relay daemon configured as such, the `clear` command fails. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Recording target @@ -67,10 +67,13 @@ option:-a, option:--all:: tracing session named 'SESSION'. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-create.1.txt b/doc/man/lttng-create.1.txt index f3420a010..5b5f7b62e 100644 --- a/doc/man/lttng-create.1.txt +++ b/doc/man/lttng-create.1.txt @@ -234,7 +234,7 @@ This path is relative to the base output directory of the LTTng relay daemon (see the nloption:--output option of man:lttng-relayd(8)). -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Mode selection @@ -359,10 +359,13 @@ Snapshot mode (option:--snapshot option)::: after creating the tracing session. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-destroy.1.txt b/doc/man/lttng-destroy.1.txt index bed0a0053..979292477 100644 --- a/doc/man/lttng-destroy.1.txt +++ b/doc/man/lttng-destroy.1.txt @@ -65,7 +65,7 @@ command exits. In other words, it's safe to read them, modify them, move them, or remove then. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] option:-a, option:--all:: @@ -79,10 +79,13 @@ option:-n, option:--no-wait:: destroy is valid before exiting. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-disable-channel.1.txt b/doc/man/lttng-disable-channel.1.txt index 9492a3903..7f86d6d18 100644 --- a/doc/man/lttng-disable-channel.1.txt +++ b/doc/man/lttng-disable-channel.1.txt @@ -37,7 +37,7 @@ channel once its tracing session has ben started (see man:lttng-start(1)) at least once. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -58,10 +58,13 @@ option:-s 'SESSION', option:--session='SESSION':: instead of the current tracing session. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-disable-event.1.txt b/doc/man/lttng-disable-event.1.txt index 7ace9d1b4..2f09d3873 100644 --- a/doc/man/lttng-disable-event.1.txt +++ b/doc/man/lttng-disable-event.1.txt @@ -70,7 +70,7 @@ activity (started or stopped) of its tracing session (see man:lttng-start(1) and man:lttng-stop(1)). -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -147,10 +147,13 @@ option:-a, option:--all-events:: condition. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-disable-rotation.1.txt b/doc/man/lttng-disable-rotation.1.txt index 0fc53afeb..8b68ded7a 100644 --- a/doc/man/lttng-disable-rotation.1.txt +++ b/doc/man/lttng-disable-rotation.1.txt @@ -31,7 +31,7 @@ See man:lttng-concepts(7) to learn more about the tracing session rotation and trace chunk concepts. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Rotation schedule condition @@ -52,10 +52,13 @@ option:-s 'SESSION', option:--session='SESSION':: instead of the current tracing session. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-enable-channel.1.txt b/doc/man/lttng-enable-channel.1.txt index 4da752f34..c16051dfa 100644 --- a/doc/man/lttng-enable-channel.1.txt +++ b/doc/man/lttng-enable-channel.1.txt @@ -89,7 +89,7 @@ operations with the `enable-channel` command: ==== -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -345,10 +345,13 @@ option:--kernel and option:--buffers-global options::: +{default_metadata_switch_timer}+ -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-enable-event.1.txt b/doc/man/lttng-enable-event.1.txt index 439099b7f..526266fe1 100644 --- a/doc/man/lttng-enable-event.1.txt +++ b/doc/man/lttng-enable-event.1.txt @@ -618,7 +618,7 @@ create it. In particular, with the option:--filter='EXPR' option, 'EXPR' must be the exact same string as the one you used on creation. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -845,10 +845,13 @@ option:-f 'EXPR', option:--filter='EXPR':: event payload and current context fields, is _true_. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-enable-rotation.1.txt b/doc/man/lttng-enable-rotation.1.txt index f965ed973..e9571ca5b 100644 --- a/doc/man/lttng-enable-rotation.1.txt +++ b/doc/man/lttng-enable-rotation.1.txt @@ -80,7 +80,7 @@ when it's not currently performing a rotation. ==== -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Rotation schedule condition @@ -108,10 +108,13 @@ option:-s 'SESSION', option:--session='SESSION':: instead of the current tracing session. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-help.1.txt b/doc/man/lttng-help.1.txt index 3b1d7b50e..a371a944b 100644 --- a/doc/man/lttng-help.1.txt +++ b/doc/man/lttng-help.1.txt @@ -34,13 +34,16 @@ manual page of the command. Override the manual pager path with the `LTTNG_MAN_BIN_PATH` environment variable. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-list-triggers.1.txt b/doc/man/lttng-list-triggers.1.txt index 7d99869f2..f5e469145 100644 --- a/doc/man/lttng-list-triggers.1.txt +++ b/doc/man/lttng-list-triggers.1.txt @@ -23,11 +23,16 @@ properties. See man:lttng-concepts(7) to learn more about triggers. -OPTIONS -------- -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-options-head.txt[] -include::common-cmd-footer.txt[] + +include::common-lttng-cmd-help-options.txt[] + + +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-list.1.txt b/doc/man/lttng-list.1.txt index 319ec5052..749d66e3f 100644 --- a/doc/man/lttng-list.1.txt +++ b/doc/man/lttng-list.1.txt @@ -92,7 +92,7 @@ session (see man:lttng-concept(7) to learn more) with the man:lttng-status(1) command. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -153,10 +153,13 @@ option:--syscall:: system calls. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt index 545bc3628..0a6626b96 100644 --- a/doc/man/lttng-load.1.txt +++ b/doc/man/lttng-load.1.txt @@ -72,7 +72,7 @@ sessions: the command fails. Allow the `load` command to overwrite existing tracing sessions with the option:--force option. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] option:-a, option:--all:: @@ -100,10 +100,13 @@ type of tracing session configurations to load. This option applies to _all_ the loaded tracing session configurations. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-metadata.1.txt b/doc/man/lttng-metadata.1.txt index 6911f9fb8..e2dfde623 100644 --- a/doc/man/lttng-metadata.1.txt +++ b/doc/man/lttng-metadata.1.txt @@ -20,7 +20,7 @@ WARNING: This command is **deprecated**; it's been replaced with `lttng regenerate metadata` (see man:lttng-regenerate(1)). -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] option:-s 'SESSION', option:--session='SESSION':: @@ -30,10 +30,13 @@ option:-s 'SESSION', option:--session='SESSION':: session). -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-regenerate.1.txt b/doc/man/lttng-regenerate.1.txt index d3f645fc6..cd8f4d776 100644 --- a/doc/man/lttng-regenerate.1.txt +++ b/doc/man/lttng-regenerate.1.txt @@ -85,7 +85,7 @@ man:lttng-concepts(7)): in both cases, the state dump information may be lost. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] option:-s 'SESSION', option:--session='SESSION':: @@ -93,10 +93,13 @@ option:-s 'SESSION', option:--session='SESSION':: instead of the current tracing session. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-remove-trigger.1.txt b/doc/man/lttng-remove-trigger.1.txt index faf67b2f8..016b5271a 100644 --- a/doc/man/lttng-remove-trigger.1.txt +++ b/doc/man/lttng-remove-trigger.1.txt @@ -39,10 +39,13 @@ option:--owner-uid='UID':: You may only use this option if your Unix user is `root`. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-rotate.1.txt b/doc/man/lttng-rotate.1.txt index 50cb3102b..29ff3a0d7 100644 --- a/doc/man/lttng-rotate.1.txt +++ b/doc/man/lttng-rotate.1.txt @@ -79,7 +79,7 @@ You may only use the `rotate` command when: ==== -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] option:-n, option:--no-wait:: @@ -87,10 +87,13 @@ option:-n, option:--no-wait:: completed before exiting. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-save.1.txt b/doc/man/lttng-save.1.txt index 36ef1d673..a15a99408 100644 --- a/doc/man/lttng-save.1.txt +++ b/doc/man/lttng-save.1.txt @@ -50,7 +50,7 @@ to overwrite existing tracing session configuration files with the option:--force option. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] option:-a, option:--all:: @@ -69,10 +69,13 @@ option:-o 'DIR', option:--output-path='DIR':: `$HOME`). -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-set-session.1.txt b/doc/man/lttng-set-session.1.txt index 10f710abe..21663ddc3 100644 --- a/doc/man/lttng-set-session.1.txt +++ b/doc/man/lttng-set-session.1.txt @@ -29,13 +29,16 @@ your Unix user is `root`, within the connected session daemon with the man:lttng-list(1) command. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-snapshot.1.txt b/doc/man/lttng-snapshot.1.txt index 27c1e3d9c..a65156f9c 100644 --- a/doc/man/lttng-snapshot.1.txt +++ b/doc/man/lttng-snapshot.1.txt @@ -145,7 +145,7 @@ Set the maximum total size of all the snapshot trace files LTTng writes with the option:--max-size option. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Recording target @@ -184,10 +184,13 @@ option:-n 'NAME', option:--name='NAME':: Assign the name 'NAME' to the snapshot output. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-start.1.txt b/doc/man/lttng-start.1.txt index 9cc721de7..de90fa05a 100644 --- a/doc/man/lttng-start.1.txt +++ b/doc/man/lttng-start.1.txt @@ -37,13 +37,16 @@ A `start-session` trigger action can also start a tracing session Stop an active tracing session with the man:lttng-stop(1) command. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-status.1.txt b/doc/man/lttng-status.1.txt index 5f136f1aa..c0d96da0d 100644 --- a/doc/man/lttng-status.1.txt +++ b/doc/man/lttng-status.1.txt @@ -28,13 +28,16 @@ This command is equivalent to: where `CURSESSION` is the name of the current tracing session. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-stop.1.txt b/doc/man/lttng-stop.1.txt index 4715872fe..9b1907c61 100644 --- a/doc/man/lttng-stop.1.txt +++ b/doc/man/lttng-stop.1.txt @@ -53,7 +53,7 @@ the tracing session with man:lttng-destroy(1) or perform a rotation with man:lttng-rotate(1) to archive it. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] option:-n, option:--no-wait:: @@ -61,10 +61,13 @@ option:-n, option:--no-wait:: is valid before exiting. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-track.1.txt b/doc/man/lttng-track.1.txt index d2768b12c..195e07973 100644 --- a/doc/man/lttng-track.1.txt +++ b/doc/man/lttng-track.1.txt @@ -171,7 +171,7 @@ Remove values from an inclusion set with the man:lttng-untrack(1) command. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -288,10 +288,13 @@ option:-a, option:--all:: the possible values to the selected inclusion sets. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-untrack.1.txt b/doc/man/lttng-untrack.1.txt index d00b89214..363d8d718 100644 --- a/doc/man/lttng-untrack.1.txt +++ b/doc/man/lttng-untrack.1.txt @@ -118,7 +118,7 @@ Inclusion set: ------------------------------- -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -236,10 +236,13 @@ option:-a, option:--all:: selected inclusion sets. -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-version.1.txt b/doc/man/lttng-version.1.txt index 5cc7b3c54..35750d014 100644 --- a/doc/man/lttng-version.1.txt +++ b/doc/man/lttng-version.1.txt @@ -29,13 +29,16 @@ The output of the `version` command shows: * The license information. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] -include::common-cmd-help-options.txt[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng-view.1.txt b/doc/man/lttng-view.1.txt index afb39fe0a..15465c9db 100644 --- a/doc/man/lttng-view.1.txt +++ b/doc/man/lttng-view.1.txt @@ -39,7 +39,7 @@ 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[] +include::common-lttng-cmd-options-head.txt[] option:-t 'DIR', option:--trace-path='DIR':: @@ -57,10 +57,13 @@ 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[] +include::common-lttng-cmd-help-options.txt[] -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO diff --git a/doc/man/lttng.1.txt b/doc/man/lttng.1.txt index 1b5d5ee31..0f8f24b9c 100644 --- a/doc/man/lttng.1.txt +++ b/doc/man/lttng.1.txt @@ -245,7 +245,10 @@ Miscellaneous |=== -include::common-cmd-footer.txt[] +include::common-lttng-cmd-after-options.txt[] + + +include::common-footer.txt[] SEE ALSO -- 2.34.1