doc/BUGS

   1 ====
   2 BUGS
   3 ====
   4
   5 Freeciv 2.6 certainly contains some bugs. Please report all
   6 you find to http://gna.org/bugs/?func=additem&group=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         http://gna.org/bugs/?group=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 (gtk2, gtk3, gtk3.22, SDL,
  44      SDL2, Xaw, 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 SDL client, the version numbers (if you
  63          know them) of the SDL, SDL_image, SDL_gfx, and SDL_ttf libraries.
  64
  65        - If you are using the SDL2 client, the version numbers (if you
  66          know them) of the SDL2, SDL2_image, SDL2_gfx, and SDL2_ttf
  67          libraries.
  68
  69        - If you are using the Xaw client, the version numbers (if you
  70          know them) of the X libraries, the PNG library, the Z library,
  71          and the Xaw library, and particularly whether it is standard
  72          Xaw, or a variant such as Xaw3d, Xaw95, or Nextaw.
  73
  74        - If you're compiling from source code, the name
  75          and version number of the compiler.
  76
  77        - If you're installing from a binary package, the name of
  78          the package, the distribution it's for, and where you
  79          got it from.
  80
  81    - If Freeciv "dumps core", then we may ask you to use a debugger to
  82      give us a "stack trace".  You'll need the "core" file for this as
  83      well as the binary which you used, so please backup both.
  84
  85    - If it is a bug in a translation, it should be reported to the
  86      Primary Contact for the language.  For their names and addresses,
  87      see:
  88
  89         http://www.freeciv.org/wiki/Localization
  90
  91
  92 FURTHER INFORMATION:
  93 ====================
  94
  95 For more information, as always, see the Freeciv website:
  96
  97         http://www.freeciv.org/