texinfo: makeinfo Preferred

Catching Mistakes

Debugging with Info

Back to Software Index

E.1 'makeinfo' Preferred
========================

The 'makeinfo' program does an excellent job of catching errors and
reporting them--far better than 'texinfo-format-region' or
'texinfo-format-buffer'.  In addition, the various functions for
automatically creating and updating node pointers and menus remove many
opportunities for human error.

  If you can, use the updating commands to create and insert pointers
and menus.  These prevent many errors.  Then use 'makeinfo' (or its
Texinfo mode manifestations, 'makeinfo-region' and 'makeinfo-buffer') to
format your file and check for other errors.  This is the best way to
work with Texinfo.  But if you cannot use 'makeinfo', or your problem is
very puzzling, then you may want to use the tools described in this
appendix.