Re: Building & integrating custom texinfo manuals for live Emacs docstring links

Sent with Proton Mail secure email.

On Friday, April 17th, 2026 at 7:18 PM, Eli Zaretskii <[email protected]> wrote:

> > Date: Thu, 16 Apr 2026 21:57:24 +0000
> > From: Heime <[email protected]>
> >
> >
> > How can I make the texinfo file antares.info from its source (antares.t=
exi).
> > and refresh Emacs to enables immediate docstring cross-references like =
as
> > clickable node?
> >
> > I have made the following bash file.  Would I use this or make some eli=
sp
> > commands instead?
> >
> > #!/bin/bash
> >
> > ## antares-build.sh
> > ## Compile & install antares.texi - Info manual for Emacs docstrings
> >
> > set -e  # Exit on error
> >
> > hist_dir=3D"${HOME}/Opstk/src/hist/hist-1.0/"
> > lana_dir=3D"${hist_dir}/lana"
> > antares_dir=3D"${lana_dir}/galaxiakos/antares"
> >
> > texi_file=3D"${antares_dir}/antares.texi"
> >
> > info_dir=3D"${HOME}/.emacs.d/info"
> > info_file=3D"${info_dir}/antares.info"
> > dirfile=3D"${info_file}/dir"
> >
> > echo "Antares Info manual"
> >
> > ## Ensure directories exist
> > mkdir -p "$info_dir"
> > cd "$antares_dir"
> >
> > ## Compile Texinfo to a single Info file
> > makeinfo --force -o "$info_file" "$texi_file"
>=20
> There are no Lisp commands to compile Texinfo into Info.  You must
> invoke the shell commands from Emacs to do that.  I suggest to look
> into lisp/textmodes/makeinfo.el, maybe something there will help you.
> But the basic is that you just need to invoke shell-command to run the
> last command in your Makefile.

To generate the documentation, would one usually employ `makeinfo'?=20
Have seen people using `texi2html' and `texi2pdf' - would I need those?