From bca82bfe61d7b17cd46891072a5bb0b2680a285d Mon Sep 17 00:00:00 2001 From: Philippe Proulx Date: Thu, 24 Mar 2016 14:00:38 -0400 Subject: [PATCH] doc/man: add escwc macro and use it 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/README.md | 6 ++++++ doc/man/asciidoc.conf | 11 +++++++++++ doc/man/lttng-enable-event.1.txt | 2 +- 3 files changed, 18 insertions(+), 1 deletion(-) diff --git a/doc/man/README.md b/doc/man/README.md index 21513ba0d..316c4d58c 100644 --- a/doc/man/README.md +++ b/doc/man/README.md @@ -69,6 +69,12 @@ Usage example: `genoption:--group`, `genoption:--sessiond-path` The `:not:` macro is used to emphasize on _not_. +### escwc + +The `:escwc:` macro is used to output `\*` literally in the man page, +which is not so easy to do otherwise. + + Includes -------- diff --git a/doc/man/asciidoc.conf b/doc/man/asciidoc.conf index baa697839..d6045fd20 100644 --- a/doc/man/asciidoc.conf +++ b/doc/man/asciidoc.conf @@ -33,6 +33,11 @@ # Usage: :not: :not:=not +# escwc macro +# +# Usage: :escwc: +:escwc:=escwc + # linklttng macro expansions ifdef::backend-docbook[] [linklttng-inlinemacro] @@ -72,6 +77,12 @@ ifdef::backend-docbook[] NOT endif::backend-docbook[] +# escwc macro expansions +ifdef::backend-docbook[] +[escwc-inlinemacro] +\e* +endif::backend-docbook[] + # configure XML man page header ifdef::doctype-manpage[] ifdef::backend-docbook[] diff --git a/doc/man/lttng-enable-event.1.txt b/doc/man/lttng-enable-event.1.txt index f8a630af5..f0755333c 100644 --- a/doc/man/lttng-enable-event.1.txt +++ b/doc/man/lttng-enable-event.1.txt @@ -234,7 +234,7 @@ expression evaluates to false (the event is discarded). C integer and floating point number constants are supported, as well as literal strings between double quotes (`"`). Literal strings can contain a wildcard character (`*`) at the end to match more than one string. -This wildcard can be escaped using `\\*`. +This wildcard can be escaped using :escwc:. LTTng-UST enumeration fields can be compared to integer values (fields or constants). -- 2.34.1