(svn r26137) -Merge: documentation updates from 1.3 branch

6 files changed, 221 insertions, 5 deletions

diff --git a/changelog.txt b/changelog.txt
index 510c916b1..afe483563 100644
--- a/changelog.txt
+++ b/changelog.txt
@@ -1,3 +1,145 @@
+1.3.3 (2013-11-29)
+------------------------------------------------------------------------
+- Fix: Aircraft crashing near the map's border due to a lack of airports could trigger a crash [CVE-2013-6411] [FS#5820] (r26134)
+
+
+1.3.3-RC2 (2013-11-24)
+------------------------------------------------------------------------
+- Fix: [Script] Prevent scripts from crashing OpenTTD when they send text with command codes to user editable texts such as sign and station names [FS#5818] (r26093, r26092)
+- Fix: Occasional hanging when client joins [FS#5811] (r26043)
+- Fix: Multi line text was handled incorrectly causing glitches [FS#5809] (r26037, r26036)
+
+
+1.3.3-RC1 (2013-11-17)
+------------------------------------------------------------------------
+- Fix: Crash when the ICU layouter thinks a font is corrupted [FS#5711] (r26029, r26018, r26017, r26016, r26015)
+- Fix: Make the installer warning about Windows XP SP3 not trigger on the 64 bit Windows XP which is not really Windows XP to start with [FS#5773] (r26028)
+- Fix: Only forward key presses to the IME system if an edit box has the input focus (r26023, r25693, r25691, r25689, r25686, r25684, r25682, r25681, r25667)
+- Fix: Having trains miss a platform that is just being modified is less of a problem than having trains stop twice without moving [FS#5684] (r26013)
+- Fix: --help text of ./configure for packages that require pkg-config (r26011)
+- Fix: The AI/GS library name to use in Import, is not the name given by GetName but GetInstanceName [FS#5662] (r26010)
+- Fix: [Windows] Conditional expression with enumeral with non-enumeral type (r26009)
+- Fix: Game script showing vehicle on e.g. a goal, then the vehicle being removed and eventually being replaced by a non-user vehicle (most likely smoke) causing an assertion to trigger [FS#5804] (r26007, r26006)
+- Fix: Crash when transferring savegame from server to client [FS#5478] (r26005)
+- Fix: [OSX] Text input into an edit box would trigger hotkeys [FS#5705] (r26003, r25743, r25671)
+- Fix: Comma key collided with F12 key for hotkeys; also remove '+' as that is generally not a key (the '+' on the numpad is a separate one) [FS#5679] (r25973)
+- Fix: Rail laying sounds of others could be heard in multiplayer [FS#5665] (r25972)
+- Fix: [SDL] Recursive mutex locking when changing blitter [FS#5787] (r25970)
+- Fix: The wrong vehicle would be taken in a shared order vehicle list window when the ID >= 65536, causing assertions triggering later on [FS#5800] (r25965)
+- Fix: [OSX] Compilation under OSX 10.9 [FS#5797] (r25962, r25951, r25950, r25913)
+- Fix: [NewGRF] A powered rail type implies it is compatible as well, but some NewGRF did not state that causing the path reservation code to bail out in some cases because there was no compatible path [FS#5779] (r25961)
+- Fix: Temporary persistent storage modifications, e.g. command tests or those from GUI, were not properly reset, creating the possibility of desyncs [FS#5772] (r25956)
+- Fix: Train's 'force proceed' status gets reset when the track on the other side of the tile has a signal [FS#5723] (r25955)
+- Fix: Wrong signal conversions for savegames from before 0.4.5 [FS#5731, FS#5732] (r25954, r25953)
+- Fix: Do not skip numbers when skipping spaces and other sorting 'improving' characters [FS#5719] (r25952)
+- Fix: Text direction forcing characters were not filtered out, but shown as ? when ICU was not used for layouting. These are included in chat and console messages to force them to be displayed right [FS#5683] (r25949)
+- Fix: NewGRF inspect window in RTL mode (r25943)
+- Fix: [NoGo] Preserve the relative town growth progress when changing the town growth rate [FS#5786] (r25931)
+- Fix: Several drawing overflows in the signal GUI [FS#5733] (r25929, r25928, r25927)
+- Fix: Center the edit sign window like all query windows (r25918)
+- Fix: Initialization of default objects swapped cost and dates (r25868)
+- Fix: Use the actual sprite dimensions for sizing the dropdown arrow of dropdown widgets (r25864)
+- Fix: If the child widgets of a NWidgetHorizontal container do not fill the complete container, align them according to text direction [FS#5686] (r25862, r25729)
+- Fix: When clearing font cache, also clear layout cache [FS#5737] (r25860)
+- Fix: Goto button in order window was not always lowered when it should [FS#5783] (r25858, 25857)
+- Fix: Searching for a suitable font failed, if one of the fonts had no '?' glyph, and no baseset is installed [FS#5704] (r25822, r25820)
+- Fix: Sprite 0 was considered available, even if no baseset was loaded (r25821)
+- Fix: [GS] Language file scanner considered filenames starting with '.' as valid translations, resulting in languages with empty name, which causes trouble [FS#5750] (r25818)
+- Fix: [GS] Handle savegames which contain GS translations for languages with empty name more gently [FS#5750] (r25817)
+- Fix: [Script] ScriptTile::IsBuildableRectangle could report true for tiles outside of the map, if they happened to wrap around into a valid area [FS#5754] (r25815)
+- Fix: [Script] Decoding JSON data with an empty array from Admin port failed (r25809)
+- Fix: Ensure the vehicle bar is high enough for the start/stop vehicle graphics [FS#5740] (r25805)
+- Fix: Lower sprite and text at the vehicle bar if it is pressed [FS#5739] (r25804)
+- Fix: Draw start/stop graphics of the vehicle bar at the right place in RTL mode [FS#5738] (r25803)
+- Fix: [NewGRF] Do not allow changing palette when it is set by the NewGRF (r25794, r25793, r25972)
+- Fix: Some spelling corrections to Catalan and Latin American town names [FS#5746] (r25775, r25774)
+- Fix: If old savegames contain bridges over owned land, keep on drawing the bridges nevertheless [FS#5725] (r25753)
+- Fix: Several RTL alignment issues [FS#5692] (r25733, r25732, r25731)
+- Fix: NWidgetMatrix used pip_pre and pip_post inconsistently and incorrectly, causing misalignment for RTL [FS#5686] (r25727)
+- Fix: Right side of object class string was misaligned (r25726)
+- Fix: [OSX] Do not pass -mmacosx-version-min to compilers that do not support it (r25706)
+- Fix: Autoreplace/renew also refits free wagons [FS#5700] (r25698)
+- Fix: Textbuf caret rendering for complex scripts (e.g. Tamil) (r25696, r25694, r25652, r25651, r25092, r25091)
+- Fix: Vehicle::MarkDirty must be called for the front engine [FS#5700] (r25695)
+- Fix: [Win32] Several issues regarding conversion of characters (r25677, r25676, r25675, r25674, r25673)
+- Fix: [Win32] Handle Unicode characters from outside the BMP correctly (r25672, r25670, r25669, r25668)
+- Fix: [OSX] Crash when unhiding the main window [FS#4689] (r25665)
+- Fix: [OSX] Bootstrap downloading of a baseset did not work [FS#4847] (r25664)
+- Fix: [OSX] Monospace font detection [FS#4857] (r25663, r25662)
+- Fix: [OSX] Rework font detection to work even if no default font sprites are present [FS#4847] (r25661)
+- Fix: [OSX] The name is OpenTTD, not OTTD (r25660)
+- Fix: [OSX] System mouse cursor could become visible during dragging [FS#4420] (r25659)
+- Fix: [OSX] The mouse cursor would sometimes jump near the window borders [FS#4392] (r25658)
+- Fix: [OSX] The new 10.7 fullscreen code can now also be compiled with older SDK versions [FS#4744] (r25656)
+- Fix: [OSX] Mouse cursor was not displayed properly after switching to fullscreen on 10.7+ (r25655)
+- Fix: Improve character and word deletion for CJK languages and complex scripts (r25654, r25653)
+- Fix: [OSX] Define version constants before they are used (r25643)
+- Fix: Some icu_config scripts are too stupid to separate two ldflags by spaces, thus only call it with one (r25642, r25638)
+- Fix: Do not suggest a start date for the game when there will be no vehicles available at all (r25640, r25639)
+- Fix: City list sort of population and rating are reversed compared to the icon [FS#5666] (r25630)
+- Fix: [Script] Give a slightly less generic error when removing inexisting rail [FS#5651] (r25614)
+- Fix: [Script] Do not return ERR_UNKNOWN when trying to move an order to its current location [FS#5648] (r25612)
+- Fix: Various misreferences in AI and GS changelog [FS#5649] (r25607)
+- Fix: [Script] If a NewGRF returned station type that could not be built by an AI via callback 18, an unknown error would be thrown instead of falling back to the default station [FS#5641] (r25605)
+- Fix: Only the front engine's date of last service was updated [FS#5550] (r25604)
+
+
+1.3.2 (2013-07-27)
+------------------------------------------------------------------------
+(None)
+
+
+1.3.2-RC2 (2013-07-13)
+------------------------------------------------------------------------
+- Fix: [Admin] End-of-rcon data could not be determined reliably for any rcon command [FS#5643] (r25598, r25588, r25587)
+- Fix: [Content] When the server closed the connection, the client would for eternity try to read a packet and never timeout making it impossible to reconnect [FS#5635] (r25597)
+- Fix: [Script] Changing the script difficulty level in-game would also change the settings using the default even though they were not allowed to change in-game [FS#5644] (r25592)
+- Fix: [Admin] Ensure that sent and received length of json strings are the same [FS#5646] (r25590, r25589)
+- Fix: [Squirrel] Stack overflow did not show an error, due to the stack to throw the error already being full [FS#5320] (r25585)
+- Fix: [Script] Documentation implied that XXList::AddItem has a default for value if it isn't filled in [FS#5638] (r25579, r25577)
+- Fix: Layouter caused significant slowdown with text heavy windows, cache it to make it manageable (r25574, r25570, r25569, r25567, r25564)
+- Fix: Make content list appear faster (r25573)
+- Fix: Non-ICU layouter started new lines with the space which triggered the linebreak (r25568)
+- Fix: If the next order cannot be resolved, reset the current order property instead of leaving it in an intermediate state [FS#5633] (r25562)
+- Fix: [Squirrel] Infinite recursion loop in freeing data via a looping set of references [FS#5568] (r25558)
+- Fix: One could build bridges over owned land of another company [FS#5524] (r25557)
+- Fix: [Script] Texts from scripts were not validated before they were shown, causing an assertion to trigger [FS#5632] (r25555)
+- Fix: Provide a warning when no vehicles are available, and tell what to do in that case [FS#5530] (r25553)
+- Fix: Possible reading of uninitialised memory due to undefined execution order (r25551)
+- Fix: [Windows] Race condition between two drawing threads could crash OpenTTD [FS#5571] (r25550)
+- Fix: ICU returns the width of the visual run as if the trailing space was added (in case a newline was added). This caused the width to be more than the requested width, but it would still be drawn correctly [FS#5626] (r25547)
+- Fix: Small memory leaks (r25546)
+- Fix: [GS] The checks and validations for setting the extra text in the town window became too stringent [FS#5625] (r25544)
+
+
+1.3.2-RC1 (2013-06-30)
+------------------------------------------------------------------------
+- Remove: SETX(Y) does not work at all with other than default fonts, so get rid of it (r25454)
+- Fix: strndup should not examine strings beyond its upper limit [FS#5621] (r25527)
+- Fix: Proper support for Brahmic scripts (e.g. Tamil and Thai) [FS#5481] (r25526, r25525, r25524, r25514, r25513, r25512, r25511, r25501, r25493, r25485, r25483, r25482, r25481, r25478, r25477, r25476, r25474, r25473, r25472, r25471, r25470, r25469, r25468, r25467, r25466, r25465, r25463, r25462, r25455, r25452, r25451, r25450, r25447, r25446, r25445, r25444, r25443, r25442, r25441, r25440, r25439, r25438, r25437, r25436, r25343, r25157)
+- Fix: SDL does not give an event when an application gets mouse focus while going to full screen, so manually force the mouse-is-in-window state [FS#5587] (r25523)
+- Fix: [NewGRF] When cargo NewGRF define a multiplier to modify vehicle capacities, use the same multiplier to modify loading speed (r25497, r25479)
+- Fix: When addings bits to a (train) station, the train trying to stop there could overshoot the (new) stop location and not stop at all [FS#5553] (r25495)
+- Fix: The face of the manager differed on clients when the company was started after the clients joined [FS#5610] (r25491, r25490)
+- Fix: Do not send encoded texts to names, but decode them into a plain C string and then pass them on [FS#5613] (r25489, r25488)
+- Fix: Do not allow control codes in names of things (signs, vehicles, towns, stations, etc), so they have a known maximum fixed size and are, by definition, the same for everyone (r25487)
+- Fix: Missing length validation for town and president names in script APIs (r25486)
+- Fix: [OSX] OS X SDK versions >= 10.5 always have a non-const iconv declaration (r25480)
+- Fix: Disable the depot-refit button in the order GUI, if the consist is not refittable unless it already has a refit order (r25459, r25458, r25457)
+- Fix: When town creation failed, removing remnants of the construction failed on protected houses [FS#5603] (r25429)
+- Fix: There were two hotkeys to toggle between 'unload' and 'unload if possible' (r25406)
+- Fix: The size of station construction windows could oscillate when resizing the window moved the mouse into the window [FS#5596] (r25395)
+- Fix: Restrict renaming engines to the server, just like renaming towns (r25394)
+- Fix: Loading only 8 bits into a 16 bit variable could cause endianness problems (r25337)
+- Fix: Check for zero width space in translations and fail upon finding them [FS#5589] (r25326)
+- Fix: [SDL] Keyboard input stopped working after fullscreen toggle [FS#5580] (r25318)
+- Fix: Proper size-estimation for numbers with n digits, i.e. not assume a particular number is the widest [FS#5562] (r25314, r25313)
+- Fix: Do not focus the editbox in the NewGRF window, if there is no editbox visible (r25307)
+- Fix: Game Script APIs that execute a DoCommand were returning the same result as in TestMode during world generation [FS#5561] (r25305)
+- Fix: Build railway fences next to objects, even if they are owned by the same company [FS#5565] (r25302)
+- Fix: gcc4.6 removed -mno-cygwin option (r25266)
+
+
 1.3.1 (2013-06-01)
 ------------------------------------------------------------------------
 - Fix: When overbuilding a reserved track with a non-track station tile, that tile would remain reserved and eventually trigger a crash upon removal [FS#5540] (r25251)
diff --git a/known-bugs.txt b/known-bugs.txt
index 36cae15aa..2b57b9b92 100644
--- a/known-bugs.txt
+++ b/known-bugs.txt
@@ -1,6 +1,6 @@
 OpenTTD's known bugs
-Last updated:    2013-06-01
-Release version: 1.3.1
+Last updated:    2013-11-29
+Release version: 1.3.3
 ------------------------------------------------------------------------
 
 
diff --git a/os/debian/changelog b/os/debian/changelog
index 3f3ae6256..cd394a632 100644
--- a/os/debian/changelog
+++ b/os/debian/changelog
@@ -1,3 +1,51 @@
+openttd (1.3.3-0) unstable; urgency=low
+
+  * New upstream release 1.3.3
+
+ -- OpenTTD <info@openttd.org>  Fri, 29 Nov 2013 19:00:00 +0100
+
+openttd (1.3.3~RC2-0) unstable; urgency=low
+
+  * New upstream release 1.3.3-RC2
+
+ -- OpenTTD <info@openttd.org>  Sun, 24 Nov 2013 19:00:00 +0100
+
+openttd (1.3.3~RC1-0) unstable; urgency=low
+
+  * New upstream release 1.3.3-RC1
+
+ -- OpenTTD <info@openttd.org>  Sun, 17 Nov 2013 19:00:00 +0100
+
+openttd (1.3.2-0) unstable; urgency=low
+
+  * New upstream release 1.3.2
+
+ -- OpenTTD <info@openttd.org>  Sat, 27 Jul 2013 18:00:00 +0200
+
+openttd (1.3.2~RC2-0) unstable; urgency=low
+
+  * New upstream release 1.3.2-RC2
+
+ -- OpenTTD <info@openttd.org>  Sat, 13 Jul 2013 12:00:00 +0200
+
+openttd (1.3.2~RC1-0) unstable; urgency=low
+
+  * New upstream release 1.3.2-RC1
+
+ -- OpenTTD <info@openttd.org>  Sun, 30 Jun 2013 12:00:00 +0200
+
+openttd (1.3.1-0) unstable; urgency=low
+
+  * New upstream release 1.3.1
+
+ -- OpenTTD <info@openttd.org>  Sat, 01 Jun 2013 00:00:00 +0300
+
+openttd (1.3.1~RC1-0) unstable; urgency=low
+
+  * New upstream release 1.3.1-RC1
+
+ -- OpenTTD <info@openttd.org>  Fri, 17 May 2013 22:00:00 +0200
+
 openttd (1.3.0-0) unstable; urgency=low
 
   * New upstream release 1.3.0
diff --git a/readme.txt b/readme.txt
index 9ff003c66..0652fb3c9 100644
--- a/readme.txt
+++ b/readme.txt
@@ -1,5 +1,5 @@
-Last updated:    2013-06-01
-Release version: 1.3.1
+Last updated:    2013-11-29
+Release version: 1.3.3
 ------------------------------------------------------------------------
 
 
@@ -668,7 +668,7 @@ os/dos/exe2coff/copying.dj for the exact licensing terms.
 The CWSDPMI implementation in os/dos/cwsdpmi is distributed under a
 custom binary-only license that prohibits modification. The exact
 licensing terms can be found in os/dos/cwsdpmi/cwsdpmi.txt. The sources
-for these files can be downloaded at it's author site, at:
+for these files can be downloaded at its author site, at:
 http://homer.rice.edu/~sandmann/cwsdpmi/csdpmi5s.zip
 
 X.X) Credits
diff --git a/src/script/api/ai_changelog.hpp b/src/script/api/ai_changelog.hpp
index 0039eaf91..a40996c0f 100644
--- a/src/script/api/ai_changelog.hpp
+++ b/src/script/api/ai_changelog.hpp
@@ -30,6 +30,19 @@
  * \li AIStation::GetCargoRating does return -1 for cargo-station combinations that
  *     do not have a rating yet instead of returning 69.
  *
+ * \b 1.3.3
+ *
+ * No changes
+ *
+ * \b 1.3.2
+ *
+ * No changes
+ *
+ * \b 1.3.1
+ *
+ * API additions:
+ * \li AITile::GetTerrainType
+ *
  * \b 1.3.0
  *
  * API additions:
diff --git a/src/script/api/game_changelog.hpp b/src/script/api/game_changelog.hpp
index cf5d44573..e55d8c214 100644
--- a/src/script/api/game_changelog.hpp
+++ b/src/script/api/game_changelog.hpp
@@ -40,6 +40,19 @@
  * \li GSStation::GetCargoRating does return -1 for cargo-station combinations that
  *     do not have a rating yet instead of returning 69.
  *
+ * \b 1.3.3
+ *
+ * No changes
+ *
+ * \b 1.3.2
+ *
+ * No changes
+ *
+ * \b 1.3.1
+ *
+ * API additions:
+ * \li GSTile::GetTerrainType
+ *
  * \b 1.3.0
  *
  * API additions: