[no subject]

[Gavin D. Smith]

branch: master
commit d8208d86fbcb4828bbd049756b02c8e1936fdde6
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Sun Feb 11 21:14:55 2024 +0000

    * doc/texinfo.texi (Printing Japanese and Chinese): Document
    the heretofore undocumented texinfo-ja.tex and texinfo-zh.tex files.
---
 ChangeLog        |  5 +++++
 doc/texinfo.texi | 44 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index b60f47de16..5939648861 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2024-02-11  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (Printing Japanese and Chinese): Document
+       the heretofore undocumented texinfo-ja.tex and texinfo-zh.tex files.
+
 2024-02-11  Gavin Smith <gavinsmith0123@gmail.com>
 
        * doc/texinfo.texi (Print with lpr): Remove node, as some of
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 04ab2cf88f..c2a1d0bebf 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -14535,6 +14535,50 @@ before the @code{@@titlepage} command:
 @@finalout
 @end example
 
+@node Printing Japanese and Chinese
+@nodedescription XeTeX or LuaTeX required.
+@section Printing Japanese and Chinese
+
+@cindex Chinese language
+@cindex Japanese language
+Texinfo comes with support files for processing input in the
+Japanese and Chinese languages.
+
+@cindex Japanese with Xe@TeX{}
+@cindex Japanese with LuaTeX
+For Japanese, you use the @file{texinfo-ja.tex} file. Your main input
+file should begin with a @samp{\input texinfo-ja} line, rather than
+the standard
+@w{@samp{\input texinfo}}.  Use the UTF-8 character encoding as usual.
+You must process the files with either Xe@TeX{} or LuaTeX.
+
+@cindex Chinese with Xe@TeX{}
+For Chinese, you use the @file{texinfo-zh.tex} file. Your main input
+file should begin with a @samp{\input texinfo-zh} line, rather than
+the standard
+@w{@samp{\input texinfo}}.  Use the UTF-8 character encoding as usual.
+You must process the files with Xe@TeX{}.
+
+For example, you would run
+@samp{PDFTEX=xetex texi2pdf @var{my-input-file.texi}}
+to use Xe@TeX{} to produce PDF output.  You may have to install Xe@TeX{}
+(or LuaTeX), the @samp{zhspacing} package, and/or font packages.
+
+Neither Japanese nor Chinese is supported with the standard @TeX{} (or
+pdf@TeX{}) program, as it cannot support the fonts and thousands of
+glyphs needed for these languages.
+
+The Texinfo distribution comes with a couple of sample files that you
+can use to test support for these languages:
+@samp{short-sample-ja.texi} for Japanese, and @samp{short-sample-zh.texi}
+for Chinese.
+
+@cindex Xe@TeX{}
+@cindex LuaTeX
+For more information on these extensions to @TeX{}, see
+@uref{https://tug.org/xetex/, the Xe@TeX{} home page} and
+@uref{https://www.luatex.org/, the LuaTeX website}.
+
 
 @node Generic Translator @command{texi2any}
 @nodedescription @command{texi2any}, an all-purpose converter.