doc/man: add typical `$` and `#` prompts to command lines
[lttng-ust.git] / doc / man / tracelog.3.txt
index 139e91bedccfec10224e441835f60214ee03a4de..1281ce7c8d940d5ec35d26055e3ed13d8c2fc3af 100644 (file)
@@ -5,7 +5,7 @@ tracelog(3)
 
 NAME
 ----
-tracelog - LTTng-UST man:printf(3)-like interface with a log level
+tracelog - LTTng-UST printf(3)-like interface with a log level
 
 
 SYNOPSIS
@@ -47,13 +47,21 @@ command.
 The `tracelog()` events contain the following fields:
 
 [options="header"]
-|===============================================================
-| Field name | Description
-| `line`     | Line in source file where `tracelog()` was called
-| `file`     | Source file from which `tracelog()` was called
-| `func`     | Function name from which `tracelog()` was called
-| `msg`      | Formatted string output
-|===============================================================
+|===
+|Field name |Description
+
+|`line`
+|Line in source file where `tracelog()` was called.
+
+|`file`
+|Source file from which `tracelog()` was called.
+
+|`func`
+|Function name from which `tracelog()` was called.
+
+|`msg`
+|Formatted string output.
+|===
 
 If you do not need to attach a specific log level to a `tracelog()`
 call, use man:tracef(3) instead.
@@ -96,43 +104,43 @@ This C source file, saved as `app.c`, can be compiled into a program
 like this:
 
 [role="term"]
----------------------------
-cc -o app app.c -llttng-ust
----------------------------
+----
+cc -o app app.c -llttng-ust
+----
 
 You can create an LTTng tracing session, enable all the `tracelog()`
 events, and start the created tracing session like this:
 
 [role="term"]
----------------------------------------------------
-lttng create my-session
-lttng enable-event --userspace 'lttng_ust_tracelog:*'
-lttng start
----------------------------------------------------
+----
+lttng create my-session
+lttng enable-event --userspace 'lttng_ust_tracelog:*'
+lttng start
+----
 
 Or you can enable `tracelog()` events matching a log level at least
 as severe as a given log level:
 
 [role="term"]
--------------------------------------------------------
-lttng enable-event --userspace 'lttng_ust_tracelog:*' \
+----
+lttng enable-event --userspace 'lttng_ust_tracelog:*' \
                    --loglevel=TRACE_INFO
--------------------------------------------------------
+----
 
 Next, start the program to be traced:
 
 [role="term"]
-------------------------------------------------
-./app a few arguments passed to this application
-------------------------------------------------
+----
+./app a few arguments passed to this application
+----
 
 Finally, stop the tracing session, and inspect the recorded events:
 
 [role="term"]
-----------
-lttng stop
-lttng view
-----------
+----
+lttng stop
+lttng view
+----
 
 
 [[limitations]]
This page took 0.0252 seconds and 5 git commands to generate.