LuaDoc. Fixed the start position of the comment first symbol in docs ---@param a string?Comment - now its Comment instead of omment.

Author: TIMONz1535

changelog.md

@@ -13,6 +13,7 @@
   ```
 * `NEW` Test CLI: `--name=<testname>` `-n=<testname>`: run specify unit test
 * `FIX` Fixed the error that the configuration file pointed to by the `--configpath` option was not read and loaded.
+* `FIX` Fixed the start position of the comment first symbol in docs `---@param a string?Comment` - now its `Comment` instead of `omment`.
 
 ## 3.13.5
 `2024-12-20`

script/parser/luadoc.lua

@@ -1743,11 +1743,15 @@ local function buildLuaDoc(comment)
                 finish = rest.firstFinish or result.finish
             end
         end
-        local cstart = text:find('%S', finish - comment.start)
-        if cstart and cstart < comment.finish then
+        -- the subtraction is the length of the skipped string, so the start position is `+ 1`
+        local cpos = finish - comment.start + 1
+        -- actual text start is `comment.start + 2` because of `--` for some reason
+        local textOffset = 2
+        local cstart = text:find('%S', cpos - textOffset)
+        if cstart and cstart < comment.finish - textOffset then
             result.comment = {
                 type   = 'doc.tailcomment',
-                start  = cstart + comment.start,
+                start  = comment.start + cstart - 1 + textOffset,
                 finish = comment.finish,
                 parent = result,
                 text   = trimTailComment(text:sub(cstart)),