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