fix get_description

Author: xuhuanzy

crates/emmylua_code_analysis/src/compilation/analyzer/doc/mod.rs

@@ -93,12 +93,12 @@ impl<'a> DocAnalyzer<'a> {
 }
 
 pub fn preprocess_description(mut description: &str, owner: Option<&LuaSemanticDeclId>) -> String {
-    let has_remove_start_char = if let Some(owner) = owner {
+    let need_remove_start_char = if let Some(owner) = owner {
         !matches!(owner, LuaSemanticDeclId::Signature(_))
     } else {
         true
     };
-    if has_remove_start_char {
+    if need_remove_start_char {
         if description.starts_with(['#', '@']) {
             description = description.trim_start_matches(|c| c == '#' || c == '@');
         }

crates/emmylua_ls/src/handlers/test/hover_function_test.rs

@@ -478,4 +478,27 @@ mod tests {
             },
         ));
     }
+
+    #[test]
+    fn test_annotation_search() {
+        let mut ws = ProviderVirtualWorkspace::new();
+        ws.def_file(
+            "a.lua",
+            r#"
+                ---@version 5.4
+                ---测试
+                function test()
+                end
+
+            "#,
+        );
+        assert!(ws.check_hover(
+            r#"
+                <??>test()
+            "#,
+            VirtualHoverResult {
+                value: "```lua\nfunction test()\n```\n\n---\n\n测试".to_string(),
+            },
+        ));
+    }
 }

crates/emmylua_parser/src/syntax/node/doc/mod.rs

@@ -45,6 +45,19 @@ impl LuaAstNode for LuaComment {
     }
 }
 
+/// 检查语法节点是否为附加性质的文档标签
+///
+/// 附加性质的标签不会阻止查找 DocDescription
+fn is_additive_doc_tag(kind: LuaSyntaxKind) -> bool {
+    matches!(
+        kind,
+        LuaSyntaxKind::DocTagVisibility
+            | LuaSyntaxKind::DocTagExport
+            | LuaSyntaxKind::DocTagVersion
+            | LuaSyntaxKind::DocTagNodiscard
+    )
+}
+
 impl LuaComment {
     pub fn get_owner(&self) -> Option<LuaAst> {
         if let Some(inline_node) = find_inline_node(&self.syntax) {
@@ -66,8 +79,11 @@ impl LuaComment {
                 LuaKind::Syntax(LuaSyntaxKind::DocDescription) => {
                     return LuaDocDescription::cast(child.into_node().unwrap());
                 }
-                LuaKind::Token(LuaTokenKind::TkDocStart) => {
-                    return None;
+                LuaKind::Token(LuaTokenKind::TkDocStart) => {}
+                LuaKind::Syntax(syntax_kind) => {
+                    if !is_additive_doc_tag(syntax_kind) {
+                        return None;
+                    }
                 }
                 _ => {}
             }