(svn r20288) -Doc: add doxygen string to all GetClassName functions (part of all AI api classes)

50 files changed, 85 insertions, 0 deletions

diff --git a/src/ai/api/ai_abstractlist.hpp b/src/ai/api/ai_abstractlist.hpp
index e2c0a92b9..a0b97f8f7 100644
--- a/src/ai/api/ai_abstractlist.hpp
+++ b/src/ai/api/ai_abstractlist.hpp
@@ -24,6 +24,7 @@ class AIAbstractListSorter;
  */
 class AIAbstractList : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIAbstractList"; }
 
 	/** Type of sorter */
diff --git a/src/ai/api/ai_accounting.hpp b/src/ai/api/ai_accounting.hpp
index 216ddabdd..1d4fc9085 100644
--- a/src/ai/api/ai_accounting.hpp
+++ b/src/ai/api/ai_accounting.hpp
@@ -29,6 +29,7 @@
  */
 class AIAccounting : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIAccounting"; }
 
 	/**
diff --git a/src/ai/api/ai_airport.hpp b/src/ai/api/ai_airport.hpp
index d43eecafd..a058209c6 100644
--- a/src/ai/api/ai_airport.hpp
+++ b/src/ai/api/ai_airport.hpp
@@ -19,6 +19,7 @@
  */
 class AIAirport : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIAirport"; }
 
 	/**
diff --git a/src/ai/api/ai_base.hpp b/src/ai/api/ai_base.hpp
index bf49b3813..d17bb05bd 100644
--- a/src/ai/api/ai_base.hpp
+++ b/src/ai/api/ai_base.hpp
@@ -25,6 +25,7 @@
  */
 class AIBase : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIBase"; }
 
 	/**
diff --git a/src/ai/api/ai_basestation.hpp b/src/ai/api/ai_basestation.hpp
index 2e6bb9026..aadc5fbed 100644
--- a/src/ai/api/ai_basestation.hpp
+++ b/src/ai/api/ai_basestation.hpp
@@ -20,6 +20,7 @@
  */
 class AIBaseStation : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIBaseStation"; }
 
 	/**
diff --git a/src/ai/api/ai_bridge.hpp b/src/ai/api/ai_bridge.hpp
index 19e6bbed1..7a1842a37 100644
--- a/src/ai/api/ai_bridge.hpp
+++ b/src/ai/api/ai_bridge.hpp
@@ -41,6 +41,7 @@ public:
 		ERR_BRIDGE_HEADS_NOT_ON_SAME_HEIGHT, // [STR_ERROR_BRIDGEHEADS_NOT_SAME_HEIGHT]
 	};
 
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIBridge"; }
 
 	/**
diff --git a/src/ai/api/ai_bridgelist.hpp b/src/ai/api/ai_bridgelist.hpp
index d94100efd..3e9da60b7 100644
--- a/src/ai/api/ai_bridgelist.hpp
+++ b/src/ai/api/ai_bridgelist.hpp
@@ -20,6 +20,7 @@
  */
 class AIBridgeList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIBridgeList"; }
 	AIBridgeList();
 };
@@ -30,6 +31,7 @@ public:
  */
 class AIBridgeList_Length : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIBridgeList_Length"; }
 
 	/**
diff --git a/src/ai/api/ai_cargo.hpp b/src/ai/api/ai_cargo.hpp
index 819d0399a..4d7ad777b 100644
--- a/src/ai/api/ai_cargo.hpp
+++ b/src/ai/api/ai_cargo.hpp
@@ -19,6 +19,7 @@
  */
 class AICargo : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AICargo"; }
 
 	/**
diff --git a/src/ai/api/ai_cargolist.hpp b/src/ai/api/ai_cargolist.hpp
index 8f30e9eef..2cac3e0c2 100644
--- a/src/ai/api/ai_cargolist.hpp
+++ b/src/ai/api/ai_cargolist.hpp
@@ -20,6 +20,7 @@
  */
 class AICargoList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AICargoList"; }
 	AICargoList();
 };
@@ -30,6 +31,7 @@ public:
  */
 class AICargoList_IndustryAccepting : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AICargoList_IndustryAccepting"; }
 
 	/**
@@ -44,6 +46,7 @@ public:
  */
 class AICargoList_IndustryProducing : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AICargoList_IndustryProducing"; }
 
 	/**
diff --git a/src/ai/api/ai_company.hpp b/src/ai/api/ai_company.hpp
index a4b52d9a7..263271fc1 100644
--- a/src/ai/api/ai_company.hpp
+++ b/src/ai/api/ai_company.hpp
@@ -19,6 +19,7 @@
  */
 class AICompany : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AICompany"; }
 
 	/** Different constants related to CompanyID. */
diff --git a/src/ai/api/ai_controller.hpp b/src/ai/api/ai_controller.hpp
index a857886e0..03dd77ef4 100644
--- a/src/ai/api/ai_controller.hpp
+++ b/src/ai/api/ai_controller.hpp
@@ -24,6 +24,7 @@ class AIController {
 	friend class AIInstance;
 
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIController"; }
 
 	/**
diff --git a/src/ai/api/ai_date.hpp b/src/ai/api/ai_date.hpp
index 00d7e9781..3bb22f993 100644
--- a/src/ai/api/ai_date.hpp
+++ b/src/ai/api/ai_date.hpp
@@ -26,6 +26,7 @@
  */
 class AIDate : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIDate"; }
 
 	/**
diff --git a/src/ai/api/ai_depotlist.hpp b/src/ai/api/ai_depotlist.hpp
index 1574826d9..ac1cdee46 100644
--- a/src/ai/api/ai_depotlist.hpp
+++ b/src/ai/api/ai_depotlist.hpp
@@ -21,6 +21,7 @@
  */
 class AIDepotList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIDepotList"; }
 
 	/**
diff --git a/src/ai/api/ai_engine.hpp b/src/ai/api/ai_engine.hpp
index 62cfcbc4d..b126734a8 100644
--- a/src/ai/api/ai_engine.hpp
+++ b/src/ai/api/ai_engine.hpp
@@ -23,6 +23,7 @@
  */
 class AIEngine : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEngine"; }
 
 	/**
diff --git a/src/ai/api/ai_enginelist.hpp b/src/ai/api/ai_enginelist.hpp
index 992f02ff1..f52dd371d 100644
--- a/src/ai/api/ai_enginelist.hpp
+++ b/src/ai/api/ai_enginelist.hpp
@@ -21,6 +21,7 @@
  */
 class AIEngineList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEngineList"; }
 
 	/**
diff --git a/src/ai/api/ai_error.hpp b/src/ai/api/ai_error.hpp
index 607eafbf4..e26944eae 100644
--- a/src/ai/api/ai_error.hpp
+++ b/src/ai/api/ai_error.hpp
@@ -43,6 +43,7 @@
  */
 class AIError : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIError"; }
 
 	/**
diff --git a/src/ai/api/ai_event.hpp b/src/ai/api/ai_event.hpp
index dd12dfbca..ed77d95b3 100644
--- a/src/ai/api/ai_event.hpp
+++ b/src/ai/api/ai_event.hpp
@@ -21,6 +21,7 @@
  */
 class AIEvent : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEvent"; }
 
 	/**
@@ -81,6 +82,7 @@ public:
 	/**
 	 * The name of the class, needed by several sub-processes.
 	 */
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventController"; }
 
 	/**
diff --git a/src/ai/api/ai_event_types.hpp b/src/ai/api/ai_event_types.hpp
index 826b93950..7be1136e3 100644
--- a/src/ai/api/ai_event_types.hpp
+++ b/src/ai/api/ai_event_types.hpp
@@ -22,6 +22,7 @@
  */
 class AIEventVehicleCrashed : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventVehicleCrashed"; }
 
 	/**
@@ -84,6 +85,7 @@ private:
  */
 class AIEventSubsidyOffer : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventSubsidyOffer"; }
 
 	/**
@@ -116,6 +118,7 @@ private:
  */
 class AIEventSubsidyOfferExpired : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventSubsidyOfferExpired"; }
 
 	/**
@@ -148,6 +151,7 @@ private:
  */
 class AIEventSubsidyAwarded : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventSubsidyAwarded"; }
 
 	/**
@@ -180,6 +184,7 @@ private:
  */
 class AIEventSubsidyExpired : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventSubsidyExpired"; }
 
 	/**
@@ -214,6 +219,7 @@ private:
  */
 class AIEventEnginePreview : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventEnginePreview"; }
 
 	/**
@@ -298,6 +304,7 @@ private:
  */
 class AIEventCompanyNew : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventCompanyNew"; }
 
 	/**
@@ -331,6 +338,7 @@ private:
  */
 class AIEventCompanyInTrouble : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventCompanyInTrouble"; }
 
 	/**
@@ -363,6 +371,7 @@ private:
  */
 class AIEventCompanyAskMerger : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventCompanyAskMerger"; }
 
 	/**
@@ -412,6 +421,7 @@ private:
  */
 class AIEventCompanyMerger : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventCompanyMerger"; }
 
 	/**
@@ -456,6 +466,7 @@ private:
  */
 class AIEventCompanyBankrupt : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventCompanyBankrupt"; }
 
 	/**
@@ -488,6 +499,7 @@ private:
  */
 class AIEventVehicleLost : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventVehicleLost"; }
 
 	/**
@@ -520,6 +532,7 @@ private:
  */
 class AIEventVehicleWaitingInDepot : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventVehicleWaitingInDepot"; }
 
 	/**
@@ -552,6 +565,7 @@ private:
  */
 class AIEventVehicleUnprofitable : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventVehicleUnprofitable"; }
 
 	/**
@@ -584,6 +598,7 @@ private:
  */
 class AIEventIndustryOpen : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventIndustryOpen"; }
 
 	/**
@@ -616,6 +631,7 @@ private:
  */
 class AIEventIndustryClose : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventIndustryClose"; }
 
 	/**
@@ -648,6 +664,7 @@ private:
  */
 class AIEventEngineAvailable : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventEngineAvailable"; }
 
 	/**
@@ -680,6 +697,7 @@ private:
  */
 class AIEventStationFirstVehicle : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventStationFirstVehicle"; }
 
 	/**
@@ -721,6 +739,7 @@ private:
  */
 class AIEventDisasterZeppelinerCrashed : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventDisasterZeppelinerCrashed"; }
 
 	/**
@@ -753,6 +772,7 @@ private:
  */
 class AIEventDisasterZeppelinerCleared : public AIEvent {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIEventDisasterZeppelinerCleared"; }
 
 	/**
diff --git a/src/ai/api/ai_execmode.hpp b/src/ai/api/ai_execmode.hpp
index 6fb2f8cef..f5d2a5398 100644
--- a/src/ai/api/ai_execmode.hpp
+++ b/src/ai/api/ai_execmode.hpp
@@ -23,6 +23,7 @@
  */
 class AIExecMode : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIExecMode"; }
 
 private:
diff --git a/src/ai/api/ai_gamesettings.hpp b/src/ai/api/ai_gamesettings.hpp
index 4be80c40c..a38debe6d 100644
--- a/src/ai/api/ai_gamesettings.hpp
+++ b/src/ai/api/ai_gamesettings.hpp
@@ -37,6 +37,7 @@
  */
 class AIGameSettings : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIGameSettings"; }
 
 	/**
diff --git a/src/ai/api/ai_group.hpp b/src/ai/api/ai_group.hpp
index 0a3aa9f08..593bdb559 100644
--- a/src/ai/api/ai_group.hpp
+++ b/src/ai/api/ai_group.hpp
@@ -20,6 +20,7 @@
  */
 class AIGroup : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIGroup"; }
 
 	/**
diff --git a/src/ai/api/ai_grouplist.hpp b/src/ai/api/ai_grouplist.hpp
index 4629ad8bb..a2651cc1d 100644
--- a/src/ai/api/ai_grouplist.hpp
+++ b/src/ai/api/ai_grouplist.hpp
@@ -21,6 +21,7 @@
  */
 class AIGroupList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIGroupList"; }
 	AIGroupList();
 };
diff --git a/src/ai/api/ai_industry.hpp b/src/ai/api/ai_industry.hpp
index d5eaac817..0d662d2b6 100644
--- a/src/ai/api/ai_industry.hpp
+++ b/src/ai/api/ai_industry.hpp
@@ -19,6 +19,7 @@
  */
 class AIIndustry : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIIndustry"; }
 
 	/**
diff --git a/src/ai/api/ai_industrylist.hpp b/src/ai/api/ai_industrylist.hpp
index 3fcfb17f8..8f7854165 100644
--- a/src/ai/api/ai_industrylist.hpp
+++ b/src/ai/api/ai_industrylist.hpp
@@ -20,6 +20,7 @@
  */
 class AIIndustryList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIIndustryList"; }
 	AIIndustryList();
 };
@@ -30,6 +31,7 @@ public:
  */
 class AIIndustryList_CargoAccepting : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIIndustryList_CargoAccepting"; }
 
 	/**
@@ -45,6 +47,7 @@ public:
  */
 class AIIndustryList_CargoProducing : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIIndustryList_CargoProducing"; }
 
 	/**
diff --git a/src/ai/api/ai_industrytype.hpp b/src/ai/api/ai_industrytype.hpp
index 94f8d1705..2d0e48b31 100644
--- a/src/ai/api/ai_industrytype.hpp
+++ b/src/ai/api/ai_industrytype.hpp
@@ -21,6 +21,7 @@
  */
 class AIIndustryType : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIIndustryType"; }
 
 	/**
diff --git a/src/ai/api/ai_industrytypelist.hpp b/src/ai/api/ai_industrytypelist.hpp
index ce6860b77..a2b170065 100644
--- a/src/ai/api/ai_industrytypelist.hpp
+++ b/src/ai/api/ai_industrytypelist.hpp
@@ -21,6 +21,7 @@
  */
 class AIIndustryTypeList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIIndustryTypeList"; }
 	AIIndustryTypeList();
 };
diff --git a/src/ai/api/ai_list.hpp b/src/ai/api/ai_list.hpp
index 937997208..1bd114aa2 100644
--- a/src/ai/api/ai_list.hpp
+++ b/src/ai/api/ai_list.hpp
@@ -20,6 +20,7 @@
  */
 class AIList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIList"; }
 
 public:
diff --git a/src/ai/api/ai_log.hpp b/src/ai/api/ai_log.hpp
index 641059fbc..c14416644 100644
--- a/src/ai/api/ai_log.hpp
+++ b/src/ai/api/ai_log.hpp
@@ -23,6 +23,7 @@ class AILog : public AIObject {
 	friend class AIController;
 
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AILog"; }
 
 #ifndef EXPORT_SKIP
diff --git a/src/ai/api/ai_map.hpp b/src/ai/api/ai_map.hpp
index 5aba3722f..316a3590e 100644
--- a/src/ai/api/ai_map.hpp
+++ b/src/ai/api/ai_map.hpp
@@ -22,6 +22,7 @@ class AIMap : public AIObject {
 public:
 	static const int TILE_INVALID = (int)INVALID_TILE; ///< Invalid TileIndex.
 
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIMap"; }
 
 	/**
diff --git a/src/ai/api/ai_marine.hpp b/src/ai/api/ai_marine.hpp
index a1a0a092e..e324e27f3 100644
--- a/src/ai/api/ai_marine.hpp
+++ b/src/ai/api/ai_marine.hpp
@@ -20,6 +20,7 @@
  */
 class AIMarine : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIMarine"; }
 
 	/**
diff --git a/src/ai/api/ai_order.hpp b/src/ai/api/ai_order.hpp
index 2c80f31ab..4bdd3f560 100644
--- a/src/ai/api/ai_order.hpp
+++ b/src/ai/api/ai_order.hpp
@@ -20,6 +20,7 @@
  */
 class AIOrder : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIOrder"; }
 
 	/**
diff --git a/src/ai/api/ai_rail.hpp b/src/ai/api/ai_rail.hpp
index 79f12d215..8b858c0ad 100644
--- a/src/ai/api/ai_rail.hpp
+++ b/src/ai/api/ai_rail.hpp
@@ -21,6 +21,7 @@
  */
 class AIRail : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIRail"; }
 
 	/**
diff --git a/src/ai/api/ai_railtypelist.hpp b/src/ai/api/ai_railtypelist.hpp
index 8be876053..6ee6a7cd5 100644
--- a/src/ai/api/ai_railtypelist.hpp
+++ b/src/ai/api/ai_railtypelist.hpp
@@ -20,6 +20,7 @@
  */
 class AIRailTypeList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIRailTypeList"; }
 	AIRailTypeList();
 };
diff --git a/src/ai/api/ai_road.hpp b/src/ai/api/ai_road.hpp
index 705a316f3..0dda93e33 100644
--- a/src/ai/api/ai_road.hpp
+++ b/src/ai/api/ai_road.hpp
@@ -21,6 +21,7 @@
  */
 class AIRoad : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIRoad"; }
 
 	/**
diff --git a/src/ai/api/ai_sign.hpp b/src/ai/api/ai_sign.hpp
index 4fba829a0..518f1782b 100644
--- a/src/ai/api/ai_sign.hpp
+++ b/src/ai/api/ai_sign.hpp
@@ -21,6 +21,7 @@
  */
 class AISign : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AISign"; }
 
 	/**
diff --git a/src/ai/api/ai_signlist.hpp b/src/ai/api/ai_signlist.hpp
index c12904706..be6986d56 100644
--- a/src/ai/api/ai_signlist.hpp
+++ b/src/ai/api/ai_signlist.hpp
@@ -20,6 +20,7 @@
  */
 class AISignList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AISignList"; }
 	AISignList();
 };
diff --git a/src/ai/api/ai_station.hpp b/src/ai/api/ai_station.hpp
index 9a8abf7fc..68ead640c 100644
--- a/src/ai/api/ai_station.hpp
+++ b/src/ai/api/ai_station.hpp
@@ -22,6 +22,7 @@
  */
 class AIStation : public AIBaseStation {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIStation"; }
 
 	/**
diff --git a/src/ai/api/ai_stationlist.hpp b/src/ai/api/ai_stationlist.hpp
index 5bc5681af..bbe8b0902 100644
--- a/src/ai/api/ai_stationlist.hpp
+++ b/src/ai/api/ai_stationlist.hpp
@@ -21,6 +21,7 @@
  */
 class AIStationList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIStationList"; }
 
 	/**
@@ -35,6 +36,7 @@ public:
  */
 class AIStationList_Vehicle : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIStationList_Vehicle"; }
 
 	/**
diff --git a/src/ai/api/ai_subsidy.hpp b/src/ai/api/ai_subsidy.hpp
index a15c39e7d..2993c867e 100644
--- a/src/ai/api/ai_subsidy.hpp
+++ b/src/ai/api/ai_subsidy.hpp
@@ -20,6 +20,7 @@
  */
 class AISubsidy : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AISubsidy"; }
 
 	/**
diff --git a/src/ai/api/ai_subsidylist.hpp b/src/ai/api/ai_subsidylist.hpp
index 988898d92..4b8adf2fc 100644
--- a/src/ai/api/ai_subsidylist.hpp
+++ b/src/ai/api/ai_subsidylist.hpp
@@ -20,6 +20,7 @@
  */
 class AISubsidyList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AISubsidyList"; }
 	AISubsidyList();
 };
diff --git a/src/ai/api/ai_testmode.hpp b/src/ai/api/ai_testmode.hpp
index 992cb42b5..a5596727e 100644
--- a/src/ai/api/ai_testmode.hpp
+++ b/src/ai/api/ai_testmode.hpp
@@ -25,6 +25,7 @@
  */
 class AITestMode : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITestMode"; }
 
 private:
diff --git a/src/ai/api/ai_tile.hpp b/src/ai/api/ai_tile.hpp
index 5b6854931..b74c5b9f7 100644
--- a/src/ai/api/ai_tile.hpp
+++ b/src/ai/api/ai_tile.hpp
@@ -21,6 +21,7 @@
  */
 class AITile : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITile"; }
 
 	/**
diff --git a/src/ai/api/ai_tilelist.hpp b/src/ai/api/ai_tilelist.hpp
index f3d0755e2..f4fb9b3e3 100644
--- a/src/ai/api/ai_tilelist.hpp
+++ b/src/ai/api/ai_tilelist.hpp
@@ -21,6 +21,7 @@
  */
 class AITileList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITileList"; }
 
 	/**
@@ -63,6 +64,7 @@ public:
  */
 class AITileList_IndustryAccepting : public AITileList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITileList_IndustryAccepting"; }
 
 	/**
@@ -81,6 +83,7 @@ public:
  */
 class AITileList_IndustryProducing : public AITileList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITileList_IndustryProducing"; }
 
 	/**
@@ -99,6 +102,7 @@ public:
  */
 class AITileList_StationType : public AITileList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITileList_StationType"; }
 
 	/**
diff --git a/src/ai/api/ai_town.hpp b/src/ai/api/ai_town.hpp
index 68119aee0..83c9b2fa4 100644
--- a/src/ai/api/ai_town.hpp
+++ b/src/ai/api/ai_town.hpp
@@ -20,6 +20,7 @@
  */
 class AITown : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITown"; }
 
 	/**
diff --git a/src/ai/api/ai_townlist.hpp b/src/ai/api/ai_townlist.hpp
index aaded8a60..6a5001928 100644
--- a/src/ai/api/ai_townlist.hpp
+++ b/src/ai/api/ai_townlist.hpp
@@ -20,6 +20,7 @@
  */
 class AITownList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITownList"; }
 	AITownList();
 };
diff --git a/src/ai/api/ai_tunnel.hpp b/src/ai/api/ai_tunnel.hpp
index 6c6c22490..0dac7e857 100644
--- a/src/ai/api/ai_tunnel.hpp
+++ b/src/ai/api/ai_tunnel.hpp
@@ -20,6 +20,7 @@
  */
 class AITunnel : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AITunnel"; }
 
 	/**
diff --git a/src/ai/api/ai_vehicle.hpp b/src/ai/api/ai_vehicle.hpp
index 24bc8b4f2..d2c56c4ab 100644
--- a/src/ai/api/ai_vehicle.hpp
+++ b/src/ai/api/ai_vehicle.hpp
@@ -22,6 +22,7 @@
  */
 class AIVehicle : public AIObject {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIVehicle"; }
 
 	/**
diff --git a/src/ai/api/ai_vehiclelist.hpp b/src/ai/api/ai_vehiclelist.hpp
index ac868ead3..8ea261862 100644
--- a/src/ai/api/ai_vehiclelist.hpp
+++ b/src/ai/api/ai_vehiclelist.hpp
@@ -21,6 +21,7 @@
  */
 class AIVehicleList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIVehicleList"; }
 	AIVehicleList();
 };
@@ -31,6 +32,7 @@ public:
  */
 class AIVehicleList_Station : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIVehicleList_Station"; }
 
 	/**
@@ -50,6 +52,7 @@ public:
  */
 class AIVehicleList_Depot : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIVehicleList_Depot"; }
 
 	/**
@@ -64,6 +67,7 @@ public:
  */
 class AIVehicleList_SharedOrders : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIVehicleList_SharedOrders"; }
 
 	/**
@@ -78,6 +82,7 @@ public:
  */
 class AIVehicleList_Group : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIVehicleList_Group"; }
 
 	/**
@@ -92,6 +97,7 @@ public:
  */
 class AIVehicleList_DefaultGroup : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIVehicleList_DefaultGroup"; }
 
 	/**
diff --git a/src/ai/api/ai_waypoint.hpp b/src/ai/api/ai_waypoint.hpp
index 2bbb0f4a4..1ba1b99ef 100644
--- a/src/ai/api/ai_waypoint.hpp
+++ b/src/ai/api/ai_waypoint.hpp
@@ -21,6 +21,7 @@
  */
 class AIWaypoint : public AIBaseStation {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIWaypoint"; }
 
 	/**
diff --git a/src/ai/api/ai_waypointlist.hpp b/src/ai/api/ai_waypointlist.hpp
index e7c322ece..70e235d5c 100644
--- a/src/ai/api/ai_waypointlist.hpp
+++ b/src/ai/api/ai_waypointlist.hpp
@@ -21,6 +21,7 @@
  */
 class AIWaypointList : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIWaypointList"; }
 
 	/**
@@ -35,6 +36,7 @@ public:
  */
 class AIWaypointList_Vehicle : public AIAbstractList {
 public:
+	/** Get the name of this class to identify it towards squirrel. */
 	static const char *GetClassName() { return "AIWaypointList_Vehicle"; }
 
 	/**