Viewing File: /usr/share/doc/texinfo/html/Reporting-Bugs.html

<!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>Reporting Bugs (GNU Texinfo 6.7)</title>

<meta name="description" content="Reporting Bugs (GNU Texinfo 6.7)">
<meta name="keywords" content="Reporting Bugs (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="Overview.html" rel="up" title="Overview">
<link href="Output-Formats.html" rel="next" title="Output Formats">
<link href="Overview.html" rel="prev" title="Overview">
<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="Reporting-Bugs"></span><div class="header">
<p>
Next: <a href="Output-Formats.html" accesskey="n" rel="next">Output Formats</a>, Up: <a href="Overview.html" accesskey="u" rel="up">Overview</a> &nbsp; [<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="Reporting-Bugs-1"></span><h3 class="section">1.1 Reporting Bugs</h3>

<span id="index-Bugs_002c-reporting"></span>
<span id="index-Suggestions-for-Texinfo_002c-making"></span>
<span id="index-Reporting-bugs"></span>
<p>We welcome bug reports and suggestions for any aspect of the Texinfo
system: programs, documentation, installation, etc.  Please email them
to <a href="mailto:bug-texinfo@gnu.org">bug-texinfo@gnu.org</a>.  You can get the latest version of
Texinfo via its home page, <a href="http://www.gnu.org/software/texinfo">http://www.gnu.org/software/texinfo</a>.
</p>
<span id="index-Checklist-for-bug-reports"></span>
<p>For bug reports, please include enough information for the maintainers
to reproduce the problem.  Generally speaking, that means:
</p>
<ul>
<li> The version number of Texinfo and the program(s) or manual(s) involved.
</li><li> The contents of any input files necessary to reproduce the bug.
</li><li> Precisely how you ran any program(s) involved.
</li><li> A description of the problem and samples of any erroneous output.
</li><li> Hardware and operating system names and versions.
</li><li> Anything else that you think would be helpful.
</li></ul>

<p>When in doubt whether something is needed or not, include it.  It&rsquo;s
better to include too much than to leave out something important.
</p>
<p>It is critical to send an actual input file that reproduces the
problem.  What&rsquo;s not critical is to &ldquo;narrow down&rdquo; the example to the
smallest possible input&mdash;the actual input with which you discovered
the bug will suffice.  (Of course, if you do do experiments, the
smaller the input file, the better.)
</p>
<span id="index-Patches_002c-contributing"></span>
<p>Patches are most welcome; if possible, please make them with
&lsquo;<samp>diff&nbsp;<span class="nolinebreak">-c</span><!-- /@w --></samp>&rsquo; (see <cite><a href="../diffutils/index.html#Top">Comparing and Merging
Files</a></cite>) and include <samp>ChangeLog</samp> entries (see <a href="../emacs/Change-Log.html#Change-Log">Change Log</a> in <cite>The GNU Emacs Manual</cite>), and follow the existing coding style.
</p>




</body>
</html>
Back to Directory File Manager