diff --git a/src/town.h b/src/town.h
index d2bcf7589b..81d6f894de 100644
--- a/src/town.h
+++ b/src/town.h
@@ -68,9 +68,9 @@ struct Town : TownPool::PoolItem<&_town_pool> {
 
 	/** @name Town name.
 	 * @{ */
-	uint32_t townnamegrfid = 0;
-	uint16_t townnametype = 0;
-	uint32_t townnameparts = 0;
+	uint32_t townnamegrfid = 0; ///< NewGRF id that contains the name. O is not used.
+	uint16_t townnametype = 0; ///< The style of the name.
+	uint32_t townnameparts = 0; ///< Random number that give unique town name when passed to generator.
 	std::string name{}; ///< Custom town name. If empty, the town was not renamed and uses the generated name.
 	mutable std::string cached_name{}; ///< NOSAVE: Cache of the resolved name of the town, if not using a custom town name
 	/** @} */