branch master updated: Document that input and output file names should only be ASCII

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new ffbb22e1e7 Document that input and output file names should only be 
ASCII
ffbb22e1e7 is described below

commit ffbb22e1e7bdbdcb7cbd4bf1a738380706663748
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Sat Aug 20 21:17:05 2022 +0200

    Document that input and output file names should only be ASCII
    
    * doc/texinfo.texi (Minimum): state that input and output
    file names should only contain ASCII characters.  In a footnote
    precise that texi2any can handle non ASCII filenames, but that
    it will be problematic for output formats.
---
 ChangeLog        | 9 +++++++++
 doc/texinfo.texi | 7 ++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 1dc16e0cc1..9954ea64b8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2022-08-20  Patrice Dumas  <pertusus@free.fr>
+
+       Document that input and output file names should only be ASCII
+
+       * doc/texinfo.texi (Minimum): state that input and output
+       file names should only contain ASCII characters.  In a footnote
+       precise that texi2any can handle non ASCII filenames, but that
+       it will be problematic for output formats.
+
 2022-08-20  Gavin Smith  <gavinsmith0123@gmail.com>
 
        * doc/texinfo.tex (\need):
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index ce12392a52..b8c0e70770 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -1509,13 +1509,18 @@ By convention, the name of a Texinfo file ends with one 
of the
 extensions @file{.texi}, @file{.texinfo}, @file{.txi}, or 
 @file{.tex}.  Using @file{.tex} is discouraged as this extension
 is already used by @TeX{} and @LaTeX{} input files.  The most common
-and recommended extension is @file{.texi}.
+and recommended extension is @file{.texi}.  The name of a Texinfo
+file should only contain ASCII characters.
 
 The output name is based on the input file name, in the default case.
 First, any of the extensions @file{.texi}, @file{.tex}, @file{.txi}
 or @file{.texinfo} is removed from the input file name; then,
 the output format specific extension is added---@file{.html} when
 generating HTML, @file{.info} when generating Info, etc.
+The output name should only contain ASCII
+characters@footnote{@command{texi2any} can handle non ASCII characters
+in input file names, but non ASCII characters in output name will create
+problems for some output formats, especially for cross-references.}.
 
 In order to be made into a printed manual, a Texinfo file must begin
 with lines like this: