branch master updated: * doc/texinfo.texi (Other Customization Variables), * NEWS: Document ASCII_DASHES_AND_QUOTES and ASCII_GLYPH.

[Gavin D. Smith]

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 df0ab90694 * doc/texinfo.texi (Other Customization Variables), * NEWS: 
Document ASCII_DASHES_AND_QUOTES and ASCII_GLYPH.
df0ab90694 is described below

commit df0ab906940716eaa6509de582ab420bba0efc09
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Mon Feb 27 22:39:01 2023 +0000

    * doc/texinfo.texi (Other Customization Variables),
    * NEWS: Document ASCII_DASHES_AND_QUOTES and ASCII_GLYPH.
---
 ChangeLog        |  5 +++++
 NEWS             | 19 ++++++++++++++-----
 doc/texinfo.texi | 22 +++++++++++++++++-----
 3 files changed, 36 insertions(+), 10 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index ad8fa12acf..568514733a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2023-02-27  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (Other Customization Variables),
+       * NEWS: Document ASCII_DASHES_AND_QUOTES and ASCII_GLYPH.
+
 2023-02-27  Gavin Smith <gavinsmith0123@gmail.com>
 
        Nuke obsolete XS overrides
diff --git a/NEWS b/NEWS
index 1dd424f634..9e8c34635b 100644
--- a/NEWS
+++ b/NEWS
@@ -16,13 +16,14 @@ See the manual for detailed information.
  . @itemx at the beginning of a @table is now an error, not a warning
  . better validity checking of deeply nested commands
  . @set and @clear should only appear at the start of a line
- . --enable-encoding and --disable-encoding do not determine anymore
-   if encoded characters are output instead of entities or commands for
-   HTML, XML, DocBook and LaTeX, instead the OUTPUT_CHARACTERS customization
-   variable value is used.
+ . --enable-encoding and --disable-encoding no longer determine whether
+   encoded characters are output instead of entities or commands for
+   HTML, XML, DocBook and LaTeX; instead, the value of the OUTPUT_CHARACTERS
+   customization variable is used.
  . Add source marks in the tree for all Texinfo source information that
    is not in the final tree (location of macro, values and included files
-   expansion, @if* blocks, DEL comment, @ protecting end of line on @def* 
lines).
+   expansion, @if* blocks, DEL comment, @ protecting end of line on @def*
+   lines).
  . HTML output:
     . format @subentry and index entry with @seealso or @seeentry more in line
       with printed output.
@@ -30,6 +31,14 @@ See the manual for detailed information.
     . omit colons after index entries by default.  this can still be
       configured with INDEX_ENTRY_COLON.
     . add @example syntax highlighting as a texi2any extension.
+ . Info output:
+    . new variable ASCII_HYPHENS_AND_QUOTES, on by default,
+      outputs ASCII characters for literal quote or hyphen characters
+      in source rather than UTF-8.  this makes it easier to search
+      Info files.
+    . new ASCII_GLYPH variable for using ASCII renditions for glyph
+      commands (like @bullet).
+    . ASCII_PUNCTUATION still includes the effect of these new variables.
  . XML output:
     . menu leading text and menu separator in elements instead of attributes.
 
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index f27c82eec6..1adf13153e 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -16797,12 +16797,24 @@ multiple formats, or affect global behavior, or 
otherwise don't fit
 into the categories of the previous sections.
 
 @vtable @code
+@item ASCII_DASHES_AND_QUOTES
+For Info output, when set, use plain ASCII characters to represent
+quotation marks, hyphens and dashes when these are given in the Texinfo
+source as @samp{-}, @samp{--}, @samp{---}, @samp{`}, @samp{``},
+@samp{'}, and @samp{''}, rather than UTF-8 directional quotation marks,
+en dashes, vel sim.  On by default.
+
+@item ASCII_GLYPH
+For Info output, use ASCII output for glyph commands such as the copyright
+sign (@command{@@copyright@{@}}, becoming @samp{(C)}),
+and the bullet symbol (@command{@@bullet@{@}}, becoming @samp{*}), rather
+than other Unicode sequences.  Off by default.
+
 @item ASCII_PUNCTUATION
-For Info output.  When set, use plain ASCII characters to represent
-quotation marks, rather than the directional quotation marks available
-in UTF-8.  Also use ASCII for a few other constructs; for example, the
-copyright sign (@command{@@copyright@{@}}, becoming @samp{(C)}),
-and the bullet symbol (@command{@@bullet@{@}}, becoming @samp{*}).
+Avoid any unncessary or gratuitious non-ASCII, UTF-8 sequences in the
+output.  Implies both @code{ASCII_DASHES_AND_QUOTES} and @code{ASCII_GLYPH}
+and additionally affects the output of commands such as @code{@@samp} which
+output quotation marks.
 
 @item CHECK_NORMAL_MENU_STRUCTURE
 Warn if the nodes pointers (either explicitly or automatically set)