1.2.2 (2012-08-16)

------------------------------------------------------------------------

(None)

1.2.2-RC1 (2012-08-01)

------------------------------------------------------------------------

- Fix: In some cases ships could be covered with land [CVE-2012-3436] [FS#5254] (r24449, r24439)

- Fix: Copy constructor and assignment operator cannot be implicit template specialisations [FS#5255] (r24448)

- Fix: Make (non-refittable) vehicles with invalid default cargo unavailable [FS#5256] (r24438)

- Fix: CFLAGS/CXXFLAGS ignored for helper binaries (r24432, r24429, r24427, r24365)

- Fix: [Windows] Unbreak NewGRF MD5 sum calculation. Macros and side effects do not mix, especially if there is some obscure '#define min' in a windows header that nobody thinks of [FS#5231] (r24416)

- Fix: Disallow removing roadtypes from bridges when not dragging in bridge direction [FS#5221] (r24414)

- Fix: Draw wires under low bridges if the bridge is transparent, not if the wire is transparent (r24403)

- Fix: Station properties 11 and 14 were combined incorrectly [FS#5243] (r24402)

- Fix: [Windows] Changing resolution did not resize the window (r24394)

- Fix: Use the 'all vehicles' group for the autoreplace window from the vehicle list [FS#5239] (r24392)

- Fix: Do not consider not finding a particular base set critical; just load a different one and display an in-game error later on [FS#5233] (r24388)

- Fix: Make IsInDepot() functions behave consistent across vehicle types and add IsChainInDepot instead, if that is what shall be checked [FS#5188] (r24384)

- Fix: Call Vehicle::IsStoppedInDepot only for the first vehicle in a chain (i.e. primary vehicle or free wagon) (r24382)

- Fix: Do not resize the object GUI when selecting objects. Rather clip the object name (r24379)

- Fix: ReInit could crash for windows with NWidgetMatrix widgets [FS#5218] (r24378)

- Fix: [NewGRF] Extended action A1 did not work correctly [FS#5227] (r24369, r24361)

- Fix: [NewGRF] Ship-specific 80+x variables were missing for unknown reason [FS#5224] (r24360)

- Fix: When airport construction was denied due to noise, the error message named the wrong town (r24354)

- Fix: [NoAI] A TileIndex is not a station id, so do not use it as one [FS#5215] (r24353)

- Fix: When highlighting the drop position for vehicles in depots, make space for all articulated parts (r24352)

- Fix: Short vehicles were not properly positioned at the cursor when dragging for RTL languages (r24351)

- Fix: EQUALSIZE widget containers within EQUALSIZE containers were initialised with wrong sizes (r24346)

- Fix: The cursor in the company password window was not blinking due to wrong magic constants (r24335)

- Fix: [NewGRF] Change the length of 8/8 roadvehicles in vehicle lists to 32 pixels; this is in fact the correct length as can be seen in corners for short articulated parts following each other [FS#2553] (r24332)

- Fix: [NewGRF] Group vehicles in the purchase list properly by source GRF, but also consider engine GRFID overrides [FS#4254] (r24330, r24321)

- Fix: Make the AI settings window behave more like the other settings window by closing the query window whenever selecting a different row (r24315)

- Fix: Editing NewGRF parameters using the query window showed wrong values, if there was no direct relation between parameter index and parameter register (r24314)

- Fix: Center object previews in 1- and 2-view selectors based on the 4-view selector layout [FS#5057] (r24299)

- Fix: Increase the left and right margins of the text in the yes/no query window (r24293)

- Fix: [NewGRF] GetReverseCargoTranslation() was unnecessary complicated and also returned the wrong thing for cargos not present in the translation table (r24273)

- Fix: [NewGRF] Load cargo- and railtype-translation during both reservation and activation stage. That way they can be selected using Action7 depending on present cargo- or railtypes (r24272)

- Fix: Use the same colour scheme for the script selection window as in other comparable windows (r24268)

- Fix: Make the oilrig-vehicle list accessible to spectators and colour its caption neutrally grey [FS#5126] (r24260)

1.2.1 (2012-06-01)

------------------------------------------------------------------------

- Fix: [Script] ScriptTown::GetGrowthRate() returned wrong values after usage of SetGrowthRate() (r24302)

1.2.1-RC1 (2012-05-16)

------------------------------------------------------------------------

- Fix: Change the unit of the sprite-cache size setting from megabytes to megapixels, so it depends on the blitter being used. Also increase it from 64 to 128, and change the name in the cfg file, so everyone gets the new default [FS#5162] (r24252)

- Fix: Do not immediately display error messages from parsing the cfg file, but schedule them for displaying after the GUI is prepared for it [FS#5154] (r24250, r24249, r24248, r24247)

- Fix: Dereferencing uninitialised pointer causing a crash [FS#5159] (r24224)

- Fix: Lag counters were not properly reset when switching states making it possible to get disconnected for lagging when you were not lagging [FS#5166] (r24221)

- Fix: Adopt ICU version detection to also deal with the new versioning scheme since ICU 49 [FS#5182] (r24220)

- Fix: Immediately do the cargo payment on vehicle crashes instead of when they are cleared [FS#5152] (r24219)

- Fix: The confirmation window to abort world generation was hidden during world generation, so actually you could not abort it [FS#5159] (r24214)

- Fix: If a company is taken over or bankrupts, transfer exclusive transport rights to the new owner respectively cancel them (r24204)

- Fix: Make the engine name not overdraw the engine count in the autoreplace GUI (r24203)

- Fix: Make the size of the details in the autoreplace GUI match more the size of the details in the purchase list (r24202)

- Fix: Mark group list dirty when setting/clearing autoreplace for an engine type [FS#5170] (r24201)

- Fix: Invalidate build vehicle windows every month, in case they need resorting due to changed reliabilities [FS#5149] (r24200)

- Fix: If you consider a settings to potentially cause desyncs via NewGRFs and thus disallow changing it in network games, you should probably also sync it to clients (r24193, r24191)

- Fix: Use default value when reading an invalid setting value [FS#5153] (r24192, r24146)

- Fix: [Windows] When going to fullscreen and back, restore to the resolution you were, not to the fullscreen resolution (r24189)

- Fix: [Windows] When changing the basics of a window (fullscreen, 8bpp/32bpp), and a window already exists, it was forced out of maximize mode, and its resolution/position was reset, often causing unwanted side-effects [FS#5151] (r24188)

- Fix: Town radii were not updated immediatelly after construction/destruction of houses, resulting in desyncs [FS#5169] (r24183)

- Fix: The population of a town was computed incorrectly for overridden houses when loading a game (r24182, r24181, r24179)

- Fix: The object name from property A was not displayed in the object GUI [FS#5110] (r24178)

- Fix: The arctic 'shops and offices' used the 'church' sprite in one of its four views [FS#5148] (r24177)

- Fix: The object GUI did not draw objects when all objects of a class are disabled (r24176)

- Fix: If you spent hard work on finding an available object ID, you should probably also use it instead of always 0 (r24159)

- Fix: Town producing no cargo at all could spawn passenger subsidies (r24158)

- Fix: The music volume was set too early during startup causing it to be not set correctly (r24155)

- Fix: [Squirrel] Crash when trying to create an array with negative size [FS#5160] (r24153)

- Fix: [NoAI] Do not return the last 'cached' speed of vehicles when they are stopped/crashed [FS#5157] (r24152)

- Fix: [Script] Typo in script documentation (r24151)

- Fix: Glass-sprite of bubble-generator was not drawn anymore for completely constructed tiles [FS#5143] (r24107)

- Fix: Conflicting strategies for resizing the main toolbar and statusbar after resizing the main window [FS#5136] (r24089)

- Fix: Significantly reduce the area that is redrawn for text effects [FS#5103] (r24068)

- Fix: Do not redraw up to 25% of the map when making a new vehicle visible for the first time (r24067)

- Fix: Do not redraw the text effect when nothing changed (r24066)

1.2.0 (2012-04-15)

------------------------------------------------------------------------

- Fix: When starting GS or AI, always use the settings of the game, not the new-game settings [FS#5142] (r24108)

- Fix: Provide translated comments in the desktop file without language name postfix (r24100)

- Fix: Cloning orders of aircraft with limited range failed [FS#5131] (r24086)

1.2.0-RC4 (2012-04-01)

------------------------------------------------------------------------

- Fix: Reversing trains while they were entering or leaving a depot could lead to stuck trains [FS#5093] (r24078, r24071)

- Fix: The 'last joined' server was not properly selected anymore [FS#5098] (r24070)

- Fix: Immediately start querying the last joined server instead of waiting for the requery loop [FS#5097] (r24069, r24062)

- Fix: Make the full snowedness level of houses the same as roads and rails [FS#5121] (r24064)

- Fix: With certain versions of GCC and compiler flags the compiler could reorder some code badly causing the 32bpp depot flag not working [FS#5125] (r24063)

- Fix: Do not freeze aircraft mid-flight when skipping to an out-of-range destination [FS#5123] (r24060)

- Fix: Wrong numbering of string parameters causing wrong capacities to be shown [FS#5124] (r24058)

- Fix: Crash when timetabling a maximum travel speed of 0 [FS#5111] (r24053)

- Fix: [NewGRF] Imported GRF sounds were inserted into the wrong slots [FS#5107] (r24052)

- Fix: [NewGRF] Realsprites inside the action 11 block were not skipped correctly (r24050)

- Fix: Improve error messages for the placement restrictions of banks, water towers and toy shops [FS#5095] (r24040)

1.2.0-RC3 (2012-03-18)

------------------------------------------------------------------------

- Feature: Allow display of baseset textfiles (r24037)

- Feature: Increase the station class limit from 32 to 256 (r24031)

- Fix: After opening a text window with the monospaced font, all other text started glitching (r24038)

- Fix: [NoAI] Reset 'is random' status of temporary variable during saveload as it is not always written to when loading an AI which means it wouldd be taking the 'is random' setting of another AI (r24033)

- Fix: [NoAI] Make AIEngine::IsArticulated return true if the articulated callback flag is set, do not try to run the callback (r24029)

- Fix: Pass cases down into the list of cargos [FS#5090] (r24024, r24023, r24022)

1.2.0-RC2 (2012-03-04)

------------------------------------------------------------------------

- Fix: [Script] AI used in names in API for GSOrder [FS#5088] (r24006)

- Fix: Improve rounding when converting display speeds to internal speeds [FS#5079] (r23995)

- Fix: Also reset the font glyph cache when switching blitters (r23992, r23987)

- Fix: [NewGRF] Also display the cargo subtype for vehicles which have no capacity, but a subtype [FS#5076] (r23991)

- Fix: Zero the offsets of disabled zoomlevels, so they do not influence offset calculations (r23989)

- Fix: Invalid reads when scaling an odd-sized sprite smaller (r23986)

- Fix: Inconsistent quit/abandon/exit game/scenario/editor strings [FS#5074] (r23985)

- Fix: Fix the order of lights on the helipad [FS#5082] (r23984)

- Fix: Tarred heightmaps would not be found [FS#5083] (r23983)

- Fix: Do not load a game during UpdateWindows as that might trigger changing the blitter which triggers re-entrant locking (r23980, r23977)

- Fix: [SDL] Palette update was done too late making switching from 8bpp -> 32bpp look ugly (r23978)

- Fix: Sprites of different zoom levels were not always padded correctly to a common size (r23976)

- Fix: Also save the maximum travel speed for the current vehicle order (r23973)

1.2.0-RC1 (2012-02-19)

------------------------------------------------------------------------

- Feature: [NewGRF] Customisable tunnel portals for rail types (r23952)

- Feature: Timetabled maximum travel speeds for non-flying vehicles (r23947)

- Feature: Readme/licence/changelog viewer for AI and game scripts [FS#5047] (r23936)

- Feature: [NewGRF] 32bpp sprites in GRFs (r23897)

- Feature: [NewGRF] Support for RealSprites with multiple zoom levels (r23890)

- Feature: [NewGRF] Support for container version 2 (r23887)

- Fix: Refittability should never depend on the current capacity of a vehicle [FS#5070] (r23965)

- Fix: Do not look for missing sprites twice during startup [FS#5072] (r23963)

- Fix: [Script] Infinite recursion within a script was not caught properly, so they could cause crashes of OpenTTD instead of the AI [FS#5068] (r23962)

- Fix: [NewGRF] Make the properties for always/never refittable cargo types not behave incremental, but reset them on reassignment (r23960)

- Fix: [Network] Do not allow chat messages from pre-active clients. As they have not got the savegame yet, they will not have the interface to send them either (r23958)

- Fix: [Network] Allow sending chat to pre-active clients as the clients start accepting once they send 'map ok' to the server, which is the same moment we change their status to pre-active [FS#4990] (r23957)

- Fix: When the population of a town changes the town view might even have to change size due to different cargo requirements [FS#5062] (r23953)

- Fix: [NoGo] Never show GSGoal::Question() to spectators [FS#5063] (r23950)

- Fix: Better rounding when converting internal speed to displayed speed (r23945)

- Fix: Also list DEITY signs in the signlist in the scenario editor [FS#5061] (r23943)

- Fix: Infrastructure cache of standard road stops would get messed up when buying a company with them (r23942)

- Fix: Scale infrastructure cost of rail tracks by the total number of all tracks and not independently for each rail type (r23931)

- Fix: [Script] Do not close the parameter window when a script starts [FS#4944] (r23930)

- Fix: Do not accelerate, for smoke purposes, when you reached the track's maximum speed [FS#5053]

- Fix: 32bpp animated blitter was optimised a bit too far regarding not needing to update the colour mapping when (re)initialising the palette [FS#5056] (r23927)

- Fix: [NoGo] Some news messages would cause an assertion to be triggered due to a missing proper location for the viewport of the news message, so only allow building when valid data for the viewport is provided or no viewport is used [FS#5054] (r23924)

- Fix: Consider only the middle tile of a lock for lock-infrastructure costs. The other two tiles may be owned by other companies. Also do not count the middle tile of a lock as canal, independent of whether it is build on ground or river slope (r23920)

- Fix: [NewGRF] When determining the first refittable cargotype according to CTT order, do not rely on the GRF assigning the refit_mask property. Also check for GRFs setting the default_cargo or refittable-cargo-classes or -types properties (r23916)

- Fix: [NewGRF] Do not test validity of cargobits using a mask of cargoslots (r23914)

- Fix: [NewGRF] When testing whether a engine shall only carry the default cargo, check ctt_include_mask for being empty before applying cargo translation (r23912)

- Fix: [SDL] Handle the SDL_VIDEOEXPOSE event to solve issues with SDL 1.3 (r23910)

- Fix: [SDL] Fix keyboard-related segfault when compiling against SDL 1.3 (r23909)

- Fix: [Makefile] Make sure bin/baseset/openttd.32.bmp is removed on make clean (r23908)

- Fix: [Makefile] Let "make clean --dry-run" not delete Makefiles (r23907)

- Fix: [Windows installer] OpenMSX got downloaded to and extracted in the wrong (non-existent) folder [FS#5045] (r23905)

- Fix: Memory leak everytime one clicked a savegame in the load GUI (r23901)

- Fix: [NewGRF] It was not possible to import sounds from a NewGRF later in the load order (r23883)

- Remove: PNG sprite loader; use 32bpp sprites in a NewGRF (r23898)

1.2.0-beta4 (2012-02-04)

------------------------------------------------------------------------

- Feature: [NewGRF] Give NewGRF defined level crossings and rail depots access to the townzone (r23866)

- Feature: [NewGRF] New algorithm (activated via an engine flag) to determine the capacity of vehicles. This allows vehicles to better control the capacity for cargotypes which they know; and let cargo NewGRFs influence the capacity for cargos the vehicle NewGRF does not know, but which the vehicle is refittable to due to cargo classes (r23861)

- Feature: [NewGRF] Add cargo property 1D to set the capacity multipliers when refitting vehicles, which do not use callback 15 (r23860)

- Feature: Allow command line options -e and -g to be combined to load saves/scenarios directly into SE (r23839)

- Feature: [NoGo] Allow querying orders of vehicles [FS#4994] (r23837)

- Change: Do not let towns (ever) remove objects [FS#5001, FS#5002] (r23842)

- Change: Make signs placed in scenario editor belong to the GS. That way they are always shown in game and are not editable [FS#4999] (r23835)

- Fix: Generate industry subsidies again [FS#5039] (r23876)

- Fix: [NoGo/NoAI] Scripts with a bad comparator could lock up OpenTTD [FS#5004] (r23870)

- Fix: Make the colour of the dropdown items for opening the vehicle list for which the company has no vehicles looking less horrid [FS#5020] (r23867)

- Fix: Railtype overlays were drawn 'only transparent' on invisible bridges (r23864)

- Fix: Inserting conditional orders for ships checked the wrong orders wrt. maximum distance (r23859)

- Fix: Out of bounds read for slowdown parameter caused desync when railtype >= 4, vehicles were fast, and the original acceleration model was used [FS#5007] (r23855)

- Fix: Infrastructure cache could get out of sync when overbuilding a drive through road stop (r23851)

- Fix: When the network is lagging, you try to copy a vehicle's order but accidentally create a station order and then copy the vehicle's order (before the first command is executed) one could trigger an assertion from the pool [FS#5008] (r23849)

- Fix: When removing road or tram from a tram+road stop, the owner of the road stop's cache was updated instead of the owner of the removed infrastructure (r23847)

- Fix: Infrastructure count for stations was not updated properly on company takeover. And do not count buoys while loading a game either (r23844)

- Fix: Clear NewGRF vehicle cache when their owner changes (r23841)

- Fix: Assertion got hit when destroing a dock when a ship was loading [FS#5000] (r23838)

- Fix: If a vehicle is not refittable to any cargo in the CTT, then pick the first refittable cargoslot (r23836)

openttd (1.2.2) unstable; urgency=low

  * New upstream release 1.2.2

 -- Matthijs Kooijman <matthijs@stdin.nl>  Thu, 16 Aug 2012 20:00:00 +0200

openttd (1.2.2~RC1) unstable; urgency=low

  * New upstream release 1.2.2-RC1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Wed, 01 Aug 2012 00:00:00 +0200

openttd (1.2.1) unstable; urgency=low

  * New upstream release 1.2.1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 01 Jun 2012 00:00:00 +0200

openttd (1.2.1~RC1) unstable; urgency=low

  * New upstream release 1.2.1-RC1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Wed, 16 Apr 2012 22:00:00 +0200

openttd (1.2.0) unstable; urgency=low

  * New upstream release 1.2.0

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 15 Apr 2012 14:00:00 +0200

openttd (1.2.0~RC4) unstable; urgency=low

  * New upstream release 1.2.0-RC4

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 01 Apr 2012 00:00:00 +0200

openttd (1.2.0~RC3) unstable; urgency=low

  * New upstream release 1.2.0-RC3

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 18 Mar 2012 18:00:00 +0100

openttd (1.2.0~RC2) unstable; urgency=low

  * New upstream release 1.2.0-RC2

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 04 Mar 2012 18:00:00 +0100

openttd (1.2.0~RC1) unstable; urgency=low

  * New upstream release 1.2.0-RC1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 19 Feb 2012 23:00:00 +0100

openttd (1.2.0~beta4) unstable; urgency=low

  * New upstream release 1.2.0-beta4

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sat, 04 Feb 2012 16:00:00 +0100

openttd (1.2.0~beta3) unstable; urgency=low

  * New upstream release 1.2.0-beta3

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sat, 21 Jan 2012 16:00:00 +0100

openttd (1.2.0~beta2) unstable; urgency=low

  * New upstream release 1.2.0-beta2

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sat, 07 Jan 2012 00:00:00 +0100

openttd (1.2.0~beta1) unstable; urgency=low

  * New upstream release 1.2.0-beta1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sat, 24 Dec 2011 00:00:00 +0100

openttd (1.1.4) unstable; urgency=low

  * New upstream release 1.1.4

 -- Matthijs Kooijman <matthijs@stdin.nl>  Mon, 05 Dec 2011 00:00:00 +0400

openttd (1.1.4-RC1) unstable; urgency=low

  * New upstream release 1.1.4-RC1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 20 Nov 2011 17:00:00 +0100

openttd (1.1.3) unstable; urgency=low

  * New upstream release 1.1.3

 -- Matthijs Kooijman <matthijs@stdin.nl>  Thu, 15 Sep 2011 21:00:00 +0200

openttd (1.1.3-RC1) unstable; urgency=low

  * New upstream release 1.1.3-RC1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 04 Sep 2011 17:00:00 +0200

openttd (1.1.2) unstable; urgency=low

  * New upstream release 1.1.2

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 14 Aug 2011 17:00:00 +0200

openttd (1.1.2~RC2) unstable; urgency=low

  * New upstream release 1.1.2-RC2

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sat, 30 Jul 2011 21:00:00 +0200

openttd (1.1.2~RC1) unstable; urgency=low

  * New upstream release 1.1.2-RC1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 24 Jul 2011 21:00:00 +0200

openttd (1.1.1) unstable; urgency=low

  * New upstream release 1.1.1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Wed, 01 Jun 2011 00:00:00 +0200

openttd (1.1.1~RC1) unstable; urgency=low

  * New upstream release 1.1.1-RC1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 15 May 2011 21:00:00 +0200

openttd (1.1.0) unstable; urgency=low

  * New upstream release 1.1.0

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 01 Apr 2011 00:00:00 +0100

openttd (1.1.0~RC3) unstable; urgency=low

  * New upstream release 1.1.0-RC3

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 18 Mar 2011 22:00:00 +0100

openttd (1.1.0~RC2) unstable; urgency=low

  * New upstream release 1.1.0-RC2

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 04 Mar 2011 22:00:00 +0100

openttd (1.1.0~RC1) unstable; urgency=low

  * New upstream release 1.1.0-RC1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 18 Feb 2011 22:00:00 +0100

openttd (1.1.0~beta5) unstable; urgency=low

  * New upstream release 1.1.0-beta5

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 04 Feb 2011 22:00:00 +0100

openttd (1.1.0~beta4) unstable; urgency=low

  * New upstream release 1.1.0-beta4

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 21 Jan 2011 00:00:00 +0100

openttd (1.1.0~beta3) unstable; urgency=low

  * New upstream release 1.1.0-beta3

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sun, 09 Jan 2011 18:00:00 +0100

openttd (1.1.0~beta2) unstable; urgency=low

  * New upstream release 1.1.0-beta2

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 31 Dec 2010 18:00:00 +0100

openttd (1.1.0~beta1) unstable; urgency=low

  * New upstream release 1.1.0-beta1

 -- Matthijs Kooijman <matthijs@stdin.nl>  Fri, 24 Dec 2010 00:00:00 +0100

openttd (1.0.5-0) unstable; urgency=low

  * New upstream release 1.0.5

 -- Matthijs Kooijman <matthijs@stdin.nl>  Sat, 20 Nov 2010 21:00:00 +0000

OpenTTD readme

------------------------------------------------------------------------

Table of contents

-----------------

1.0) About

2.0) Contacting

 * 2.1) Reporting bugs

 * 2.2) Reporting desyncs

3.0) Supported platforms

4.0) Installing and running OpenTTD

 * 4.1) (Required) 3rd party files

 * 4.2) OpenTTD directories

 * 4.3) Portable installations (portable media)

 * 4.4) Files in tar (archives)

5.0) OpenTTD features

 * 5.1) Logging of potentially dangerous actions

6.0) Configuration file

7.0) Compiling

 * 7.1) Required/optional libraries

 * 7.2) Supported compilers

8.0) Translating

 * 8.1) Translation

 * 8.2) Previewing

9.0) Troubleshooting

X.X) Credits

1.0) About

---- -----

OpenTTD is a transport simulation game based upon the popular game Transport

Tycoon Deluxe, written by Chris Sawyer. It attempts to mimic the original

game as closely as possible while extending it with new features.

OpenTTD is licensed under the GNU General Public License version 2.0. For

more information, see the file 'COPYING'.

2.0) Contacting

---- ----------

The easiest way to contact the OpenTTD team is by submitting bug reports or

posting comments in our forums. You can also chat with us on IRC (#openttd

on irc.oftc.net).

The OpenTTD homepage is http://www.openttd.org/.

You can also find the OpenTTD forums at

http://forum.openttd.org/

2.1) Reporting bugs

---- --------------

First of all, check whether the bug is not already known. Do this by looking

through the file called 'known-bugs.txt' which is distributed with OpenTTD

like this readme.

For tracking our bugs we are using a bug tracker called Flyspray. You can find

the tracker at http://bugs.openttd.org/. Before actually reporting take a look

through the already reported bugs there to see if the bug is already known.

The 'known-bugs.txt' file might be a bit outdated at the moment you are

reading it as only bugs known before the release are documented there. Also

look through the recently closed bugs.

When you are sure it is not already reported you should:

 * Make sure you are running a recent version, i.e. run the latest stable or

   nightly based on where you found the bug.

 * Make sure you are not running a non-official binary, like a patch pack.

   When you are playing with a patch pack you should report any bugs to the

   forum thread related to that patch pack.

 * Make it reproducible for the developers. In other words, create a savegame

   in which you can reproduce the issue once loaded. It is very useful to give

   us the crash.dmp, crash.sav, crash.log and crash screenshot which are

   created on crashes.

 * Check whether the bug is already reported on our bug tracker. This includes

   searching for recently closed bug reports as the bug might already be fixed.

After you have done all that you can report the bug. Please include the

following information in your bug report:

 * OpenTTD version (PLEASE test the latest SVN/nightly build)

 * Bug details, including instructions how to reproduce it

 * Platform (Windows, Linux, FreeBSD, ...) and compiler (including version) if

   you compiled OpenTTD yourself.

 * The processor architecture of your OS (32 bits Windows, 64 bits Windows,

   Linux on an ARM, Mac OS X on a PowerPC, ...)

 * Attach a saved game *and* a screenshot if possible

 * If this bug only occurred recently please note the last version without

   the bug and the first version including the bug. That way we can fix it

   quicker by looking at the changes made.

 * Attach crash.dmp, crash.log and crash.sav. These files are usually created

   next to your openttd.cfg. The crash handler will tell you the location.

2.2) Reporting desyncs

---- -----------------

As desyncs are hard to make reproducible OpenTTD has the ability to log all

actions done by clients so we can replay the whole game in an effort to make

desyncs better reproducible. You need to turn this ability on. When turned

on an automatic savegame will be made once the map has been constructed in

the 'save/autosave' directory, see OpenTTD directories to know where to find

this directory. Furthermore the log file 'commands-out.log' will be created

and all actions will be written to there.

To enable the desync debugging you need to set the debug level for 'desync'

to at least 1. You do this by starting OpenTTD with '-d desync=<level>' as

parameter or by typing 'debug_level desync=<level>' in OpenTTD's internal

console.

The desync debug levels are:

 0: nothing.

 1: dumping of commands to 'commands-out.log'.

 2: same as 1 plus checking vehicle caches and dumping that too.

 3: same as 2 plus monthly saves in autosave.

 4 and higher: same as 3

Restarting OpenTTD will overwrite 'commands-out.log'. OpenTTD will not remove

the savegames (dmp_cmds_*.sav) made by the desync debugging system, so you

have to occasionally remove them yourself!

The naming format of the desync savegames is as follows:

dmp_cmds_XXXXXXXX_YYYYYYYY.sav. The XXXXXXXX is the hexadecimal representation

of the generation seed of the game and YYYYYYYY is the hexadecimal

representation of the date of the game. This sorts the savegames by game and

then by date making it easier to find the right savegames.

When a desync has occurred with the desync debugging turned on you should file

a bug report with the following files attached:

 - commands-out.log as it contains all the commands that were done

 - the last saved savegame (search for the last line beginning with

   'save: dmp_cmds_' in commands-out.log). We use this savegame to check

   whether we can quickly reproduce the desync. Otherwise we will need...

 - the first saved savegame (search for the first line beginning with 'save'

   where the first part, up to the last underscore '_', is the same). We need

   this savegame to be able to reproduce the bug when the last savegame is not

   old enough. If you loaded a scenario or savegame you need to attach that.

 - optionally you can attach the savegames from around 50%, 75%, 85%, 90% and

   95% of the game's progression. We can use these savegames to speed up the

   reproduction of the desync, but we should be able to reproduce these

   savegames based on the first savegame and commands-out.log.

 - in case you use any NewGRFs you should attach the ones you used unless

   we can easily find them ourselves via bananas or when they are in the

   #openttdcoop pack.

Do NOT remove the dmp_cmds savegames of a desync you have reported until the

desync has been fixed; if you, by accident, send us the wrong savegames we

will not be able to reproduce the desync and thus will be unable to fix it.

3.0) Supported platforms

---- -------------------

OpenTTD has been ported to several platforms and operating systems. It should

not be very difficult to port it to a new platform. The currently working

platforms are:

  BeOS                 - SDL or Allegro

  DOS                  - Allegro

  FreeBSD              - SDL

  Linux                - SDL or Allegro

  MacOS X (universal)  - Cocoa video and sound drivers

  MorphOS              - SDL

  OpenBSD              - SDL

  OS/2                 - SDL

  Windows              - Win32 GDI (faster) or SDL or Allegro

4.0) Installing and running OpenTTD

---- ------------------------------

Installing OpenTTD is fairly straightforward. Either you have downloaded an

archive which you have to extract to a directory where you want OpenTTD to

be installed, or you have downloaded an installer, which will automatically

extract OpenTTD in the given directory.

OpenTTD looks in multiple locations to find the required data files (described

in section 4.2). Installing any 3rd party files into a 'shared' location has

the advantage that you only need to do this step once, rather than copying the

data files into all OpenTTD versions you have.

Savegames, screenshots, etc are saved relative to the config file (openttd.cfg)

currently being used. This means that if you use a config file in one of the

shared directories, savegames will reside in the save/ directory next to the

openttd.cfg file there.

If you want savegames and screenshots in the directory where the OpenTTD binary

resides, simply have your config file in that location. But if you remove this

config file, savegames will still be in this directory (see notes in

section 4.2 'OpenTTD directories')

OpenTTD comes without AIs, so if you want to play with AIs you have to download

them. The easiest way is via the 'Check Online Content' button in the main menu.

You can select some AIs that you think are compatible with your playing style.

Another way is manually downloading the AIs from the forum although then you

need to make sure that you install all the required AI libraries too; they get

automatically selected (and downloaded) if you get the AIs via the 'Check

Online Content'. If you do not have an AI but have configured OpenTTD to start

an AI a message will be shown that the 'dummy' AI has been started.

4.1) (Required) 3rd party files

---- --------------------------

/* $Id$ */

/*

 * This file is part of OpenTTD.

 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.

 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.

 */

/**

 * @file ai_changelog.hpp Lists all changes / additions to the API.

 *

 * Only new / renamed / deleted api functions will be listed here. A list of

 * bug fixes can be found in the normal changelog. Note that removed API

 * functions may still be available if you return an older API version

 * in GetAPIVersion() in info.nut.

 *

 * \b 1.3.0

 *

 * 1.3.0 is not yet released. The following changes are not set in stone yet.

 *

 * API additions:

 * \li AIEventExclusiveTransportRights

 * \li AIEventRoadReconstruction

 * \li AIIndustryType::IsProcessingIndustry

 * \li AIStation::IsAirportClosed

 * \li AIStation::OpenCloseAirport

 * \li AIController::Break

 *

 * \b 1.2.2

 *

 * No changes

 *

 * \b 1.2.1

 *

 * No changes

 *

 * \b 1.2.0

 *

 * API additions:

 *

 * \li AIAirport::GetMaintenanceCostFactor

 * \li AICargo::CT_AUTO_REFIT

 * \li AICargo::CT_NO_REFIT

 * \li AICargo::IsValidTownEffect

 * \li AICargoList_StationAccepting

 * \li AICompany::GetQuarterlyIncome

 * \li AICompany::GetQuarterlyExpenses

 * \li AICompany::GetQuarterlyCargoDelivered

 * \li AICompany::GetQuarterlyPerformanceRating

 * \li AICompany::GetQuarterlyCompanyValue

 * \li AIController::GetOpsTillSuspend

 * \li AIEngine::GetMaximumOrderDistance

 * \li AIEventAircraftDestTooFar

 * \li AIInfo::CONFIG_DEVELOPER

 * \li AIInfrastructure

 * \li AIOrder::ERR_ORDER_AIRCRAFT_NOT_ENOUGH_RANGE

 * \li AIOrder::GetOrderDistance

 * \li AIOrder::GetOrderRefit

 * \li AIOrder::IsRefitOrder

 * \li AIOrder::SetOrderRefit

 * \li AIRail::GetMaintenanceCostFactor

 * \li AIRoad::GetMaintenanceCostFactor

 * \li AITown::GetCargoGoal

 * \li AITown::GetGrowthRate

 * \li AITown::GetLastMonthReceived

 * \li AITown::GetTownAuthority

 * \li AITownEffectList (to walk over all available town effects)

 * \li AIVehicle::ERR_VEHICLE_TOO_LONG in case vehicle length limit is reached

 * \li AIVehicle::GetMaximumOrderDistance

 *

 * API renames:

 * \li AITown::GetLastMonthTransported to AITown::GetLastMonthSupplied to better

 *     reflect what it does.

 * \li AIInfo has all its configure settings renamed from AICONFIG to just CONFIG

 *     like CONFIG_RANDOM.

 * \li AIEvent has all its types renamed from AI_ET_ prefix to just ET_ prefix,

 *     like ET_SUBSIDY_OFFER.

 * \li AIOrder has all its types renamed from AIOF_ prefix to just OF_ prefix.

 *

 * API removals:

 * \li AICompany::GetCompanyValue, use AICompany::GetQuarterlyCompanyValue instead.

 *

 * Other changes:

 * \li AITown::GetLastMonthProduction no longer has prerequisites based on town

 *     effects.

 * \li AITown::GetLastMonthTransported no longer has prerequisites based on

 *     town effects.

 * \li AITown::GetLastMonthTransportedPercentage no longer has prerequisites

 *     based on town effects.

 *

 * \b 1.1.5

 *

 * No changes

 *

 * \b 1.1.4

 *

 * API additions:

 * \li AIVehicle::ERR_VEHICLE_TOO_LONG in case vehicle length limit is reached.

 *

 * \b 1.1.3

 *

 * No changes

 *

 * \b 1.1.2

 *

 * No changes

 *

 * \b 1.1.1

 *

 * No changes

 *

 * \b 1.1.0

 *

 * API additions:

 * \li IsEnd for all lists.

 * \li AIEventTownFounded

 * \li AIIndustry::GetIndustryID

 * \li AIIndustryType::INDUSTRYTYPE_TOWN

 * \li AIIndustryType::INDUSTRYTYPE_UNKNOWN

 * \li AIOrder::IsVoidOrder

 * \li AIRail::GetName

 * \li AITown::IsCity

 *

 * API removals:

 * \li HasNext for all lists.

 * \li AIAbstractList, use AIList instead.

 * \li AIList::ChangeItem, use AIList::SetValue instead.

 * \li AIRail::ERR_NONUNIFORM_STATIONS_DISABLED, that error is never returned anymore.

 *

 * Other changes:

 * \li AIEngine::GetMaxTractiveEffort can be used for road vehicles.

 * \li AIEngine::GetPower can be used for road vehicles.

 * \li AIEngine::GetWeight can be used for road vehicles.

 * \li AIIndustry::IsCargoAccepted now returns CargoAcceptState instead of a boolean.

 * \li AIOrder::GetOrderFlags returns AIOrder::AIOF_INVALID for void orders as well.

 * \li AIRoad::BuildDriveThroughRoadStation now allows overbuilding.

 * \li AIRoad::BuildRoadStation now allows overbuilding.

 *

 * \b 1.0.5

 *

 * No changes

 *

 * \b 1.0.4

 *

 * No changes

 *

 * \b 1.0.3

 *

 * API additions:

 * \li AIRail::ERR_RAILTYPE_DISALLOWS_CROSSING

 *

 * \b 1.0.2

 *

 * Other changes:

 * \li AIBridge::GetPrice now returns the price of the bridge without the cost for the rail or road.

 *

 * \b 1.0.1

 *

 * API additions:

 * \li AIRail::GetMaxSpeed

 *

 * \b 1.0.0

 *

 * API additions:

 * \li AIBaseStation

 * \li AIEngine::IsBuildable

 * \li AIEventCompanyAskMerger

 * \li AIIndustry::GetLastMonthTransportedPercentage

 * \li AIInfo::AICONFIG_INGAME

 * \li AIMarine::GetBuildCost

 * \li AIOrder::AIOF_GOTO_NEAREST_DEPOT

 * \li AIOrder::GetStopLocation

 * \li AIOrder::SetStopLocation

 * \li AIRail::RemoveRailStationTileRectangle

 * \li AIRail::RemoveRailWaypointTileRectangle

 * \li AIRail::GetBuildCost

 * \li AIRoad::GetBuildCost

 * \li AISubsidy::SubsidyParticipantType

 * \li AISubsidy::GetSourceType

 * \li AISubsidy::GetSourceIndex

 * \li AISubsidy::GetDestinationType

 * \li AISubsidy::GetDestinationIndex

 * \li AITile::GetBuildCost

 * \li AITown::GetLastMonthTransportedPercentage

 * \li AIVehicleList_Depot

 * \li AIWaypoint::WaypointType

 * \li AIWaypoint::HasWaypointType

 * \li Some error messages to AIWaypoint

 *

 * API removals:

 * \li AIOrder::ChangeOrder, use AIOrder::SetOrderFlags instead

 * \li AIRail::RemoveRailStationTileRect, use AIRail::RemoveRailStationTileRectangle instead

 * \li AIRail::RemoveRailWaypoint, use AIRail::RemoveRailWaypointTileRectangle instead

 * \li AISign::GetMaxSignID, use AISignList instead

 * \li AIStation::ERR_STATION_TOO_LARGE, use AIError::ERR_STATION_TOO_SPREAD_OUT instead

 * \li AISubsidy::SourceIsTown, use AISubsidy::GetSourceType instead

 * \li AISubsidy::GetSource, use AISubsidy::GetSourceIndex instead

 * \li AISubsidy::DestinationIsTown, use AISubsidy::GetDestinationType instead

 * \li AISubsidy::GetDestination, use AISubsidy::GetDestinationIndex instead

 * \li AITile::GetHeight, use AITile::GetMinHeight/GetMaxHeight/GetCornerHeight instead

 * \li AITown::GetMaxProduction, use AITown::GetLastMonthProduction instead

 * \li AIVehicle::SkipToVehicleOrder, use AIOrder::SkipToOrder instead

 * \li AIWaypoint::WAYPOINT_INVALID, use AIBaseStation::STATION_INVALID instead

 *

 * Other changes:

 * \li The GetName / SetName / GetLocation functions were moved from AIStation

 *     and AIWaypoint to AIBaseStation, but you can still use AIStation.GetName

 *     as before

 * \li The GetConstructionDate function was moved from AIStation to

 *     AIBaseStation, but can still be used as AIStation.GetConstructionDate

 * \li WaypointID was replaced by StationID. All WaypointIDs from previous

 *     savegames are invalid. Use STATION_INVALID instead of WAYPOINT_INVALID

 * \li AIWaypointList constructor now needs a WaypointType similiar to AIStationList,

 *     it can also handle buoys.

 * \li AIVehicleList_Station now also works for waypoints

 * \li Stations can be build over rail without signals that is in the right

 *     direction for the to-be built station. It will also convert the rail if

 *     the station's rail type supports the old type.

 * \li GetAPIVersion() was added as function to info.nut. If it does not exist

 *     API version 0.7 is assumed. This function should return the major and

/* $Id$ */

/*

 * This file is part of OpenTTD.

 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.