Consistently use @ in Doxygen comments

solidpixel · solidpixel · commit 5a99c11761d4 · 2024-11-29T21:45:42.000Z
diff --git a/generator/vk_common/entry_utils.hpp b/generator/vk_common/entry_utils.hpp
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This module exposes common functionality used by layer entrypoints,
  * implemented as library code which can be swapped for alternative
  * implementations on a per-layer basis if needed.
diff --git a/generator/vk_common/utils.hpp b/generator/vk_common/utils.hpp
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This module implements miscellaneous utility functions.
  */
 
diff --git a/generator/vk_layer/source/device.hpp b/generator/vk_layer/source/device.hpp
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This module implements layer tracking for VkDevice objects.
  *
  * Role summary
diff --git a/generator/vk_layer/source/entry.cpp b/generator/vk_layer/source/entry.cpp
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This module exposes the entrypoints used by the layer loader.
  *
  * Note that the Android loader requires more functions to be exposed as
diff --git a/generator/vk_layer/source/instance.hpp b/generator/vk_layer/source/instance.hpp
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This module implements layer tracking for VkInstance objects.
  *
  * Role summary
diff --git a/generator/vk_layer/source/version.hpp.in b/generator/vk_layer/source/version.hpp.in
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This header implements placeholder templates that are populated by CMake
  * during configure.
  */
diff --git a/layer_example/source/device.hpp b/layer_example/source/device.hpp
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This module implements layer tracking for VkDevice objects.
  *
  * Role summary
diff --git a/layer_example/source/entry.cpp b/layer_example/source/entry.cpp
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This module exposes the entrypoints used by the layer loader.
  *
  * Note that the Android loader requires more functions to be exposed as
diff --git a/layer_example/source/instance.hpp b/layer_example/source/instance.hpp
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This module implements layer tracking for VkInstance objects.
  *
  * Role summary
diff --git a/layer_example/source/version.hpp.in b/layer_example/source/version.hpp.in
@@ -24,7 +24,7 @@
  */
 
 /**
- * \file
+ * @file
  * This header implements placeholder templates that are populated by CMake
  * during configure.
  */

-Original file line number
+Diff line change
  */
 /**
 - * \file
 + * @file
  * This module implements miscellaneous utility functions.
  */
Original file line number	Diff line number	Diff line change
`@@ -24,7 +24,7 @@`
`24`	`24`	`*/`
`25`	`25`
`26`	`26`	`/**`
`27`		`- * \file`
	`27`	`+ * @file`
`28`	`28`	`* This module implements layer tracking for VkDevice objects.`
`29`	`29`	`*`
`30`	`30`	`* Role summary`