[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
branch master updated: * doc/texinfo.texi (@code): Move treatment of Inf
From: |
Gavin D. Smith |
Subject: |
branch master updated: * doc/texinfo.texi (@code): Move treatment of Info/plaintext output together and reinstate some removed text. |
Date: |
Mon, 17 Oct 2022 16:31:27 -0400 |
This is an automated email from the git hooks/post-receive script.
gavin pushed a commit to branch master
in repository texinfo.
The following commit(s) were added to refs/heads/master by this push:
new 2741982ae2 * doc/texinfo.texi (@code): Move treatment of
Info/plaintext output together and reinstate some removed text.
2741982ae2 is described below
commit 2741982ae29d2de1ed7f60b02975bd0773379690
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Mon Oct 17 21:31:19 2022 +0100
* doc/texinfo.texi (@code): Move treatment of Info/plaintext
output together and reinstate some removed text.
---
ChangeLog | 5 +++++
doc/texinfo.texi | 21 ++++++++++++---------
2 files changed, 17 insertions(+), 9 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 89f720bb4c..cac6fe923f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2022-10-17 Gavin Smith <gavinsmith0123@gmail.com>
+
+ * doc/texinfo.texi (@code): Move treatment of Info/plaintext
+ output together and reinstate some removed text.
+
2022-10-17 Gavin Smith <gavinsmith0123@gmail.com>
* doc/texinfo.texi (Defining New Texinfo Commands):
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 5b46c6ccab..2ab95993be 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -5427,9 +5427,8 @@ ways. Pick one spelling and always use that. If you do
not want to
start a sentence with a command name written all in lowercase, you
should rearrange the sentence.
-In the Info output, @code{@@code} results in single quotation marks
-around the text. In other formats, @code{@@code} argument is typeset
-in a typewriter (monospace) font. For example,
+The @code{@@code} argument is typeset in a typewriter (monospace) font.
+where the output format allows this. For example,
@example
The function returns @@code@{nil@}.
@@ -5486,12 +5485,16 @@ can be controlled with @code{@@allowcodebreaks}
lines is up to the browser's behavior. For Info, it seems better
never to make such breaks.
-To control which quoting characters are implicitly inserted by
-@command{texi2any} in the output of @samp{@@code} and other highlighting
-commands, see the @code{OPEN_QUOTE_SYMBOL} and @code{CLOSE_QUOTE_SYMBOL}
-customization variables (@pxref{Other Customization Variables}). This
-is separate from how actual quotation characters in the input document
-are handled (@pxref{Inserting Quote Characters}).
+For Info and plaintext, quotation characters are usually output around
+the output of the @code{@@code} command and related commands
+(e.g., @code{@@kbd}, @code{@@command}) except
+in typewriter-like contexts such as the @code{@@example} environment
+(@pxref{@code{@@example}}) and @code{@@code} itself, etc.
+To control which quoting characters are inserted by
+@command{texi2any} in the output of @samp{@@code}, etc., see the
+@code{OPEN_QUOTE_SYMBOL} and @code{CLOSE_QUOTE_SYMBOL} customization
+variables (@pxref{Other Customization Variables}).
+
@node @code{@@kbd}
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- branch master updated: * doc/texinfo.texi (@code): Move treatment of Info/plaintext output together and reinstate some removed text.,
Gavin D. Smith <=