src/script/api/game_changelog.hpp

   1 /* $Id$ */
   2
   3 /*
   4  * This file is part of OpenTTD.
   5  * 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.
   6  * 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.
   7  * 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/>.
   8  */
   9
  10 /**
  11  * @file game_changelog.hpp Lists all changes / additions to the API.
  12  *
  13  * Only new / renamed / deleted api functions will be listed here. A list of
  14  * bug fixes can be found in the normal changelog. Note that removed API
  15  * functions may still be available if you return an older API version
  16  * in GetAPIVersion() in info.nut.
  17  *
  18  * \b 1.9.0
  19  *
  20  * 1.9.0 is not yet released. The following changes are not set in stone yet.
  21  *
  22  * \b 1.8.0
  23  *
  24  * 1.8.0 is not yet released. The following changes are not set in stone yet.
  25  *
  26  * \b 1.7.0 - 1.7.2
  27  *
  28  * No changes
  29  *
  30  * \b 1.6.1 - 1.6.0
  31  *
  32  * No changes
  33  *
  34  * \b 1.5.3 - 1.5.1
  35  *
  36  * No changes
  37  *
  38  * \b 1.5.0
  39  *
  40  * API additions:
  41  * \li GSList::SwapList
  42  * \li GSStation::GetCargoPlanned
  43  * \li GSStation::GetCargoPlannedFrom
  44  * \li GSStation::GetCargoPlannedFromVia
  45  * \li GSStation::GetCargoPlannedVia
  46  * \li GSStation::GetCargoWaitingFromVia
  47  * \li GSStationList_CargoPlannedByFrom
  48  * \li GSStationList_CargoPlannedByVia
  49  * \li GSStationList_CargoPlannedFromByVia
  50  * \li GSStationList_CargoPlannedViaByFrom
  51  * \li GSStationList_CargoWaitingByFrom
  52  * \li GSStationList_CargoWaitingByVia
  53  * \li GSStationList_CargoWaitingFromByVia
  54  * \li GSStationList_CargoWaitingViaByFrom
  55  *
  56  * Other changes:
  57  * \li GSNews::Create takes two extra parameters to refer to a location, station,
  58  *     industry, or town. The user can click at the news message to jump to the
  59  *     referred location.
  60  *
  61  * \b 1.4.4 - 1.4.3
  62  *
  63  * No changes
  64  *
  65  * \b 1.4.2
  66  *
  67  * Other changes:
  68  * \li GSCargoMonitor delivery and pickup monitor functions have improved boundary checking for
  69  *     their parameters, and return \c -1 if they are found out of bounds.
  70  *
  71  * \b 1.4.1
  72  *
  73  * No changes
  74  *
  75  * \b 1.4.0
  76  *
  77  * API additions:
  78  * \li AICargo::GetDistributionType
  79  * \li GSCompany::ChangeBankBalance
  80  * \li GSDate::DATE_INVALID
  81  * \li GSDate::IsValidDate
  82  * \li GSGoal::GT_STORY_PAGE
  83  * \li GSGoal::IsCompleted
  84  * \li GSGoal::SetCompleted
  85  * \li GSGoal::SetProgress
  86  * \li GSGoal::SetText
  87  * \li GSStation::HasCargoRating
  88  * \li GSStation::GetCargoWaitingFrom
  89  * \li GSStation::GetCargoWaitingVia
  90  * \li GSStoryPage
  91  * \li GSStoryPageList
  92  * \li GSStoryPageElementList
  93  * \li GSTile::GetTerrainType
  94  * \li GSTown::FoundTown
  95  * \li GSTown::GetFundBuildingsDuration
  96  * \li GSTown::SetName
  97  * \li GSTown::TOWN_GROWTH_NONE
  98  * \li GSTown::TOWN_GROWTH_NORMAL
  99  *
 100  * Other changes:
 101  * \li GSGoal::New can now create up to 64000 concurrent goals. The old limit was 256 goals.
 102  * \li GSStation::GetCargoRating does return -1 for cargo-station combinations that
 103  *     do not have a rating yet instead of returning 69.
 104  *
 105  * \b 1.3.3 - 1.3.2
 106  *
 107  * No changes
 108  *
 109  * \b 1.3.1
 110  *
 111  * API additions:
 112  * \li GSTile::GetTerrainType
 113  *
 114  * \b 1.3.0
 115  *
 116  * API additions:
 117  * \li GSCargoMonitor
 118  * \li GSEngine::IsValidEngine and GSEngine::IsBuildable when outside GSCompanyMode scope
 119  * \li GSEventExclusiveTransportRights
 120  * \li GSEventRoadReconstruction
 121  * \li GSNews::NT_ACCIDENT, GSNews::NT_COMPANY_INFO, GSNews::NT_ADVICE, GSNews::NT_ACCEPTANCE
 122  * \li GSIndustryType::IsProcessingIndustry
 123  * \li GSStation::IsAirportClosed
 124  * \li GSStation::OpenCloseAirport
 125  * \li GSController::Break
 126  * \li GSIndustryType::BuildIndustry, GSIndustryType::CanBuildIndustry, GSIndustryType::ProspectIndustry and GSIndustryType::CanProspectIndustry when outside GSCompanyMode scope
 127  *
 128  * Other changes:
 129  * \li Company specific goals are now removed when a company goes bankrupt or is taken over.
 130  *
 131  * \b 1.2.3 - 1.2.1
 132  *
 133  * No changes
 134  *
 135  * \b 1.2.0
 136  * \li First stable release with the NoGo framework.
 137  */