/usr/share/doc/texinfo/html/Comments.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 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 | <!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>Comments (GNU Texinfo 6.5)</title>
<meta name="description" content="Comments (GNU Texinfo 6.5)">
<meta name="keywords" content="Comments (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="Writing-a-Texinfo-File.html#Writing-a-Texinfo-File" rel="up" title="Writing a Texinfo File">
<link href="Minimum.html#Minimum" rel="next" title="Minimum">
<link href="Conventions.html#Conventions" rel="prev" title="Conventions">
<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="Comments"></a>
<div class="header">
<p>
Next: <a href="Minimum.html#Minimum" accesskey="n" rel="next">Minimum</a>, Previous: <a href="Conventions.html#Conventions" accesskey="p" rel="prev">Conventions</a>, Up: <a href="Writing-a-Texinfo-File.html#Writing-a-Texinfo-File" accesskey="u" rel="up">Writing a Texinfo File</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="Comments-1"></a>
<h3 class="section">2.2 Comments</h3>
<a name="index-Comments"></a>
<a name="index-comment"></a>
<a name="index-c"></a>
<p>You can write comments in a Texinfo file by using the <code>@comment</code>
command, which may be abbreviated to <code>@c</code>. Such comments are
for a person looking at the Texinfo source file. All the text on a
line that follows either <code>@comment</code> or <code>@c</code> is a comment;
the rest of the line does not appear in the visible output. (To be
precise, the character after the <code>@c</code> or <code>@comment</code> must
be something other than a dash or alphanumeric, or it will be taken as
part of the command.)
</p>
<p>Often, you can write the <code>@comment</code> or <code>@c</code> in the middle
of a line, and only the text that follows after the <code>@comment</code>
or <code>@c</code> command does not appear; but some commands, such as
<code>@settitle</code>, work on a whole line. You cannot use <code>@comment</code>
or <code>@c</code> within a line beginning with such a command.
</p>
<a name="index-DEL-_0028comment-character_0029"></a>
<a name="index-Catcode-for-comments-in-TeX"></a>
<p>In cases of nested command invocations, complicated macro definitions,
etc., <code>@c</code> and <code>@comment</code> may provoke an error when
processing with TeX. Therefore, you can also use the <kbd>DEL</kbd>
character (ASCII 127 decimal, 0x7f hex, 0177 octal) as a true TeX
comment character (catcode 14, in TeX internals). Everything on
the line after the <kbd>DEL</kbd> will be ignored.
</p>
<a name="index-Ignored-text"></a>
<a name="index-Unprocessed-text"></a>
<a name="index-ignore"></a>
<p>You can also have long stretches of text ignored by the Texinfo
processors with the <code>@ignore</code> and <code>@end ignore</code> commands.
Write each of these commands on a line of its own, starting each
command at the beginning of the line. Text between these two commands
does not appear in the processed output. You can use <code>@ignore</code>
and <code>@end ignore</code> for writing comments. (For some caveats
regarding nesting of such commands, see <a href="Conditional-Nesting.html#Conditional-Nesting">Conditional Nesting</a>.)
</p>
<hr>
<div class="header">
<p>
Next: <a href="Minimum.html#Minimum" accesskey="n" rel="next">Minimum</a>, Previous: <a href="Conventions.html#Conventions" accesskey="p" rel="prev">Conventions</a>, Up: <a href="Writing-a-Texinfo-File.html#Writing-a-Texinfo-File" accesskey="u" rel="up">Writing a Texinfo File</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>
</body>
</html>
|