X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fdocs%2Fusers_guide%2Fgone_wrong.sgml;h=d4fc7f9ae8b9c563a609555a415d026723a3f9f5;hb=2dfd507259664e6f28df4a9467a8de34d01d70a0;hp=2f0321cd8fff5cae9c95e7fa1e1ab10bf852898b;hpb=dc801dc275fb8f81d482535b4d6317e234bb10f8;p=ghc-hetmet.git diff --git a/ghc/docs/users_guide/gone_wrong.sgml b/ghc/docs/users_guide/gone_wrong.sgml index 2f0321c..d4fc7f9 100644 --- a/ghc/docs/users_guide/gone_wrong.sgml +++ b/ghc/docs/users_guide/gone_wrong.sgml @@ -1,30 +1,30 @@ What to do when something goes wrong - problems + problems If you still have a problem after consulting this section, - then you may have found a bug—please - report it! See for details on how to + then you may have found a bug—please + report it! See for details on how to report a bug and a list of things we'd like to know about your bug. If in doubt, send a report—we love mail from irate users :-! - (, which describes Glasgow + (, which describes Glasgow Haskell's shortcomings vs. the Haskell language definition, may also be of interest.) When the compiler “does the wrong thing” - compiler problems - problems with the compiler + compiler problems + problems with the compiler “Help! The compiler crashed (or `panic'd)!” - These events are always bugs in + These events are always bugs in the GHC system—please report them. @@ -48,7 +48,7 @@ - Sensitivity to .hi interface files: + Sensitivity to .hi interface files: GHC is very sensitive about interface files. For example, if it picks up a non-standard @@ -107,11 +107,11 @@ When your program “does the wrong thing” - problems running your program + problems running your program (For advice about overly slow or memory-hungry Haskell - programs, please see ). + programs, please see ). @@ -134,8 +134,8 @@ For example, if an interface is lying about the type of an imported value then GHC may well generate duff code - for the importing module. This applies to pragmas - inside interfaces too! If the pragma is lying + for the importing module. This applies to pragmas + inside interfaces too! If the pragma is lying (e.g., about the “arity” of a value), then duff code may result. Furthermore, arities may change even if types do not. @@ -154,7 +154,7 @@ automatically generate the dependencies required in order to make sure that every module is up-to-date with respect to its imported interfaces. Please - see . + see . If you are down to your last-compile-before-a-bug-report, we would recommend that @@ -164,12 +164,12 @@ So, before you report a bug because of a core dump, you should probably: - + % rm *.o # scrub your object files % make my_prog # re-make your program; use -hi-diffs to highlight changes; # as mentioned above, use -dcore-lint to be more paranoid % ./my_prog ... # retry... - + Of course, if you have foreign calls in your program then all bets are off, because you can trash the heap, the @@ -181,7 +181,7 @@ “My program entered an `absent' argument.” This is definitely caused by a bug in GHC. Please - report it (see ). + report it (see ).