[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[no subject]
From: |
Gavin D. Smith |
Date: |
Wed, 25 Oct 2023 09:22:41 -0400 (EDT) |
branch: master
commit d6c1b80bd88268f91c09439cb03766d91d140651
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Wed Oct 25 13:21:37 2023 +0100
* doc/texinfo.texi (Conventions)
<whitespace>: Reword slightly.
<@ignore'd section on form feeds>: Do not say that FF are kept
between paragraphs in Info output, as this does not currently
appear to be the case.
<@ignore'd section on Emacs>: Delete altogether.
---
ChangeLog | 9 +++++++++
doc/texinfo.texi | 31 ++++++++++++-------------------
2 files changed, 21 insertions(+), 19 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index be6f7e95ce..9c97a98a3f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2023-10-25 Gavin Smith <gavinsmith0123@gmail.com>
+
+ * doc/texinfo.texi (Conventions)
+ <whitespace>: Reword slightly.
+ <@ignore'd section on form feeds>: Do not say that FF are kept
+ between paragraphs in Info output, as this does not currently
+ appear to be the case.
+ <@ignore'd section on Emacs>: Delete altogether.
+
2023-10-25 Gavin Smith <gavinsmith0123@gmail.com>
* tp/Texinfo/XS/main/errors.c (message_list_line_error_internal):
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 06acf9dbee..ba3a877fc7 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -788,25 +788,18 @@ verbatim modes).
@cindex Form feed character
@cindex @kbd{CTRL-l}
-Form feed (@kbd{CTRL-l}) characters in normal text end any open paragraph.
-Other ASCII whitespace (tab, carriage return) may be treated
-the same as space characters, although the results may differ depending
-on output format. Hence, there is not much point in using these
-in documents. Non-ASCII spaces, such as Unicode ``em space'', are
-not recognized as whitespace at all and will be treated as regular,
-non-whitespace characters.
+
+Form feed (@kbd{CTRL-l}) characters terminate any open paragraph.
+Other form feeds, as well other ASCII whitespace (tab, carriage return)
+are treated the same as space characters (although the results may
+differ depending on the output format). Hence, there is not much point
+in using these whitespace characters in documents. Non-ASCII spaces,
+such as Unicode ``em space'', are not recognized as whitespace at all,
+and will be treated as regular, non-whitespace characters.
However, in verbatim modes, for example in code samples, tab characters
may produce the correct formatting in the output.
-@ignore @c Excessive detail?
-
-To avoid this problem, Texinfo mode in GNU Emacs inserts
-multiple spaces when you press the @key{TAB} key. Also, you can run
-@code{untabify} in Emacs to convert tabs in a region to multiple
-spaces, or use the @code{unexpand} command from the shell.
-
-@end ignore
@ignore @c too detailed for the manual, but kept for implementation tips
@item
Form feed characters outside of a paragraph are handled as follows:
@@ -822,10 +815,10 @@ in the output otherwise.
@c Written as @code{\par@{@}}, a @LaTeX{} macro that starts a paragraph.
@item Info
-Output as-is between paragraphs (their most common use); ignored in contexts
-where spaces are ignored except after specific commands closing braces
-(@code{@@caption} for example). In other contexts, they may be treated as
-regular spaces (and thus consolidated with surrounding whitespace).
+Ignored in contexts where spaces are ignored except after specific
+commands closing braces (@code{@@caption} for example). In other
+contexts, they may be treated as regular spaces (and thus consolidated
+with surrounding whitespace).
@item HTML
Written as a numeric entity except contexts where spaces are ignored;