Re: master c86995d07e9: Enable code block evaluation when generating .org manuals

[Stefan Kangas]

Ihor Radchenko <yantar92@posteo.net> writes:

>> Running the `admin/update_autogen` script results in commits like this
>> one:
>>
>>     commit 1ea3b369021c90701c634c512426f75ce1291d77
>>     Author: Eli Zaretskii <eliz@gnu.org>
>>     Date:   Sat Mar 9 04:24:30 2024 -0500
>>
>>         Auto-commit of loaddefs files.
>
> Thanks!
> I am now looking into that script, and into doc/misc/Makefile.
> I can see two approaches wrt to the Makefile:
>
> 1. Implement a separate Makefile target to generate org.org version with
>    all the necessary code blocks inside evaluated, so that there is no
>    need to redo it during make doc.
>
> 2. (simpler) Just reuse the existing .org->.texi target and run the full
>    .texi generation from admin/update_autogen script itself.
>
> The second option is less work and also ultimately shorter build times
> as there will be no need to arrange Org mode compilation, and
> .org->.texi conversion.
>
> What do you think about such approach?

I think either approach is acceptable, so whichever you prefer is fine.
There is always some drawback to checking in generated files though, so
let's see if anyone else has any comments or better ideas first.

That said, I think we should let `admin/update_autogen` be strictly
about loaddefs files.  If we decide to go in this direction, we could
add a new script `admin/update-manuals`.  If it needs to share code with
the former, the shared code could go in `admin/emacs-shell-lib`.