+* [[opt-macro]] **LTTng command-line options**: Starting from v2.8,
+ always use the +opt:__command__(__section__):__option__+ macro when
+ you refer to a command-line option described in an LTTng man page.
++
+.Using the `opt` macro.
+====
+----
+You can use the opt:lttng-enable-event(1):--filter option to set the
+filter expression of an event rule.
+----
+====
+
+* **File names**: Always use the +path:{__path__}+ macro when you need
+ to write a file name.