Viewing File: /usr/share/doc/texinfo/html/Inserting-a-Comma.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.7, 23 September 2019),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.

Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019 Free Software
Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts.  A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Inserting a Comma (GNU Texinfo 6.7)</title>

<meta name="description" content="Inserting a Comma (GNU Texinfo 6.7)">
<meta name="keywords" content="Inserting a Comma (GNU Texinfo 6.7)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<link href="index.html" rel="start" title="Top">
<link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Special-Characters.html" rel="up" title="Special Characters">
<link href="Inserting-a-Backslash.html" rel="next" title="Inserting a Backslash">
<link href="Inserting-Braces.html" rel="prev" title="Inserting Braces">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<span id="Inserting-a-Comma"></span><div class="header">
<p>
Next: <a href="Inserting-a-Backslash.html" accesskey="n" rel="next">Inserting a Backslash</a>, Previous: <a href="Inserting-Braces.html" accesskey="p" rel="prev">Inserting Braces</a>, Up: <a href="Special-Characters.html" accesskey="u" rel="up">Special Characters</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Inserting-_0060_002c_0027-with-_0040comma_007b_007d"></span><h4 class="subsection">12.1.3 Inserting &lsquo;,&rsquo; with <code>@comma{}</code></h4>

<span id="index-comma"></span>
<span id="index-Comma_002c-inserting"></span>

<p>Ordinarily, a comma &lsquo;,&rsquo; is a normal character that can be simply typed
in your input where you need it.
</p>
<p>However, Texinfo uses the comma as a special character only in one
context: to separate arguments to those Texinfo commands, such as
<code>@acronym</code> (see <a href="_0040acronym.html"><code>@acronym</code></a>) and <code>@xref</code>
(see <a href="Cross-References.html">Cross References</a>), as well as user-defined macros
(see <a href="Defining-Macros.html">Defining Macros</a>), which take more than one argument.
</p>
<p>Since a comma character would confuse Texinfo&rsquo;s parsing for these
commands, you must use the command &lsquo;<samp>@comma{}</samp>&rsquo; instead if you want
to pass an actual comma.  Here are some examples:
</p>
<div class="example">
<pre class="example">@acronym{ABC, A Bizarre @comma{}}
@xref{Comma,, The @comma{} symbol}
@mymac{One argument@comma{} containing a comma}
</pre></div>

<p>Although &lsquo;<samp>@comma{}</samp>&rsquo; can be used nearly anywhere, there is no
need for it anywhere except in this unusual case.
</p>
<p>(Incidentally, the name &lsquo;<samp>@comma</samp>&rsquo; lacks the &lsquo;<samp>char</samp>&rsquo; suffix used
in its companion commands only for historical reasons.  It didn&rsquo;t seem
important enough to define a synonym.)
</p>




</body>
</html>
Back to Directory File Manager