X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Fasciidoc.conf;h=ed697b83b620d436593de6d250aaa6c8387fb3c4;hb=31099add7a58b2a671f9324aa023a4dc5ae000f1;hp=3f8cac41e36c365c3f0306eb776f4c854a8be7b1;hpb=f95ec87d0f3f4a6c8119e95394bbb5b3aed3a651;p=lttng-tools.git diff --git a/doc/man/asciidoc.conf b/doc/man/asciidoc.conf index 3f8cac41e..ed697b83b 100644 --- a/doc/man/asciidoc.conf +++ b/doc/man/asciidoc.conf @@ -1,12 +1,27 @@ [macros] -# linklttng macro +# man macro # # Inspired by linkgit macro: # # -# Usage: linklttng:command(manpage-section) -(?su)[\\]?(?Plinklttng):(?P\S*?)\((?P.*?)\)= +# Usage: man:command(manpage-section) +(?su)[\\]?(?Pman):(?P\S*?)\((?P.*?)\)= + +# linkgenoptions macro +# +# Usage: linkgenoptions:(text) +(?su)[\\]?(?Plinkgenoptions):\((?P.*?)\)= + +# no link option macro +# +# Usage: nloption:--option-name +(?su)[\\]?(?Pnloption):(?P--?[a-zA-Z0-9-]*)= + +# lttng(1) general option macro +# +# Usage: genoption:--option-name +(?su)[\\]?(?Pgenoption):(?P--?[a-zA-Z0-9-]*)= # option macro # @@ -18,26 +33,82 @@ # Usage: :not: :not:=not -# linklttng macro expansions +# escwc macro +# +# Usage: :escwc: +:escwc:=escwc + +# esccomma macro +# +# Usage: :esccomma: +:esccomma:=esccomma + +# man macro expansions +ifdef::doctype-manpage[] ifdef::backend-docbook[] -[linklttng-inlinemacro] +[man-inlinemacro] {0%{target}} {0#} {0#{target}{0}} {0#} endif::backend-docbook[] +endif::doctype-manpage[] + +# linkgenoptions macro expansions +ifdef::doctype-manpage[] +ifdef::backend-docbook[] +[linkgenoptions-inlinemacro] +{text} +endif::backend-docbook[] +endif::doctype-manpage[] # option macro expansions +ifdef::doctype-manpage[] ifdef::backend-docbook[] [option-inlinemacro] {opt} endif::backend-docbook[] +endif::doctype-manpage[] + +# no link option macro expansions +ifdef::doctype-manpage[] +ifdef::backend-docbook[] +[nloption-inlinemacro] +{opt} +endif::backend-docbook[] +endif::doctype-manpage[] + +# lttng(1) general option macro expansions +ifdef::doctype-manpage[] +ifdef::backend-docbook[] +[genoption-inlinemacro] +{opt} +endif::backend-docbook[] +endif::doctype-manpage[] # not macro expansions +ifdef::doctype-manpage[] ifdef::backend-docbook[] [not-inlinemacro] NOT endif::backend-docbook[] +endif::doctype-manpage[] + +# escwc macro expansions +ifdef::doctype-manpage[] +ifdef::backend-docbook[] +[escwc-inlinemacro] +\e* +endif::backend-docbook[] +endif::doctype-manpage[] + +# esccomma macro expansions +ifdef::doctype-manpage[] +ifdef::backend-docbook[] +[esccomma-inlinemacro] +\e, +endif::backend-docbook[] +endif::doctype-manpage[] # configure XML man page header ifdef::doctype-manpage[]