Re: master 5a125fb5a97 1/2: Update to Org 9.7.3

[Eli Zaretskii]

> From: Ihor Radchenko <yantar92@posteo.net>
> Cc: Kyle Meyer <kyle@kyleam.com>, stefankangas@gmail.com,
>  emacs-devel@gnu.org, monnier@iro.umontreal.ca
> Date: Wed, 12 Jun 2024 12:58:19 +0000
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> >> > After make bootstrap, I no longer see the Org manual in the info/dir
> >> > file.  git checkout 5a125fb5a9736bd^ fixes the problem.
> >> 
> >> Thanks for spotting.  I don't have time to look at it more closely
> >> tonight, but I think build-aux/make-info-dir needs to be adjusted for
> >> Org's b0c3c9057 (ox-texinfo:: Always provide a @direntry, 2024-03-08).
> >
> > Thanks, this was indeed the reason.  I hope I fixed that now.
> >
> > Please in the future take this into consideration when you decide to
> > modify the way org.org specifies the various Texinfo constructs, as
> > this affects more than just Org itself.
> 
> I was not aware that Emacs uses a custom awk script to parse .org source
> in addition to .texi source.
> 
> The existence of such script implies that .texi files generated by Org
> are not well-formatted. May you please explain why org.org file needs to
> be parsed and why parsing org.texi is not sufficient?

I don't think it has anything to do with formatting of org.texi.  The
issue here is that info/DIR file might be generated when org.texi is
not yet available or not yet up-to-date, such as during bootstrap or
after some change in org.org.  IOW, the reason for this behavior is
that we want to produce info/DIR from the source files, not from the
generated files.