forked from stkb/Rewrap
-
Notifications
You must be signed in to change notification settings - Fork 10
Open
Description
The lua-language-server only analyses docstrings and annotations if the comment lines begin with three hyphens.
If I rewrap this example:
---
---Set a limit for the size of the backtrack stack used by LPeg to
---track calls and choices.
---
---The default limit is `400`.
---Most well-written patterns need little backtrack levels and
---therefore you seldom need to change this limit;
---before changing it you should try to rewrite your
---pattern to avoid the need for extra space.
---Nevertheless, a few useful patterns may overflow.
---Also, with recursive grammars,
---subjects with deep recursion may also need larger limits.
---
---@param max integer
---
---😱 [Types](https://github.com/LuaCATS/lpeg/blob/main/library/lpeg.lua) incomplete or incorrect? 🙏 [Please contribute!](https://github.com/LuaCATS/lpeg/pulls)I get:
--- -Set a limit for the size of the backtrack stack used by LPeg to -track
--calls and choices.
---
---The default limit is `400`. -Most well-written patterns need little backtrack
--levels and -therefore you seldom need to change this limit; -before changing
--it you should try to rewrite your -pattern to avoid the need for extra space.
---Nevertheless, a few useful patterns may overflow. -Also, with recursive
--grammars, -subjects with deep recursion may also need larger limits.
---
---@param max integer
---
---😱 [Types](https://github.com/LuaCATS/lpeg/blob/main/library/lpeg.lua)
--incomplete or incorrect? 🙏 [Please
--contribute!](https://github.com/LuaCATS/lpeg/pulls)This is what the desired result should look like:
---
---Set a limit for the size of the backtrack stack used by LPeg to track calls
---and choices.
---
---The default limit is `400`. Most well-written patterns need little backtrack
---levels and therefore you seldom need to change this limit; before changing it
---you should try to rewrite your pattern to avoid the need for extra space.
---Nevertheless, a few useful patterns may overflow. Also, with recursive
---grammars, subjects with deep recursion may also need larger limits.
---
---@param max integer
---
---😱 [Types](https://github.com/LuaCATS/lpeg/blob/main/library/lpeg.lua) incomplete or incorrect? 🙏 [Please contribute!](https://github.com/LuaCATS/lpeg/pulls)potpiefox
Metadata
Metadata
Assignees
Labels
No labels