On Wed, Jun 10, 2026 at 11:18:21PM +0100, Jeremy Bryant wrote:
> > ~/src/ffmpeg/doc(master)$ texi2any -c
> > TREE_TRANSFORMATIONS=insert_nodes_for_sectioning_commands
> > ffmpeg-filters.texi
>
> Thanks Patrice, this is extremely useful, and indeed generates an Info manual
> readable from Emacs.
>
> It also works on ffmpeg.texi, although other .texi files are missing a
> Top node when using the technique above.
In general that is because some .texi files are included from other
files and are not supposed to be converted by themselves. For example,
authors.texi is such a file that is meant to be included, and it is
included in many Texinfo files.
The manuals selected for conversion are based on the doc/Makefile
targets such as HTMLPAGES, the target file determines the .texi input
file through rules like:
doc/%.html: doc/%.texi $(SRC_PATH)/doc/t2h.pm $(GENTEXI)
$(Q)$(TEXIDEP)
$(M)$(MAKEINFO) --html -I doc --no-split -D config-not-all
--init-file=$(SRC_PATH)/doc/t2h.pm --output $@ $<
The HTMLPAGES are based on transformation on list of names, triggerd by
variables substitutions rules like $(AVPROGS-yes:%=doc/%.html) and by
additional lists of files like "doc/community.html".
In turn, $(AVPROGS-yes) variable is determined, in general based on
rules like (in that case in fftools/Makefile):
AVPROGS-$(CONFIG_FFMPEG) += ffmpeg
with CONFIG_FFMPEG taken from ffbuild/config.mak, this file being
automatically generated by configure.
--
Pat
_______________________________________________
ffmpeg-devel mailing list -- [email protected]
To unsubscribe send an email to [email protected]
