From 2395b82bdcc199781e953199735f87cb23bcf89d Mon Sep 17 00:00:00 2001 From: Sean McManus Date: Fri, 22 May 2026 13:39:42 -0700 Subject: [PATCH 1/4] Add important, return, throw, throws doxygen.sectionTags. --- Extension/package.json | 8 ++++++++ Extension/src/nativeStrings.json | 16 ++++++++++++++-- 2 files changed, 22 insertions(+), 2 deletions(-) diff --git a/Extension/package.json b/Extension/package.json index c9e0d6958..af412cc66 100644 --- a/Extension/package.json +++ b/Extension/package.json @@ -1725,12 +1725,16 @@ "type": "array", "default": [ "attention", + "important", "tparam", "param", "result", + "return", "returns", "retval", "exception", + "throw", + "throws", "deprecated", "warning", "note" @@ -1747,6 +1751,7 @@ "deprecated", "details", "exception", + "important", "invariant", "note", "param", @@ -1754,6 +1759,7 @@ "post", "remark", "remarks", + "return", "result", "returns", "retval", @@ -1762,6 +1768,8 @@ "since", "tparam", "test", + "throw", + "throws", "todo", "version", "warning" diff --git a/Extension/src/nativeStrings.json b/Extension/src/nativeStrings.json index 06302e4b4..c9193ab36 100644 --- a/Extension/src/nativeStrings.json +++ b/Extension/src/nativeStrings.json @@ -189,6 +189,7 @@ }, "expands_to": "Expands to:", "attention_label": "Attention:", + "important_label": "Important:", "author_label": "Author:", "authors_label": "Authors:", "bug_label": "Bug:", @@ -200,6 +201,14 @@ "text": "Exceptions:", "hint": "This label is for describing the exceptions thrown by a function. Usage example: Exception: std::out_of_range parameter is out of range." }, + "throw_label": { + "text": "Throw:", + "hint": "This label is for describing the exceptions thrown by a function. Usage example: Throw: std::out_of_range parameter is out of range." + }, + "throws_label": { + "text": "Throws:", + "hint": "This label is for describing the exceptions thrown by a function. Usage example: Throws: std::out_of_range parameter is out of range." + }, "invariant_label": "Invariant:", "file_label": "File:", "note_label": "Note:", @@ -209,7 +218,10 @@ "remark_label": "Remark:", "remarks_label": "Remarks:", "result_label": "Result:", - "return_label": "Return:", + "return_label": { + "text": "Return:", + "hint": "This label is for the return value description for a function. Usage example: 'Return: Area of a shape.'" + }, "returns_label": { "text": "Returns:", "hint": "This label is for the return value description for a function. Usage example: 'Returns: Area of a shape.'" @@ -689,5 +701,5 @@ "status_indexing_files_with_n_of_m_and_text": "Indexing files ({0} of {1}): {2}", "status_indexing_files_with_text": "Indexing files {0}", "help_allow_missing_lsp_config": "Allow the server to start even if the specified --lsp-config file does not exist.", - "initialize_failed_during_engine_setup": "Initialization failed during engine setup." + "initialize_failed_during_engine_setup": "Initialization failed during engine setup." } \ No newline at end of file From 388dc41a979f2096fadd05459615917bcbc0f798 Mon Sep 17 00:00:00 2001 From: Sean McManus Date: Fri, 22 May 2026 16:25:35 -0700 Subject: [PATCH 2/4] Update. --- Extension/src/nativeStrings.json | 16 ++-------------- 1 file changed, 2 insertions(+), 14 deletions(-) diff --git a/Extension/src/nativeStrings.json b/Extension/src/nativeStrings.json index c9193ab36..04f04ac86 100644 --- a/Extension/src/nativeStrings.json +++ b/Extension/src/nativeStrings.json @@ -189,7 +189,6 @@ }, "expands_to": "Expands to:", "attention_label": "Attention:", - "important_label": "Important:", "author_label": "Author:", "authors_label": "Authors:", "bug_label": "Bug:", @@ -201,14 +200,6 @@ "text": "Exceptions:", "hint": "This label is for describing the exceptions thrown by a function. Usage example: Exception: std::out_of_range parameter is out of range." }, - "throw_label": { - "text": "Throw:", - "hint": "This label is for describing the exceptions thrown by a function. Usage example: Throw: std::out_of_range parameter is out of range." - }, - "throws_label": { - "text": "Throws:", - "hint": "This label is for describing the exceptions thrown by a function. Usage example: Throws: std::out_of_range parameter is out of range." - }, "invariant_label": "Invariant:", "file_label": "File:", "note_label": "Note:", @@ -218,10 +209,6 @@ "remark_label": "Remark:", "remarks_label": "Remarks:", "result_label": "Result:", - "return_label": { - "text": "Return:", - "hint": "This label is for the return value description for a function. Usage example: 'Return: Area of a shape.'" - }, "returns_label": { "text": "Returns:", "hint": "This label is for the return value description for a function. Usage example: 'Returns: Area of a shape.'" @@ -701,5 +688,6 @@ "status_indexing_files_with_n_of_m_and_text": "Indexing files ({0} of {1}): {2}", "status_indexing_files_with_text": "Indexing files {0}", "help_allow_missing_lsp_config": "Allow the server to start even if the specified --lsp-config file does not exist.", - "initialize_failed_during_engine_setup": "Initialization failed during engine setup." + "initialize_failed_during_engine_setup": "Initialization failed during engine setup.", + "important_label": "Important:" } \ No newline at end of file From e039195fb4e5a441126c57a8ae4a51dd80353bdd Mon Sep 17 00:00:00 2001 From: Sean McManus Date: Fri, 22 May 2026 16:28:15 -0700 Subject: [PATCH 3/4] Update. --- Extension/src/nativeStrings.json | 1 + 1 file changed, 1 insertion(+) diff --git a/Extension/src/nativeStrings.json b/Extension/src/nativeStrings.json index 04f04ac86..7aeb9d0d9 100644 --- a/Extension/src/nativeStrings.json +++ b/Extension/src/nativeStrings.json @@ -209,6 +209,7 @@ "remark_label": "Remark:", "remarks_label": "Remarks:", "result_label": "Result:", + "return_label": "Return:", "returns_label": { "text": "Returns:", "hint": "This label is for the return value description for a function. Usage example: 'Returns: Area of a shape.'" From 523d6ee0861762dbef462c08b42e7daa9e0781f8 Mon Sep 17 00:00:00 2001 From: Sean McManus Date: Fri, 22 May 2026 16:29:07 -0700 Subject: [PATCH 4/4] Update. --- Extension/package.json | 6 ------ 1 file changed, 6 deletions(-) diff --git a/Extension/package.json b/Extension/package.json index af412cc66..6cfc20c5c 100644 --- a/Extension/package.json +++ b/Extension/package.json @@ -1729,12 +1729,9 @@ "tparam", "param", "result", - "return", "returns", "retval", "exception", - "throw", - "throws", "deprecated", "warning", "note" @@ -1759,7 +1756,6 @@ "post", "remark", "remarks", - "return", "result", "returns", "retval", @@ -1768,8 +1764,6 @@ "since", "tparam", "test", - "throw", - "throws", "todo", "version", "warning"