doc/man: use linkgenoptions macro

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>

diff --git a/doc/man/common-cmd-options-head.txt b/doc/man/common-cmd-options-head.txt
index fba544ebcc88c24d378776c7034288a19a06659a..169a869e9a8dd1620b0461e4f7c1c1d0889ab272 100644 (file)
--- a/doc/man/common-cmd-options-head.txt
+++ b/doc/man/common-cmd-options-head.txt
@@ -1,3 +1,3 @@
 OPTIONS
 -------
-General options are described in linklttng:lttng(1).
+linkgenoptions:(General options) are described in linklttng:lttng(1).

diff --git a/doc/man/lttng-add-context.1.txt b/doc/man/lttng-add-context.1.txt
index 26df16d2b37fb102587120dcfa6c2ec784b65b43..4f133b80e03a478f838d6f36b845d55e1f9f7b92 100644 (file)
--- a/doc/man/lttng-add-context.1.txt
+++ b/doc/man/lttng-add-context.1.txt
@@ -12,7 +12,7 @@ SYNOPSIS
 Add context fields to a channel:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *add-context*
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *add-context*
       (option:--kernel | option:--userspace | option:--jul | option:--log4j)
       [option:--session='SESSION'] [option:--channel='CHANNEL']
       option:--type='TYPE' [option:--type='TYPE']...
@@ -20,7 +20,7 @@ Add context fields to a channel:
 List the available context fields:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *add-context* --list
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *add-context* --list
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-calibrate.1.txt b/doc/man/lttng-calibrate.1.txt
index 621a67a88ecb9b920e93f00ef7a1c3e490eb05c6..54d245ef0b84ae5f2f5bcc6446518a7aa225bc10 100644 (file)
--- a/doc/man/lttng-calibrate.1.txt
+++ b/doc/man/lttng-calibrate.1.txt
@@ -10,7 +10,7 @@ lttng-calibrate - Quantify LTTng overhead
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *calibrate*
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *calibrate*
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-create.1.txt b/doc/man/lttng-create.1.txt
index 552e617139c2f70def505f7291565d9c75187670..6e158ecb7bb1bcdbf467d5b20a5b8b2a45c23013 100644 (file)
--- a/doc/man/lttng-create.1.txt
+++ b/doc/man/lttng-create.1.txt
@@ -12,20 +12,20 @@ SYNOPSIS
 Normal mode:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *create* [option:--output='PATH' | option:--no-output]
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *create* [option:--output='PATH' | option:--no-output]
       [option:--shm-path='PATH'] ['SESSION']
 
 Snapshot mode:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *create* option:--snapshot
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *create* option:--snapshot
       [option:--set-url='URL' | option:--ctrl-url='URL' option:--data-url='URL']
       [option:--shm-path='PATH'] ['SESSION']
 
 Live mode:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *create* option:--live[='DELAYUS']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *create* option:--live[='DELAYUS']
       [option:--set-url='URL' | option:--ctrl-url='URL' option:--data-url='URL']
       [option:--shm-path='PATH'] ['SESSION']
 

diff --git a/doc/man/lttng-destroy.1.txt b/doc/man/lttng-destroy.1.txt
index d23d094ebf28c2ccd831b0a1224e76eea1613978..74921bb25c05889028dac02fed2c1a5e7af6b896 100644 (file)
--- a/doc/man/lttng-destroy.1.txt
+++ b/doc/man/lttng-destroy.1.txt
@@ -10,7 +10,7 @@ lttng-destroy - Destroy an LTTng tracing session
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *destroy* [option:--all | 'SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *destroy* [option:--all | 'SESSION']
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-disable-channel.1.txt b/doc/man/lttng-disable-channel.1.txt
index 2470c23564fef7c66f24ea0e4412f84b88dabe73..7cd366f038a07a82042e249606308bcc1232bb0e 100644 (file)
--- a/doc/man/lttng-disable-channel.1.txt
+++ b/doc/man/lttng-disable-channel.1.txt
@@ -10,7 +10,7 @@ lttng-disable-channel - Disable LTTng channels
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *disable-channel* (option:--kernel | option:--userspace)
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-channel* (option:--kernel | option:--userspace)
       [option:--session='SESSION'] 'CHANNEL'[,'CHANNEL']...
 
 

diff --git a/doc/man/lttng-disable-event.1.txt b/doc/man/lttng-disable-event.1.txt
index bf1bc76d957c5a88a8741840516ef8aca618fc6d..f135880c931566b70d6d9a7cf60d28dfb7db7625 100644 (file)
--- a/doc/man/lttng-disable-event.1.txt
+++ b/doc/man/lttng-disable-event.1.txt
@@ -10,7 +10,7 @@ lttng-disable-event - Disable LTTng event rules
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *disable-event*
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *disable-event*
       (option:--kernel [option:--probe | option:--function | option:--syscall] |
        option:--userspace | option:--jul | option:--log4j | option:--python)
       [option:--session='SESSION'] [option:--channel='CHANNEL']

diff --git a/doc/man/lttng-enable-channel.1.txt b/doc/man/lttng-enable-channel.1.txt
index 5a7f4c55fef34c91d6973fb86f33f81072adb9ba..9365a7806e658fb1fd30a7e7e4a0896a0085a8d1 100644 (file)
--- a/doc/man/lttng-enable-channel.1.txt
+++ b/doc/man/lttng-enable-channel.1.txt
@@ -12,7 +12,7 @@ SYNOPSIS
 Create a Linux kernel channel:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *enable-channel* option:--kernel
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *enable-channel* option:--kernel
       [option:--discard | option:--overwrite] [option:--output=(`mmap` | `splice`)]
       [option:--subbuf-size='SIZE'] [option:--num-subbuf='COUNT']
       [option:--switch-timer='PERIODUS'] [option:--read-timer='PERIODUS']
@@ -22,7 +22,7 @@ Create a Linux kernel channel:
 Create a user space channel:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *enable-channel* option:--userspace
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *enable-channel* option:--userspace
       [option:--discard | option:--overwrite] [option:--buffers-pid]
       [option:--subbuf-size='SIZE'] [option:--num-subbuf='COUNT']
       [option:--switch-timer='PERIODUS'] [option:--read-timer='PERIODUS']
@@ -32,7 +32,7 @@ Create a user space channel:
 Enable existing channel(s):
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *enable-channel* (option:--userspace | option:--kernel)
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *enable-channel* (option:--userspace | option:--kernel)
       [option:--session='SESSION'] 'CHANNEL'[,'CHANNEL']...
 
 

diff --git a/doc/man/lttng-enable-event.1.txt b/doc/man/lttng-enable-event.1.txt
index eee7eb4241b88ef56f7165444df0cf239a50936e..6a5bd17365f11e71b6be5a07eb175b52aa374bfe 100644 (file)
--- a/doc/man/lttng-enable-event.1.txt
+++ b/doc/man/lttng-enable-event.1.txt
@@ -12,7 +12,7 @@ SYNOPSIS
 Create or enable Linux kernel event rules:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *enable-event* option:--kernel
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *enable-event* option:--kernel
       [option:--probe='SOURCE' | option:--function='SOURCE' | option:--syscall]
       [option:--filter='EXPR'] [option:--session='SESSION']
       [option:--channel='CHANNEL'] 'EVENT'[,'EVENT']...
@@ -20,13 +20,13 @@ Create or enable Linux kernel event rules:
 Create or enable an "all" Linux kernel event rule:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *enable-event* option:--kernel option:--all [option:--syscall]
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *enable-event* option:--kernel option:--all [option:--syscall]
       [option:--filter='EXPR'] [option:--session='SESSION'] [option:--channel='CHANNEL']
 
 Create or enable application event rules:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *enable-event*
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *enable-event*
       (option:--userspace | option:--jul | option:--log4j | option:--python)
       [option:--filter='EXPR'] [option:--exclude='EVENT'[,'EVENT']...]
       [option:--loglevel='LOGLEVEL' | option:--loglevel-only='LOGLEVEL']

diff --git a/doc/man/lttng-help.1.txt b/doc/man/lttng-help.1.txt
index c0f4d6442ae1c1b622398cb9f5db18acc08d0410..558792e79bfa46e81fba83002f2e1938bb9c90fc 100644 (file)
--- a/doc/man/lttng-help.1.txt
+++ b/doc/man/lttng-help.1.txt
@@ -10,7 +10,7 @@ lttng-help - Display help information about an LTTng command
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *help* ['COMMAND']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *help* ['COMMAND']
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-list.1.txt b/doc/man/lttng-list.1.txt
index 0edda6e3543405725397f5a936b9699a0d8332a9..b0daca8af60a785258badbddaba5413ee18bf8c1 100644 (file)
--- a/doc/man/lttng-list.1.txt
+++ b/doc/man/lttng-list.1.txt
@@ -12,23 +12,23 @@ SYNOPSIS
 List existing tracing sessions:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *list*
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *list*
 
 List available event sources:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *list* [option:--fields]
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *list* [option:--fields]
       [option:--kernel [option:--syscall]] [option:--userspace] [option:--jul] [option:--log4j] [option:--python]
 
 List tracing session's domains:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *list* option:--domain 'SESSION'
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *list* option:--domain 'SESSION'
 
 List tracing session's channels and event rules:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *list* [option:--channel='CHANNEL'] 'SESSION'
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *list* [option:--channel='CHANNEL'] 'SESSION'
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-load.1.txt b/doc/man/lttng-load.1.txt
index 11ab2f6c614dfbf018b49627e6b92926706c58d7..e4cff034f4498b5c6cd89e4cc0e936babe74eb54 100644 (file)
--- a/doc/man/lttng-load.1.txt
+++ b/doc/man/lttng-load.1.txt
@@ -10,7 +10,7 @@ lttng-load - Load LTTng tracing session configurations
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *load* [option:--force] [option:--input-path='PATH'] ['SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *load* [option:--force] [option:--input-path='PATH'] ['SESSION']
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-metadata.1.txt b/doc/man/lttng-metadata.1.txt
index a146c93243d6c32b51b3472f222ea6ac8ba66e46..dfe3d54e447cce790957d13d4b6929e72df40d1f 100644 (file)
--- a/doc/man/lttng-metadata.1.txt
+++ b/doc/man/lttng-metadata.1.txt
@@ -10,7 +10,7 @@ lttng-metadata - Manage an LTTng tracing session's metadata generation
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *metadata regenerate* [option:--session='SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *metadata regenerate* [option:--session='SESSION']
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-save.1.txt b/doc/man/lttng-save.1.txt
index 1b69d078a397c6ef34cd386488b9d92fd4f5c46f..f7b1c219043e3dfefe52313991d444a82d684d9a 100644 (file)
--- a/doc/man/lttng-save.1.txt
+++ b/doc/man/lttng-save.1.txt
@@ -10,7 +10,7 @@ lttng-save - Save LTTng tracing session configurations
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *save* [option:--force] [option:--output-path='PATH'] ['SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *save* [option:--force] [option:--output-path='PATH'] ['SESSION']
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-set-session.1.txt b/doc/man/lttng-set-session.1.txt
index 6e233e946e457f4f295389e7f495aed56fca935e..998266affb5b1a243197988b5e0894a54c5af019 100644 (file)
--- a/doc/man/lttng-set-session.1.txt
+++ b/doc/man/lttng-set-session.1.txt
@@ -10,7 +10,7 @@ lttng-set-session - Set the current LTTng tracing session
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *set-session* 'SESSION'
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *set-session* 'SESSION'
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-snapshot.1.txt b/doc/man/lttng-snapshot.1.txt
index 2d2b6c68fd5d5167c2b00a8485c12f0dd8769de0..7dcfa00a1ed78387eb1259b978b3dfc3e6bd2a53 100644 (file)
--- a/doc/man/lttng-snapshot.1.txt
+++ b/doc/man/lttng-snapshot.1.txt
@@ -12,25 +12,25 @@ SYNOPSIS
 Add a snapshot output:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *snapshot add-output* [option:--max-size='SIZE']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *snapshot add-output* [option:--max-size='SIZE']
       [option:--name='NAME'] [option:--session='SESSION']
       (option:--ctrl-url='URL' option:--data-url='URL' | 'URL')
 
 Remove a snapshot output:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *snapshot del-output* [option:--session='SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *snapshot del-output* [option:--session='SESSION']
       ('ID' | 'NAME')
 
 List current snapshot outputs:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *snapshot list-output* [option:--session='SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *snapshot list-output* [option:--session='SESSION']
 
 Take a snapshot:
 
 [verse]
-*lttng* ['GENERAL OPTIONS'] *snapshot record* [option:--max-size='SIZE']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *snapshot record* [option:--max-size='SIZE']
       [option:--name='NAME'] [option:--session='SESSION']
       (option:--ctrl-url='URL' option:--data-url='URL' | 'URL')
 

diff --git a/doc/man/lttng-start.1.txt b/doc/man/lttng-start.1.txt
index fff2cf9e2eaf1dbd125902d251a5f908b57e08cd..2c9405bacc82336a8e391398d0ba2624eac7ad01 100644 (file)
--- a/doc/man/lttng-start.1.txt
+++ b/doc/man/lttng-start.1.txt
@@ -10,7 +10,7 @@ lttng-start - Start LTTng tracers
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *start* ['SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *start* ['SESSION']
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-status.1.txt b/doc/man/lttng-status.1.txt
index b156db0a724b772192610dd186e58b34d8e3fff9..5bc6032f59385576519665cc5f77a94d4cee2769 100644 (file)
--- a/doc/man/lttng-status.1.txt
+++ b/doc/man/lttng-status.1.txt
@@ -10,7 +10,7 @@ lttng-status - Get the current LTTng tracing session's status
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *status*
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *status*
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-stop.1.txt b/doc/man/lttng-stop.1.txt
index 10ed6b60eac6a4e4cba0f85e16c65abf4111aa85..7d71f3be882d7524c929026c20bb03d7cc2bdbad 100644 (file)
--- a/doc/man/lttng-stop.1.txt
+++ b/doc/man/lttng-stop.1.txt
@@ -10,7 +10,7 @@ lttng-stop - Stop LTTng tracers
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *stop* [option:--no-wait] ['SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *stop* [option:--no-wait] ['SESSION']
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-track.1.txt b/doc/man/lttng-track.1.txt
index 9e0d2263ff62594a53ca95c646e858713f3d1f37..78bde140f673fcfe596ee2630bd3a1f17d82ec0e 100644 (file)
--- a/doc/man/lttng-track.1.txt
+++ b/doc/man/lttng-track.1.txt
@@ -10,7 +10,7 @@ lttng-track - Add one or more entries to an LTTng resource tracker
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *track* (option:--kernel | option:--userspace)
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *track* (option:--kernel | option:--userspace)
       [option:--session='SESSION'] (option:--pid='PID'[,'PID']... | option:--all option:--pid)
 
 

diff --git a/doc/man/lttng-untrack.1.txt b/doc/man/lttng-untrack.1.txt
index b57150633d6a66937a289baddfe0563f0d982c8c..b7da339df9c06b2204d0d23b3ed6a8bc9428bf67 100644 (file)
--- a/doc/man/lttng-untrack.1.txt
+++ b/doc/man/lttng-untrack.1.txt
@@ -10,7 +10,7 @@ lttng-untrack - Remove one or more entries from an LTTng resource tracker
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *untrack* (option:--kernel | option:--userspace)
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *untrack* (option:--kernel | option:--userspace)
       [option:--session='SESSION'] (option:--pid='PID'[,'PID']... | option:--all option:--pid)
 
 

diff --git a/doc/man/lttng-version.1.txt b/doc/man/lttng-version.1.txt
index 8c5148f1bfc4c869170eb8ddf18ff2a0c4967e0a..a8397286dc9d16de07b32854a62a09af68558de5 100644 (file)
--- a/doc/man/lttng-version.1.txt
+++ b/doc/man/lttng-version.1.txt
@@ -10,7 +10,7 @@ lttng-version - Get the version of LTTng-tools
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *version*
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *version*
 
 
 DESCRIPTION

diff --git a/doc/man/lttng-view.1.txt b/doc/man/lttng-view.1.txt
index 184328b51084c64c418138812fc783e177dac94a..722a04040b3f8d696490b4b4f4a3e3c051d7faca 100644 (file)
--- a/doc/man/lttng-view.1.txt
+++ b/doc/man/lttng-view.1.txt
@@ -10,7 +10,7 @@ lttng-view - View the traces of an LTTng tracing session
 SYNOPSIS
 --------
 [verse]
-*lttng* ['GENERAL OPTIONS'] *view* [option:--viewer='CMD'] [option:--trace-path='PATH' | 'SESSION']
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *view* [option:--viewer='CMD'] [option:--trace-path='PATH' | 'SESSION']
 
 
 DESCRIPTION