doc/BUGS

   1 ====
   2 BUGS
   3 ====
   4
   5 Freeciv 3.1 certainly contains some bugs. Please report all
   6 you find to https://www.hostedredmine.com/projects/freeciv.
   7
   8
   9 REPORTING A BUG:
  10 ================
  11
  12 Here's what to do:
  13
  14  - Check that it is not listed as a known bug! For a continuously
  15    updated list, see:
  16
  17         http://www.freeciv.org/wiki/Known_Bugs
  18
  19  - Check the Freeciv website, to ensure you're playing the latest
  20    version.  (We may have already fixed the problem.)
  21
  22  - Check the Freeciv Bug Tracking System at:
  23
  24         https://www.hostedredmine.com/projects/freeciv
  25
  26    to see if the bug has already been reported.
  27
  28  - Submit a bug report through our bug tracking system above!
  29
  30    If you get any GDK/GTK messages, as for example:
  31
  32      Gtk-CRITICAL **: file gtkobject.c: line 1163 (gtk_object_ref):
  33      assertion object->ref_count > 0' failed.
  34
  35    please restart your client and append "-- --g-fatal-warnings" to
  36    the command line. You will get a core dump this way. Please include
  37    the "stack trace" of this core dump in your bug report.
  38
  39    What to include in your bug report:
  40
  41    - Describe the problem, including any messages that were displayed.
  42
  43    - Indicate which client(s) you are using (gtk3, gtk3.22, gtk3x,
  44      SDL2, or Qt).
  45
  46    - Tell us the name and version of:
  47
  48        - The Operating System you're using.  You may find the
  49          "uname -a" command useful.
  50
  51        - The version number of Freeciv.
  52
  53        - If you are using the GTK+ client, the version numbers
  54          (if you know them) of your GTK+ and GLib libraries.
  55          Gtk-clients show those version numbers on 'About Freeciv'
  56          dialog found from under 'Help' menu.
  57
  58        - If you are using Qt client, the version number of Qt libraries.
  59          In Qt-client that can be find by opening 'About Freeciv' dialog
  60          from under 'Help' menu and clicking 'About Qt' button there.
  61
  62        - If you are using the SDL2 client, the version numbers (if you
  63          know them) of the SDL2, SDL2_image, SDL2_gfx, and SDL2_ttf
  64          libraries.
  65
  66        - If you're compiling from source code, the name
  67          and version number of the compiler.
  68
  69        - If you're installing from a binary package, the name of
  70          the package, the distribution it's for, and where you
  71          got it from.
  72
  73    - If Freeciv "dumps core", then we may ask you to use a debugger to
  74      give us a "stack trace".  You'll need the "core" file for this as
  75      well as the binary which you used, so please backup both.
  76
  77    - If it is a bug in a translation, it should be reported to the
  78      Primary Contact for the language.  For their names and addresses,
  79      see:
  80
  81         http://www.freeciv.org/wiki/Localization
  82
  83
  84 FURTHER INFORMATION:
  85 ====================
  86
  87 For more information, as always, see the Freeciv website:
  88
  89         http://www.freeciv.org/