GNU Info

(heroes.info)Bug Reporting

---

Next: People Prev: Mailing lists Up: Overview

---

Enter node , (file) or (file)node

Reporting bugs, sending suggestions or contribution
===================================================

   We welcome bug reports or suggestions for Heroes (either program,
documentation, or data files).  This program will get better only if you
report the problems you encounter.  Please email them to
<heroes-bugs@lists.sourceforge.net> or
<heroes-discuss@lists.sourceforge.net>.  For bug reports, please
include enough information to reproduce the problem, if possible.
Useful information include:

   * the version number of Heroes.

   * hardware, operating system (and OS distribution), and compiler
     versions.

   * any unusual options you gave to `configure'.

   * the actions necessary to reproduce the bug.

   * a description of the problem (sometimes, a snapshot may be a good
     description) and of the behavior you are expecting (this is not
     always obvious for everyone)

   * a trace of the game, as given by running Heroes with the
     `HEROES_DEBUG' environment variable set (to `all', for instance).

   * a stack trace of the crash, if you compiled the game with debugging
     options (see below).

   * anything else that you think would be helpful.


   When in doubt whether something is needed or not, include it.  It's
better to include too much than to leave out something important.

   To get useful core dumps, `./configure' with `--enable-debug' and
`--disable-sound'.

   Patches are most welcome; if possible, please make them with `diff
-u' (Note: Unified Format.) or `diff -c'
(Note: Context Format.) and include
`ChangeLog' entries (Note: Change Log.).

   When sending email, please do not encode or split the messages in any
way if possible; it's much easier to deal with one plain text message,
however large, than many small ones.

   Do not hesitate to contribute.  This is YOUR game and the GPL allows
you to apply any modifications you want to the game (provided that you
keep those modifications under the GPL).  There are numerous places
where you can contribute: you can hack the code (the TODO file can give
you ideas but should not be seen as a limit), design new levels, create
new drawings (e.g. new sets of tiles), track some new music or add your
personal touch here and there.