branch master updated: * doc/texinfo.texi (Microtypography), NEWS: Document @microtype.

[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 b1d2ef7550 * doc/texinfo.texi (Microtypography), NEWS: Document 
@microtype.
b1d2ef7550 is described below

commit b1d2ef75502491a3f891f10bcce1de536ef51ee2
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Sun Sep 25 19:03:57 2022 +0100

    * doc/texinfo.texi (Microtypography), NEWS: Document @microtype.
---
 ChangeLog        |  5 +++++
 NEWS             |  1 +
 doc/texinfo.texi | 24 ++++++++++++++++++++++++
 3 files changed, 30 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 960fcea10a..d5ba291dea 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2022-09-25  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (Microtypography), NEWS: Document @microtype.
+2022-09-25  Gavin Smith  <gavinsmith0123@gmail.com>
+
 2022-09-25  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/Common.pm (%line_commands), tp/Texinfo/Convert/DocBook.pm
diff --git a/NEWS b/NEWS
index 0efbb8027f..464505d8d1 100644
--- a/NEWS
+++ b/NEWS
@@ -77,6 +77,7 @@ See the manual for detailed information.
  . for @deftype* commands, use typewriter font in argument list
 
 * texinfo.tex
+  . `@microtype on' uses microtypography in formatting for pdfTeX and LuaTeX
   . do not ignore @part page immediately following Top node
   . for @deftype* commands, use typewriter font in argument list
   . do "@set txicodevaristt" to get slanted typewriter for @var in code,
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 3b71fcb5de..b2e687ceca 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -677,6 +677,7 @@ Global Document Commands
 * @code{@@smallbook}::                  How to print small format books and 
manuals.
 * A4 Paper::                    How to print on A4, A5 or B6 paper.
 * @code{@@pagesizes}::                  How to print with customized page 
sizes.
+* Microtypography::             Improving the appearance of paragraphs.
 * Magnification::               How to print scaled up output.
 
 Page Headings
@@ -19796,6 +19797,9 @@ Format a mathematical expression.  @xref{Inserting 
Math}.
 Mark the beginning of a menu of nodes.  No effect in a printed manual.
 Pair with @code{@@end menu}.  @xref{Menus}.
 
+@item @@microtype @var{on-off}
+Turn microtype on or off.  @xref{Microtypography}.
+
 @item @@minus@{@}
 Generate a minus sign, `@minus{}'.  @xref{@code{@@minus}}.
 
@@ -22874,6 +22878,7 @@ They are generally all given before the Top node, if 
they are given at all.
 * @code{@@smallbook}::                  How to print small format books and 
manuals.
 * A4 Paper::                    How to print on A4, A5 or B6 paper.
 * @code{@@pagesizes}::                  How to print with customized page 
sizes.
+* Microtypography::             Improving the appearance of paragraphs.
 * Magnification::               How to print scaled up output.
 @end menu
 
@@ -23538,6 +23543,25 @@ and @ref{Preparing for @TeX{}}, for other ways to 
specify
 @code{@@pagesizes} that do not require changing the source file.
 
 
+@node Microtypography
+@section Microtypography
+
+Some versions of @TeX{}, namely pdf@TeX{} and Lua@TeX{}, have
+@dfn{microtypography} features.  These involve stretching font glyphs
+slightly, and allowing text to produce very slightly into the margins.
+Use of these gives @TeX{} more flexibility in breaking a paragraph
+into lines, and can improve paragraph appearance by reducing hyphenation
+and producing a more consistent typographic color.
+
+@findex microtype
+@file{texinfo.tex} uses these features (`microtype' for short) when
+available.  You can turn microtype off by specifying @samp{@@microtype off}
+in your input file; likewise, @samp{@@microtype on} turns microtype back on.
+
+The @code{@@microtype} command does nothing for other output formats.
+
+
+
 @node Magnification
 @section Magnification
 @anchor{Cropmarks and Magnification} @c old name