texinfo-commits
[Top][All Lists]
Advanced

[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}



reply via email to

[Prev in Thread] Current Thread [Next in Thread]