1.2. Reporting bugs in GHC

Glasgow Haskell is a changing system so there are sure to be bugs in it.

To report a bug, either:

1.2.1. How do I tell if I should report my bug?

Take a look at the FAQ and Chapter 9, What to do when something goes wrong, which will give you some guidance as to whether the behaviour you're seeing is really a bug or not.

If it is a bug, then it might have been reported before: try searching on the bug tracker, and failing that, try Google.

If in doubt, just report it.

1.2.2. What to put in a bug report

The name of the bug-reporting game is: facts, facts, facts. Don't omit them because “Oh, they won't be interested…”

  1. What kind of machine are you running on, and exactly what version of the operating system are you using? (on a Unix system, uname -a or cat /etc/motd will show the desired information.) In the bug tracker, this information can be given in the “Architecture” and “Operating system” fields.

  2. What version of GCC are you using? gcc -v will tell you.

  3. Run the sequence of compiles/runs that caused the offending behaviour, cut-and-paste the whole session into the bug report. We'd prefer to see the whole thing.

  4. Add the -v flag when running GHC, so we can see exactly what was run, what versions of things you have, etc.

  5. What is the program behaviour that is wrong, in your opinion?

  6. If practical, please attach or send enough source files for us to duplicate the problem.

  7. If you are a Hero and track down the problem in the compilation-system sources, please send us patches (either darcs send, plain patches, or just whole files if you prefer).