bug#57114: 29.0.50; texinfo-format-buffer in auth.texi leads to backtrace

bug#57114: 29.0.50; texinfo-format-buffer in auth.texi leads to backtrace

[Stefan Kangas]

Running `texinfo-format-buffer' in "doc/misc/auth.texi" leads to:

Debugger entered--Lisp error: (file-missing "Opening input file" "No
such file or directory"
"/home/skangas/wip/emacs/doc/misc/docstyle.texi")
  insert-file-contents("/home/skangas/wip/emacs/doc/misc/docstyle.texi"
nil nil nil nil)
  apply(insert-file-contents
("/home/skangas/wip/emacs/doc/misc/docstyle.texi" nil nil nil nil))
  openwith-file-handler(insert-file-contents
"/home/skangas/wip/emacs/doc/misc/docstyle.texi" nil nil nil nil)
  texinfo-format-buffer-1()
  texinfo-format-buffer(nil)
  funcall-interactively(texinfo-format-buffer nil)
  command-execute(texinfo-format-buffer)

The same seems to be true for most other manuals in doc/misc/*.texi but
I only tried a handful of them.  One idea is that any file including the
below line will have the same problem:

    @include docstyle.texi

bug#57114: 29.0.50; texinfo-format-buffer in auth.texi leads to backtrace

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Wed, 10 Aug 2022 05:24:57 -0700
> 
> Running `texinfo-format-buffer' in "doc/misc/auth.texi" leads to:
> 
> Debugger entered--Lisp error: (file-missing "Opening input file" "No
> such file or directory"
> "/home/skangas/wip/emacs/doc/misc/docstyle.texi")
>   insert-file-contents("/home/skangas/wip/emacs/doc/misc/docstyle.texi"
> nil nil nil nil)
>   apply(insert-file-contents
> ("/home/skangas/wip/emacs/doc/misc/docstyle.texi" nil nil nil nil))
>   openwith-file-handler(insert-file-contents
> "/home/skangas/wip/emacs/doc/misc/docstyle.texi" nil nil nil nil)
>   texinfo-format-buffer-1()
>   texinfo-format-buffer(nil)
>   funcall-interactively(texinfo-format-buffer nil)
>   command-execute(texinfo-format-buffer)
> 
> The same seems to be true for most other manuals in doc/misc/*.texi but
> I only tried a handful of them.  One idea is that any file including the
> below line will have the same problem:
> 
>     @include docstyle.texi

Yes, because you invoke the command incorrectly (in the wrong
directory).

This is not a bug.

bug#57114: 29.0.50; texinfo-format-buffer in auth.texi leads to backtrace

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

> Yes, because you invoke the command incorrectly (in the wrong
> directory).
>
> This is not a bug.

I don't understand what you mean by "the wrong directory", and nothing
like that is explained in the `texinfo-format-buffer' docstring.

Care to elaborate?

bug#57114: 29.0.50; texinfo-format-buffer in auth.texi leads to backtrace

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Wed, 10 Aug 2022 14:45:02 +0200
> Cc: 57114@debbugs.gnu.org
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > Yes, because you invoke the command incorrectly (in the wrong
> > directory).
> >
> > This is not a bug.
> 
> I don't understand what you mean by "the wrong directory", and nothing
> like that is explained in the `texinfo-format-buffer' docstring.
> 
> Care to elaborate?

Why, will it make you change your mind about texinfmt?

Anyway: our manuals nowadays pass the -I$(srcdir)/../emacs switch to
makeinfo, whereas invoking texinfo-format-buffer doesn't do that.  So
if you want it to process @include correctly, you should invoke the
command with default-directory set to the directory of the included
file.

bug#57114: 29.0.50; texinfo-format-buffer in auth.texi leads to backtrace

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

> Why, will it make you change your mind about texinfmt?

Should it?

> Anyway: our manuals nowadays pass the -I$(srcdir)/../emacs switch to
> makeinfo, whereas invoking texinfo-format-buffer doesn't do that.  So
> if you want it to process @include correctly, you should invoke the
> command with default-directory set to the directory of the included
> file.

Do you mean that I should do this first, before I run
`M-x texinfo-format-buffer'?

    M-: (setq default-directory (expand-file-name "../emacs/"))

bug#57114: 29.0.50; texinfo-format-buffer in auth.texi leads to backtrace

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Wed, 10 Aug 2022 07:12:19 -0700
> Cc: 57114@debbugs.gnu.org
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> > Why, will it make you change your mind about texinfmt?
> 
> Should it?

If you don't intend to allow for that, why ask?

> > Anyway: our manuals nowadays pass the -I$(srcdir)/../emacs switch to
> > makeinfo, whereas invoking texinfo-format-buffer doesn't do that.  So
> > if you want it to process @include correctly, you should invoke the
> > command with default-directory set to the directory of the included
> > file.
> 
> Do you mean that I should do this first, before I run
> `M-x texinfo-format-buffer'?
> 
>     M-: (setq default-directory (expand-file-name "../emacs/"))

Yes, but you can do it much easier, with the "M-x cd" command.

bug#57114: 29.0.50; texinfo-format-buffer in auth.texi leads to backtrace

[Lars Ingebrigtsen]

Eli Zaretskii <eliz@gnu.org> writes:

>> Do you mean that I should do this first, before I run
>> `M-x texinfo-format-buffer'?
>> 
>>     M-: (setq default-directory (expand-file-name "../emacs/"))
>
> Yes, but you can do it much easier, with the "M-x cd" command.

But this all means that the texinfmt.el don't really work (by default).
Since they've obviously not worked in quite a while, and it duplicates
functionality elsewhere (that actually works), I think we should
obsolete texinfmt.el.