====
BUGS
====

This is a beta release and may contain bugs.  Much of the following text
applies to the upcoming stable release!  Please report all bugs to
bugs@freeciv.org or http://bugs.freeciv.org/.

====

Freeciv 2.1.0 is a "stable" release and is considered bug-free enough
for everyday use.  However if you do find a bug, we would really like to
know, so that we can fix it.  This file lists known bugs in this release,
and gives information about reporting new bugs.

This lists only the most obvious bugs.  For a complete list, see:

    http://bugs.freeciv.org/

KNOWN BUGS:
===========

 - Your CMA settings are only sent to the server when you press
   turn done, and therefore changes you make to CMA in the same
   turn as you save a game will be lost.

 - The hard AI is not hard enough for very experienced players, and
   still does lots of stupid things.

 - Some effects of wonders and research first take effect the turn
   after. Fx when building the lighthouse some triremes will only get
   the movement bonus the next turn.

 - The Xaw client can only display 25 citizens in the city dialog.

 - In the GTK+ client, sometimes the area near the minimap contains
   garbage.

 - Automate routines like auto explore don't handle triremes very well.

 - LOG_DEBUG doesn't work with non-GCC compilers.

 - When setting server variables, the server in many cases doesn't
   check the values as well as it could.

 - Bad things happen when you manipulate multiple global worklists
   simultaneously.

 - The Xaw client does not work well with the KDE window manager.
   Try using the GTK+ client or another window manager.

 - With sufficiently unusual map parameters it is possible for map generation
   to fail when the game is started.  The server will exit when this
   happens.  Try using the same parameters again or switching to more
   "regular" parameters.

 - In some situations non-ascii text output on the server command line will
   be drawn wrong in graphical terminal programs.  The problem here is that
   the terminal program probably has a separate means of configuring the
   character encoding that does not match the $LANG variable.  This is a bug
   in the configuration (or possibly in the terminal program) and can be
   fixed by editing the terminal configuration.  In gnome-terminal, for
   instance, you can set the encoding through the menus - simply set it to
   match the value in your $LANG.

REPORTING A BUG:
================

(If it is a bug in a translation, it should be mailed to the Primary
Contact for the language.  See <http://www.freeciv.org/index.php/Localization>
for the names and addresses of these people.)

Here's what to do:

 - Check that it is not one of the known bugs listed above!  :-)

 - Check the Freeciv website, to ensure you're playing the latest
   version.  (We may have already fixed the problem.)

   In particular, you might like to try a development snapshot,
   from our CVS repository.  You can FTP them from:

        http://www.freeciv.org/latest.html

 - Check the Freeciv FAQ on the Freeciv website to see if we've
   published a way to work around your bug.

 - Check the Freeciv Bug Tracking System at:

        http://bugs.freeciv.org/

   to see if the bug has already been reported.

 - Submit a bug report!

   You can submit a bug report either by sending email to
   <bugs@freeciv.org>, or via the web at
   <http://bugs.freeciv.org/>.

   Or, if you want to send the Freeciv developers some comments
   but don't want to lodge a bug report, you can sent email to
   <freeciv-dev@freeciv.org>, the Freeciv developer's mailing list.

   If you get any GDK/GTK messages (they look like this:

     Gtk-CRITICAL **: file gtkobject.c: line 1163 (gtk_object_ref): 
     assertion oject->ref_count > 0' failed.

   ) please restart your client and append "-- --g-fatal-warnings" to
   the command line. Unfortunately this only works with a current CVS
   or with version 2.0.0 or better. You will get a core dump this
   way. Please include in your bug report the "stack trace" of this
   core dump.

   What to include in your bug report:

   - Describe the problem, including any messages that were displayed.

   - Indicate which client(s) you are using (GTK+ or Xaw).

   - Tell us the name and version of:

       - The Operating System you're using.  You may find the
         "uname -a" command useful.

       - The version number of Freeciv.

       - If you are using the GTK+ client, the version numbers
         (if you know them) of your GTK+, GLib, and imlib libraries.

       - If you are using the Xaw client, the version numbers (if you
         know them) of the X libraries, the PNG library, the Z library,
         and the Xaw library, and particularly whether it is standard
         Xaw, or a variant such as Xaw3d, Xaw95, or Nextaw.

       - If you're compiling from source code, the name
         and version number of the compiler.

       - If you're installing from a binary package, the name of
         the package, the distribution it's for, and where you
         got it from.

   - If Freeciv "dumps core", then we may ask you to use a debugger to
   give us a "stack trace".  You'll need the "core" file for this as
   well as the binary which you used, so please backup both.

FURTHER INFORMATION:
====================

For more information, as always, see the Freeciv website:

        http://www.freeciv.org/
