diff --git a/src/bridge_type.h b/src/bridge_type.h
index 9359ee7b34..e0996dc001 100644
--- a/src/bridge_type.h
+++ b/src/bridge_type.h
@@ -43,10 +43,10 @@ enum class BridgePillarFlag : uint8_t {
 	CornerE = 2, ///< East corner is obstructed.
 	CornerN = 3, ///< North corner is obstructed.
 	/* Edges are in the same order as DiagDirection enum. */
-	EdgeNE = 4, //< Northeast edge is obstructed.
-	EdgeSE = 5, //< Southeast edge is obstructed.
-	EdgeSW = 6, //< Southwest edge is obstructed.
-	EdgeNW = 7, //< Northwest edge is obstructed.
+	EdgeNE = 4, ///< Northeast edge is obstructed.
+	EdgeSE = 5, ///< Southeast edge is obstructed.
+	EdgeSW = 6, ///< Southwest edge is obstructed.
+	EdgeNW = 7, ///< Northwest edge is obstructed.
 };
 using BridgePillarFlags = EnumBitSet<BridgePillarFlag, uint8_t>;
 
diff --git a/src/gamelog_internal.h b/src/gamelog_internal.h
index ef4546b138..755e995e40 100644
--- a/src/gamelog_internal.h
+++ b/src/gamelog_internal.h
@@ -56,7 +56,7 @@ struct LoggedChangeRevision : LoggedChange {
 	std::string text{}; ///< revision string, _openttd_revision
 	uint32_t newgrf = 0; ///< _openttd_newgrf_version
 	uint16_t slver = 0; ///< _sl_version
-	uint8_t modified = 0; //< _openttd_revision_modified
+	uint8_t modified = 0; ///< _openttd_revision_modified
 };
 
 struct LoggedChangeOldVersion : LoggedChange {
diff --git a/src/script/api/script_types.hpp b/src/script/api/script_types.hpp
index 3bc4e90c75..5bbd460e22 100644
--- a/src/script/api/script_types.hpp
+++ b/src/script/api/script_types.hpp
@@ -124,7 +124,7 @@
 /* Define all types here, so they are added to the API docs. */
 using BridgeType = uint32_t; ///< The ID of a bridge type.
 using CargoType = uint8_t; ///< The ID of a cargo type.
-using ClientID = uint32_t; //< The ID of a (network) client.
+using ClientID = uint32_t; ///< The ID of a (network) client.
 using CompanyID = uint8_t; ///< The ID of a company.
 using EngineID = uint16_t; ///< The ID of an engine.
 using GoalID = uint16_t; ///< The ID of a goal.
diff --git a/src/string.cpp b/src/string.cpp
index 08efada2fc..87651a2486 100644
--- a/src/string.cpp
+++ b/src/string.cpp
@@ -753,7 +753,7 @@ public:
 class DefaultStringIterator : public StringIterator
 {
 	Utf8View string; ///< Current string.
-	Utf8View::iterator cur_pos; //< Current iteration position.
+	Utf8View::iterator cur_pos; ///< Current iteration position.
 
 public:
 	void SetString(std::string_view s) override
diff --git a/src/tgp.cpp b/src/tgp.cpp
index 61de35564b..749aafc5b7 100644
--- a/src/tgp.cpp
+++ b/src/tgp.cpp
@@ -159,12 +159,12 @@ static const int AMPLITUDE_DECIMAL_BITS = 10;
 /** Height map - allocated array of heights (Map::SizeX() + 1) * (Map::SizeY() + 1) */
 struct HeightMap
 {
-	std::vector<Height> h; //< array of heights
+	std::vector<Height> h; ///< array of heights
 	/* Even though the sizes are always positive, there are many cases where
 	 * X and Y need to be signed integers due to subtractions. */
-	int      dim_x;      //< height map size_x Map::SizeX() + 1
-	int      size_x;     //< Map::SizeX()
-	int      size_y;     //< Map::SizeY()
+	int      dim_x;      ///< height map size_x Map::SizeX() + 1
+	int      size_x;     ///< Map::SizeX()
+	int      size_y;     ///< Map::SizeY()
 
 	/**
 	 * Height map accessor