(svn r22239) -Doc: Further engine doxyment additions.

1 files changed, 14 insertions, 1 deletions

diff --git a/src/engine.cpp b/src/engine.cpp
index 8774b0b3e..fa51e7c59 100644
--- a/src/engine.cpp
+++ b/src/engine.cpp
@@ -542,13 +542,21 @@ static void CheckRailIntroduction()
 
 void ShowEnginePreviewWindow(EngineID engine);
 
-/* Determine if an engine type is a wagon (and not a loco) */
+/**
+ * Determine whether an engine type is a wagon (and not a loco).
+ * @param index %Engine getting queried.
+ * @return Whether the queried engine is a wagon.
+ */
 static bool IsWagon(EngineID index)
 {
 	const Engine *e = Engine::Get(index);
 	return e->type == VEH_TRAIN && e->u.rail.railveh_type == RAILVEH_WAGON;
 }
 
+/**
+ * Update #reliability of engine \a e, (if needed) update the engine GUIs.
+ * @param e %Engine to update.
+ */
 static void CalcEngineReliability(Engine *e)
 {
 	uint age = e->age;
@@ -682,6 +690,11 @@ void StartupEngines()
 	InvalidateWindowClassesData(WC_BUILD_VEHICLE);
 }
 
+/**
+ * Company \a company accepts engine \a eid for preview.
+ * @param eid Engine being accepted (is under preview).
+ * @param company Current company previewing the engine.
+ */
 static void AcceptEnginePreview(EngineID eid, CompanyID company)
 {
 	Engine *e = Engine::Get(eid);