@definfoenclose: Customized Highlighting ¶
@definfoenclose command may be used to define a
highlighting command for online output formats. A command
@definfoenclose marks text by enclosing it in
strings that precede and follow the text.
In practice, there is little use for this command, and we do not
recommend you use it. Support for
@definfoenclose may be
removed in future releases of Texinfo.
@definfoenclose command at the beginning of a line
followed by three comma-separated arguments. The first argument to
@definfoenclose is the @-command name (without the
@); the second argument is the start delimiter string; and the
third argument is the end delimiter string. The latter two arguments
enclose the highlighted text in the output.
A delimiter string may contain spaces. Neither the start nor end delimiter is required. If you do not want a start delimiter but do want an end delimiter, you must follow the command name with two commas in a row; otherwise, the end delimiter string you intended will naturally be (mis)interpreted as the start delimiter string.
An enclosure command defined this way takes one argument in braces, since it is intended for new markup commands (see Marking Text, Words and Phrases).
For example, you can write:
near the beginning of a Texinfo file to define
@phoo as an Info
and HTML formatting command that inserts ‘//’ before and ‘\\’ after the
@phoo. You can then write
wherever you want ‘//bar\\’ highlighted in Info and HTML.
For TeX formatting, you could write
@iftex @alias phoo = i @end iftex
@phoo as a command that causes TeX to typeset the
@phoo in italics.
Each definition applies to its own formatter: one for TeX, the
other for online formats. The TeX definitions need to be in
@definfoenclose command need not be within
‘@ifinfo’ unless you want to use different definitions for
different online output formats.
commands have no effect in DocBook and LaTeX output, their
argument is output as-is. An
@alias could also be used
for these formats.
@definfoenclose definitions must not be recursive, directly or