On Tue, Feb 24, 2026 at 06:48:10PM +0100, Vincent Lefevre wrote:
> On 2026-02-24 19:05:21 +0200, Eli Zaretskii wrote:
> > > I agree about directories from the info path, but *not* for
> > > directories outside of the info path. The latter occurs when
> > > following a cross-reference from an info file that was given
> > > on the command line, e.g. in a source tree, typically during
> > > the development and testing of software.
> > 
> > You should put the Info files in the source tree in a separate
> > directory, which is reserved only for Info files.
> 
> This is not even what texinfo does! In its doc directory:

I think that recommendation is too strict.  It's natural to have
the .texi and .info files in the same directory as well as other
build system files.

The problem with the "libtool" program being in the same directory
as an Info file referencing libtool.info is a very specific case.

If there is a program "foo" with a manual "foo.info" in the same
directory, then Info would prefer to load "foo.info".  It's only
if "foo.info" is elsewhere there is a problem.

So in the below, there would be a potential problem if somebody
wanted to reference a manual "Makefile.info", but this is very unlikely.



> 
> Makefile                         texinfo.info-4
> Makefile.am                      texinfo.tex
> Makefile.in                      texinfo.texi
> epsf.tex                         tta_api
> fdl.texi                         txi-ca.tex
> generate_html_doc_texi.pl        txi-cs.tex
> html_default_commands_args.texi  txi-de.tex
> image.pdf                        txi-en.tex
> info-fr.texi                     txi-es.tex
> info-stnd.info                   txi-fi.tex
> info-stnd.texi                   txi-fr.tex
> pod2texi.texi                    txi-hu.tex
> refcard                          txi-is.tex
> short-sample-ja.texi             txi-it.tex
> short-sample-zh.texi             txi-ja.tex
> stamp-1                          txi-nb.tex
> stamp-2                          txi-nl.tex
> stamp-vti                        txi-nn.tex
> texi2any_api.info                txi-pl.tex
> texi2any_api.texi                txi-pt.tex
> texi2oldapi.texi                 txi-pt_BR.tex
> texinfo-ja.tex                   txi-ru.tex
> texinfo-tex-test.WIDOWs          txi-sr.tex
> texinfo-tex-test.texi            txi-tr.tex
> texinfo-zh.tex                   txi-uk.tex
> texinfo.info                     txi-zh.tex
> texinfo.info-1                   version-stnd.texi
> texinfo.info-2                   version-texi2any_api.texi
> texinfo.info-3                   version.texi
> 
> -- 
> Vincent Lefèvre <[email protected]> - Web: <https://www.vinc17.net/>
> 100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
> Work: CR INRIA - computer arithmetic / Pascaline project (LIP, ENS-Lyon)

Reply via email to