[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[5944] @c[omment] must not be followed by -
From: |
karl |
Subject: |
[5944] @c[omment] must not be followed by - |
Date: |
Thu, 27 Nov 2014 18:33:37 +0000 |
Revision: 5944
http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=5944
Author: karl
Date: 2014-11-27 18:33:36 +0000 (Thu, 27 Nov 2014)
Log Message:
-----------
@c[omment] must not be followed by -
Modified Paths:
--------------
trunk/ChangeLog
trunk/doc/texinfo.texi
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2014-11-27 18:27:44 UTC (rev 5943)
+++ trunk/ChangeLog 2014-11-27 18:33:36 UTC (rev 5944)
@@ -1,5 +1,8 @@
2014-11-27 Karl Berry <address@hidden>
+ * doc/texinfo.texi (Comments): must not be followed by -.
+ Patrice, texinfo-devel 22 Nov 2014 15:18:07.
+
* doc/texinfo.texi (@noindent, @indent): more explicitly describe
recommendations and current behavior.
Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi 2014-11-27 18:27:44 UTC (rev 5943)
+++ trunk/doc/texinfo.texi 2014-11-27 18:33:36 UTC (rev 5944)
@@ -1380,7 +1380,10 @@
command, which may be abbreviated to @code{@@c}. Such comments are
for a person looking at the Texinfo source file. All the text on a
line that follows either @code{@@comment} or @code{@@c} is a comment;
-the rest of the line does not appear in the visible output.
+the rest of the line does not appear in the visible output. (To be
+precise, the character after the @code{@@c} or @code{@@comment} must
+be something other than a dash or alphanumeric, or it will be taken as
+part of the command.)
Often, you can write the @code{@@comment} or @code{@@c} in the middle
of a line, and only the text that follows after the @code{@@comment}
@@ -1401,14 +1404,13 @@
@cindex Ignored text
@cindex Unprocessed text
@findex ignore
-You can also have long stretches of text to be ignored by the Texinfo
+You can also have long stretches of text ignored by the Texinfo
processors with the @code{@@ignore} and @code{@@end ignore} 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}
-and @code{@@end ignore} for writing comments. (For some technical
-caveats regarding nesting of such commands, @pxref{Conditional
-Nesting}.)
+and @code{@@end ignore} for writing comments. (For some caveats
+regarding nesting of such commands, @pxref{Conditional Nesting}.)
@node Minimum
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [5944] @c[omment] must not be followed by -,
karl <=