Next: , Previous: , Up: Special Characters   [Contents][Index]

14.1.3 Inserting ‘,’ with @comma{}

Ordinarily, a comma ‘,’ is a normal character that can be simply typed in your input where you need it.

However, Texinfo uses the comma as a special character only in one context: to separate arguments to those Texinfo commands, such as @acronym (see @acronym) and @xref (see Cross References), as well as user-defined macros (see Defining Macros), which take more than one argument.

Since a comma character would confuse Texinfo’s parsing for these commands, you must use the command ‘@comma{}’ instead if you want to pass an actual comma. Here are some examples:

@acronym{ABC, A Bizarre @comma{}}
@xref{Comma,, The @comma{} symbol}
@mymac{One argument@comma{} containing a comma}

Although ‘@comma{}’ can be used nearly anywhere, there is no need for it anywhere except in this unusual case.

(Incidentally, the name ‘@comma’ lacks the ‘char’ suffix used in its companion commands only for historical reasons. It didn’t seem important enough to define a synonym.)