doc/man/asciidoc.conf

   1 # SPDX-FileCopyrightText: 2016 Philippe Proulx <pproulx@efficios.com>
   2 #
   3 # SPDX-License-Identifier: CC-BY-4.0
   4
   5 [macros]
   6
   7 # man macro
   8 #
   9 # Inspired by linkgit macro:
  10 # <https://github.com/git/git/blob/master/Documentation/asciidoc.conf>
  11 #
  12 # Usage: man:command(manpage-section)
  13 (?su)[\\]?(?P<name>man):(?P<target>\S*?)\((?P<attrlist>.*?)\)=
  14
  15 # no link option macro
  16 #
  17 # Usage: nloption:--option-name
  18 (?su)[\\]?(?P<name>nloption):(?P<opt>--?[a-zA-Z0-9-]*)=
  19
  20 # option macro
  21 #
  22 # Usage: option:--option-name
  23 (?su)[\\]?(?P<name>option):(?P<opt>--?[a-zA-Z0-9-]*)=
  24
  25 # not macro
  26 #
  27 # Usage: :not:
  28 :not:=not
  29
  30 # man macro expansions
  31 ifdef::doctype-manpage[]
  32 ifdef::backend-docbook[]
  33 [man-inlinemacro]
  34 {0%{target}}
  35 {0#<citerefentry>}
  36 {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>}
  37 {0#</citerefentry>}
  38 endif::backend-docbook[]
  39 endif::doctype-manpage[]
  40
  41 # option macro expansions
  42 ifdef::doctype-manpage[]
  43 ifdef::backend-docbook[]
  44 [option-inlinemacro]
  45 <literal>{opt}</literal>
  46 endif::backend-docbook[]
  47 endif::doctype-manpage[]
  48
  49 # no link option macro expansions
  50 ifdef::doctype-manpage[]
  51 ifdef::backend-docbook[]
  52 [nloption-inlinemacro]
  53 <literal>{opt}</literal>
  54 endif::backend-docbook[]
  55 endif::doctype-manpage[]
  56
  57 # not macro expansions
  58 ifdef::doctype-manpage[]
  59 ifdef::backend-docbook[]
  60 [not-inlinemacro]
  61 NOT
  62 endif::backend-docbook[]
  63 endif::doctype-manpage[]