/usr/share/doc/texinfo/html/Inserting-a-Comma.html is in texinfo-doc-nonfree 6.5.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 | <!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.5, 25 August 2017),
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 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 the Front-Cover Texts being "A GNU Manual",
and with the Back-Cover Texts as in (a) below. A copy of the license
is included in the section entitled "GNU Free Documentation
License".
(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
modify this GNU manual. Buying copies from the FSF supports it in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 6.4.90, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Inserting a Comma (GNU Texinfo 6.5)</title>
<meta name="description" content="Inserting a Comma (GNU Texinfo 6.5)">
<meta name="keywords" content="Inserting a Comma (GNU Texinfo 6.5)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Command-and-Variable-Index.html#Command-and-Variable-Index" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Special-Characters.html#Special-Characters" rel="up" title="Special Characters">
<link href="Inserting-a-Backslash.html#Inserting-a-Backslash" rel="next" title="Inserting a Backslash">
<link href="Inserting-Braces.html#Inserting-Braces" rel="prev" title="Inserting Braces">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {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}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
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">
<a name="Inserting-a-Comma"></a>
<div class="header">
<p>
Next: <a href="Inserting-a-Backslash.html#Inserting-a-Backslash" accesskey="n" rel="next">Inserting a Backslash</a>, Previous: <a href="Inserting-Braces.html#Inserting-Braces" accesskey="p" rel="prev">Inserting Braces</a>, Up: <a href="Special-Characters.html#Special-Characters" accesskey="u" rel="up">Special Characters</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Inserting-_0060_002c_0027-with-_0040comma_007b_007d"></a>
<h4 class="subsection">12.1.3 Inserting ‘,’ with <code>@comma{}</code></h4>
<a name="index-comma"></a>
<a name="index-Comma_002c-inserting"></a>
<p>Ordinarily, a comma ‘,’ 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#g_t_0040acronym"><code>@acronym</code></a>) and <code>@xref</code>
(see <a href="Cross-References.html#Cross-References">Cross References</a>), as well as user-defined macros
(see <a href="Defining-Macros.html#Defining-Macros">Defining Macros</a>), which take more than one argument.
</p>
<p>Since a comma character would confuse Texinfo’s parsing for these
commands, you must use the command ‘<samp>@comma{}</samp>’ 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 ‘<samp>@comma{}</samp>’ can be used nearly anywhere, there is no
need for it anywhere except in this unusual case.
</p>
<p>(Incidentally, the name ‘<samp>@comma</samp>’ lacks the ‘<samp>char</samp>’ suffix used
in its companion commands only for historical reasons. It didn’t seem
important enough to define a synonym.)
</p>
</body>
</html>
|