texinfo: Inserting a Comma

Special Characters

Inserting a Backslash

Inserting Braces

Back to Software 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' (Note: @acronym) and '@xref' (Note: Cross References), as
well as user-defined macros (Note: 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.)