From 595c45724d6e2fd2a81485876c53a8255a936c2e Mon Sep 17 00:00:00 2001
From: "Kenneth Benzie (Benie)" <benie@infektor.net>
Date: Thu, 14 Aug 2025 12:21:53 +0100
Subject: [PATCH] Add most commonly used Doxygen comment snippets

---
 snippets/c.lua      | 10 ++++++++++
 snippets/c.snippets | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/snippets/c.lua b/snippets/c.lua
index f06b791..ae0b763 100644
--- a/snippets/c.lua
+++ b/snippets/c.lua
@@ -45,6 +45,16 @@ local snippets = {
     end, key('guard')),
   }, {}),
 
+  -- Doxygen
+  snippet('p', {
+    text('@param'),
+    choice(1, { text('[in]'), text('[out]'), text('[in,out]'), text('') }),
+    text(' '),
+    insert(2, 'name'),
+    text(' '),
+    insert(0, 'desc'),
+  }),
+
 }
 
 return snippets
diff --git a/snippets/c.snippets b/snippets/c.snippets
index 1ca17de..7b70033 100644
--- a/snippets/c.snippets
+++ b/snippets/c.snippets
@@ -4,3 +4,13 @@ snippet main
 	int main(${1:int argc, const char **argv}) {
 		$0
 	}
+
+# Doxygen
+snippet b
+	@brief ${0:desc}
+
+snippet r
+	@return ${0:desc}
+
+snippet rv
+	@retval ${1:val} ${0:desc}