<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.7, 23 September 2019),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019 Free Software
Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>makeinfo Preferred (GNU Texinfo 6.7)</title>
<meta name="description" content="makeinfo Preferred (GNU Texinfo 6.7)">
<meta name="keywords" content="makeinfo Preferred (GNU Texinfo 6.7)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<link href="index.html" rel="start" title="Top">
<link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Catching-Mistakes.html" rel="up" title="Catching Mistakes">
<link href="Debugging-with-Info.html" rel="next" title="Debugging with Info">
<link href="Catching-Mistakes.html" rel="prev" title="Catching Mistakes">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="makeinfo-Preferred"></span><div class="header">
<p>
Next: <a href="Debugging-with-Info.html" accesskey="n" rel="next">Debugging with Info</a>, Up: <a href="Catching-Mistakes.html" accesskey="u" rel="up">Catching Mistakes</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="makeinfo-Preferred-1"></span><h3 class="section">F.1 <code>makeinfo</code> Preferred</h3>
<p>The <code>makeinfo</code> program does an excellent job of catching errors
and reporting them—far better than <code>texinfo-format-region</code> or
<code>texinfo-format-buffer</code>. In addition, the various functions for
automatically creating and updating node pointers and menus remove
many opportunities for human error.
</p>
<p>If you can, use the updating commands to create and insert pointers
and menus. These prevent many errors. Then use <code>makeinfo</code> (or
its Texinfo mode manifestations, <code>makeinfo-region</code> and
<code>makeinfo-buffer</code>) to format your file and check for other
errors. This is the best way to work with Texinfo. But if you
cannot use <code>makeinfo</code>, or your problem is very puzzling, then you
may want to use the tools described in this appendix.
</p>
</body>
</html>