diff options
-rw-r--r-- | doc/en-us/config.md | 107 | ||||
-rw-r--r-- | doc/pt-br/config.md | 107 | ||||
-rw-r--r-- | doc/zh-cn/config.md | 107 | ||||
-rw-r--r-- | doc/zh-tw/config.md | 107 | ||||
-rw-r--r-- | tools/build-doc.lua | 25 |
5 files changed, 289 insertions, 164 deletions
diff --git a/doc/en-us/config.md b/doc/en-us/config.md index e7c65697..34d7181e 100644 --- a/doc/en-us/config.md +++ b/doc/en-us/config.md @@ -26,9 +26,10 @@ string ## enum -* `"Disable"`: Only shows `function name`. -* `"Both"`: Shows `function name` and `call snippet`. -* `"Replace"`: Only shows `call snippet.` +* ``"Disable"``: Only shows `function name`. +* ``"Both"``: Shows `function name` and `call snippet`. +* ``"Replace"``: Only shows `call snippet.` + ## default ```json @@ -79,9 +80,10 @@ string ## enum -* `"Disable"`: Only shows `keyword`. -* `"Both"`: Shows `keyword` and `syntax snippet`. -* `"Replace"`: Only shows `syntax snippet`. +* ``"Disable"``: Only shows `keyword`. +* ``"Both"``: Shows `keyword` and `syntax snippet`. +* ``"Replace"``: Only shows `syntax snippet`. + ## default ```json @@ -148,9 +150,10 @@ string ## enum -* `"Enable"`: Always show context words in suggestions. -* `"Fallback"`: Contextual words are only displayed when suggestions based on semantics cannot be provided. -* `"Disable"`: Do not display context words. +* ``"Enable"``: Always show context words in suggestions. +* ``"Fallback"``: Contextual words are only displayed when suggestions based on semantics cannot be provided. +* ``"Disable"``: Do not display context words. + ## default ```json @@ -249,9 +252,10 @@ string ## enum -* `"Enable"`: Always diagnose these files. -* `"Opened"`: Only when these files are opened will it be diagnosed. -* `"Disable"`: These files are not diagnosed. +* ``"Enable"``: Always diagnose these files. +* ``"Opened"``: Only when these files are opened will it be diagnosed. +* ``"Disable"``: These files are not diagnosed. + ## default ```json @@ -270,9 +274,10 @@ string ## enum -* `"Enable"`: Always diagnose these files. -* `"Opened"`: Only when these files are opened will it be diagnosed. -* `"Disable"`: These files are not diagnosed. +* ``"Enable"``: Always diagnose these files. +* ``"Opened"``: Only when these files are opened will it be diagnosed. +* ``"Disable"``: These files are not diagnosed. + ## default ```json @@ -294,9 +299,10 @@ object<string, string> ## enum -* `"Any"` -* `"Opened"` -* `"None"` +* ``"Any"`` +* ``"Opened"`` +* ``"None"`` + ## default ```json @@ -360,10 +366,11 @@ object<string, string> ## enum -* `"Error"` -* `"Warning"` -* `"Information"` -* `"Hint"` +* ``"Error"`` +* ``"Warning"`` +* ``"Information"`` +* ``"Hint"`` + ## default ```json @@ -491,9 +498,10 @@ string ## enum -* `"Enable"`: Show hints in all tables. -* `"Auto"`: Show hints only when the table is greater than 3 items, or the table is a mixed table. -* `"Disable"`: Disable hints of array index. +* ``"Enable"``: Show hints in all tables. +* ``"Auto"``: Show hints only when the table is greater than 3 items, or the table is a mixed table. +* ``"Disable"``: Disable hints of array index. + ## default ```json @@ -544,9 +552,10 @@ string ## enum -* `"All"`: All types of parameters are shown. -* `"Literal"`: Only literal type parameters are shown. -* `"Disable"`: Disable parameter hints. +* ``"All"``: All types of parameters are shown. +* ``"Literal"``: Only literal type parameters are shown. +* ``"Disable"``: Disable parameter hints. + ## default ```json @@ -730,9 +739,10 @@ object<string, string> ## enum -* `"default"` -* `"enable"` -* `"disable"` +* ``"default"`` +* ``"enable"`` +* ``"disable"`` + ## default ```json @@ -767,10 +777,11 @@ string ## enum -* `"utf8"` -* `"ansi"` -* `"utf16le"` -* `"utf16be"` +* ``"utf8"`` +* ``"ansi"`` +* ``"utf16le"`` +* ``"utf16be"`` + ## default ```json @@ -803,6 +814,21 @@ Supports non-standard symbols. Make sure that your runtime environment supports Array<string> ``` +## enum + +* ``"//"`` +* ``"/**/"`` +* ``"`"`` +* ``"+="`` +* ``"-="`` +* ``"*="`` +* ``"/="`` +* ``"||"`` +* ``"&&"`` +* ``"!"`` +* ``"!="`` +* ``"continue"`` + ## default ```json @@ -912,11 +938,12 @@ string ## enum -* `"Lua 5.1"` -* `"Lua 5.2"` -* `"Lua 5.3"` -* `"Lua 5.4"` -* `"LuaJIT"` +* ``"Lua 5.1"`` +* ``"Lua 5.2"`` +* ``"Lua 5.3"`` +* ``"Lua 5.4"`` +* ``"LuaJIT"`` + ## default ```json diff --git a/doc/pt-br/config.md b/doc/pt-br/config.md index e7c65697..34d7181e 100644 --- a/doc/pt-br/config.md +++ b/doc/pt-br/config.md @@ -26,9 +26,10 @@ string ## enum -* `"Disable"`: Only shows `function name`. -* `"Both"`: Shows `function name` and `call snippet`. -* `"Replace"`: Only shows `call snippet.` +* ``"Disable"``: Only shows `function name`. +* ``"Both"``: Shows `function name` and `call snippet`. +* ``"Replace"``: Only shows `call snippet.` + ## default ```json @@ -79,9 +80,10 @@ string ## enum -* `"Disable"`: Only shows `keyword`. -* `"Both"`: Shows `keyword` and `syntax snippet`. -* `"Replace"`: Only shows `syntax snippet`. +* ``"Disable"``: Only shows `keyword`. +* ``"Both"``: Shows `keyword` and `syntax snippet`. +* ``"Replace"``: Only shows `syntax snippet`. + ## default ```json @@ -148,9 +150,10 @@ string ## enum -* `"Enable"`: Always show context words in suggestions. -* `"Fallback"`: Contextual words are only displayed when suggestions based on semantics cannot be provided. -* `"Disable"`: Do not display context words. +* ``"Enable"``: Always show context words in suggestions. +* ``"Fallback"``: Contextual words are only displayed when suggestions based on semantics cannot be provided. +* ``"Disable"``: Do not display context words. + ## default ```json @@ -249,9 +252,10 @@ string ## enum -* `"Enable"`: Always diagnose these files. -* `"Opened"`: Only when these files are opened will it be diagnosed. -* `"Disable"`: These files are not diagnosed. +* ``"Enable"``: Always diagnose these files. +* ``"Opened"``: Only when these files are opened will it be diagnosed. +* ``"Disable"``: These files are not diagnosed. + ## default ```json @@ -270,9 +274,10 @@ string ## enum -* `"Enable"`: Always diagnose these files. -* `"Opened"`: Only when these files are opened will it be diagnosed. -* `"Disable"`: These files are not diagnosed. +* ``"Enable"``: Always diagnose these files. +* ``"Opened"``: Only when these files are opened will it be diagnosed. +* ``"Disable"``: These files are not diagnosed. + ## default ```json @@ -294,9 +299,10 @@ object<string, string> ## enum -* `"Any"` -* `"Opened"` -* `"None"` +* ``"Any"`` +* ``"Opened"`` +* ``"None"`` + ## default ```json @@ -360,10 +366,11 @@ object<string, string> ## enum -* `"Error"` -* `"Warning"` -* `"Information"` -* `"Hint"` +* ``"Error"`` +* ``"Warning"`` +* ``"Information"`` +* ``"Hint"`` + ## default ```json @@ -491,9 +498,10 @@ string ## enum -* `"Enable"`: Show hints in all tables. -* `"Auto"`: Show hints only when the table is greater than 3 items, or the table is a mixed table. -* `"Disable"`: Disable hints of array index. +* ``"Enable"``: Show hints in all tables. +* ``"Auto"``: Show hints only when the table is greater than 3 items, or the table is a mixed table. +* ``"Disable"``: Disable hints of array index. + ## default ```json @@ -544,9 +552,10 @@ string ## enum -* `"All"`: All types of parameters are shown. -* `"Literal"`: Only literal type parameters are shown. -* `"Disable"`: Disable parameter hints. +* ``"All"``: All types of parameters are shown. +* ``"Literal"``: Only literal type parameters are shown. +* ``"Disable"``: Disable parameter hints. + ## default ```json @@ -730,9 +739,10 @@ object<string, string> ## enum -* `"default"` -* `"enable"` -* `"disable"` +* ``"default"`` +* ``"enable"`` +* ``"disable"`` + ## default ```json @@ -767,10 +777,11 @@ string ## enum -* `"utf8"` -* `"ansi"` -* `"utf16le"` -* `"utf16be"` +* ``"utf8"`` +* ``"ansi"`` +* ``"utf16le"`` +* ``"utf16be"`` + ## default ```json @@ -803,6 +814,21 @@ Supports non-standard symbols. Make sure that your runtime environment supports Array<string> ``` +## enum + +* ``"//"`` +* ``"/**/"`` +* ``"`"`` +* ``"+="`` +* ``"-="`` +* ``"*="`` +* ``"/="`` +* ``"||"`` +* ``"&&"`` +* ``"!"`` +* ``"!="`` +* ``"continue"`` + ## default ```json @@ -912,11 +938,12 @@ string ## enum -* `"Lua 5.1"` -* `"Lua 5.2"` -* `"Lua 5.3"` -* `"Lua 5.4"` -* `"LuaJIT"` +* ``"Lua 5.1"`` +* ``"Lua 5.2"`` +* ``"Lua 5.3"`` +* ``"Lua 5.4"`` +* ``"LuaJIT"`` + ## default ```json diff --git a/doc/zh-cn/config.md b/doc/zh-cn/config.md index 43e8986c..71df8f36 100644 --- a/doc/zh-cn/config.md +++ b/doc/zh-cn/config.md @@ -26,9 +26,10 @@ string ## enum -* `"Disable"`: 只显示 `函数名`。 -* `"Both"`: 显示 `函数名` 与 `调用片段`。 -* `"Replace"`: 只显示 `调用片段`。 +* ``"Disable"``: 只显示 `函数名`。 +* ``"Both"``: 显示 `函数名` 与 `调用片段`。 +* ``"Replace"``: 只显示 `调用片段`。 + ## default ```json @@ -79,9 +80,10 @@ string ## enum -* `"Disable"`: 只显示 `关键字`。 -* `"Both"`: 显示 `关键字` 与 `语法片段`。 -* `"Replace"`: 只显示 `语法片段`。 +* ``"Disable"``: 只显示 `关键字`。 +* ``"Both"``: 显示 `关键字` 与 `语法片段`。 +* ``"Replace"``: 只显示 `语法片段`。 + ## default ```json @@ -148,9 +150,10 @@ string ## enum -* `"Enable"`: 总是在建议中显示上下文单词。 -* `"Fallback"`: 无法根据语义提供建议时才显示上下文单词。 -* `"Disable"`: 不显示上下文单词。 +* ``"Enable"``: 总是在建议中显示上下文单词。 +* ``"Fallback"``: 无法根据语义提供建议时才显示上下文单词。 +* ``"Disable"``: 不显示上下文单词。 + ## default ```json @@ -249,9 +252,10 @@ string ## enum -* `"Enable"`: 总是诊断这些文件。 -* `"Opened"`: 只有打开这些文件时才会诊断。 -* `"Disable"`: 不诊断这些文件。 +* ``"Enable"``: 总是诊断这些文件。 +* ``"Opened"``: 只有打开这些文件时才会诊断。 +* ``"Disable"``: 不诊断这些文件。 + ## default ```json @@ -270,9 +274,10 @@ string ## enum -* `"Enable"`: 总是诊断这些文件。 -* `"Opened"`: 只有打开这些文件时才会诊断。 -* `"Disable"`: 不诊断这些文件。 +* ``"Enable"``: 总是诊断这些文件。 +* ``"Opened"``: 只有打开这些文件时才会诊断。 +* ``"Disable"``: 不诊断这些文件。 + ## default ```json @@ -294,9 +299,10 @@ object<string, string> ## enum -* `"Any"` -* `"Opened"` -* `"None"` +* ``"Any"`` +* ``"Opened"`` +* ``"None"`` + ## default ```json @@ -360,10 +366,11 @@ object<string, string> ## enum -* `"Error"` -* `"Warning"` -* `"Information"` -* `"Hint"` +* ``"Error"`` +* ``"Warning"`` +* ``"Information"`` +* ``"Hint"`` + ## default ```json @@ -491,9 +498,10 @@ string ## enum -* `"Enable"`: 所有的表中都提示数组索引。 -* `"Auto"`: 只有表大于3项,或者表是混合类型时才进行提示。 -* `"Disable"`: 禁用数组索引提示。 +* ``"Enable"``: 所有的表中都提示数组索引。 +* ``"Auto"``: 只有表大于3项,或者表是混合类型时才进行提示。 +* ``"Disable"``: 禁用数组索引提示。 + ## default ```json @@ -544,9 +552,10 @@ string ## enum -* `"All"`: 所有类型的参数均进行提示。 -* `"Literal"`: 只有字面量类型的参数进行提示。 -* `"Disable"`: 禁用参数提示。 +* ``"All"``: 所有类型的参数均进行提示。 +* ``"Literal"``: 只有字面量类型的参数进行提示。 +* ``"Disable"``: 禁用参数提示。 + ## default ```json @@ -730,9 +739,10 @@ object<string, string> ## enum -* `"default"` -* `"enable"` -* `"disable"` +* ``"default"`` +* ``"enable"`` +* ``"disable"`` + ## default ```json @@ -767,10 +777,11 @@ string ## enum -* `"utf8"` -* `"ansi"` -* `"utf16le"` -* `"utf16be"` +* ``"utf8"`` +* ``"ansi"`` +* ``"utf16le"`` +* ``"utf16be"`` + ## default ```json @@ -803,6 +814,21 @@ string Array<string> ``` +## enum + +* ``"//"`` +* ``"/**/"`` +* ``"`"`` +* ``"+="`` +* ``"-="`` +* ``"*="`` +* ``"/="`` +* ``"||"`` +* ``"&&"`` +* ``"!"`` +* ``"!="`` +* ``"continue"`` + ## default ```json @@ -912,11 +938,12 @@ string ## enum -* `"Lua 5.1"` -* `"Lua 5.2"` -* `"Lua 5.3"` -* `"Lua 5.4"` -* `"LuaJIT"` +* ``"Lua 5.1"`` +* ``"Lua 5.2"`` +* ``"Lua 5.3"`` +* ``"Lua 5.4"`` +* ``"LuaJIT"`` + ## default ```json diff --git a/doc/zh-tw/config.md b/doc/zh-tw/config.md index ef7438c1..c5d16ebf 100644 --- a/doc/zh-tw/config.md +++ b/doc/zh-tw/config.md @@ -26,9 +26,10 @@ string ## enum -* `"Disable"`: 只顯示 `函式名`。 -* `"Both"`: 顯示 `函式名` 與 `呼叫片段`。 -* `"Replace"`: 只顯示 `呼叫片段`。 +* ``"Disable"``: 只顯示 `函式名`。 +* ``"Both"``: 顯示 `函式名` 與 `呼叫片段`。 +* ``"Replace"``: 只顯示 `呼叫片段`。 + ## default ```json @@ -79,9 +80,10 @@ string ## enum -* `"Disable"`: 只顯示 `關鍵字`。 -* `"Both"`: 顯示 `關鍵字` 與 `語法片段`。 -* `"Replace"`: 只顯示 `語法片段`。 +* ``"Disable"``: 只顯示 `關鍵字`。 +* ``"Both"``: 顯示 `關鍵字` 與 `語法片段`。 +* ``"Replace"``: 只顯示 `語法片段`。 + ## default ```json @@ -148,9 +150,10 @@ string ## enum -* `"Enable"`: 總是在建議中顯示上下文單詞。 -* `"Fallback"`: 無法根據語義提供建議時才顯示上下文單詞。 -* `"Disable"`: 不顯示上下文單詞。 +* ``"Enable"``: 總是在建議中顯示上下文單詞。 +* ``"Fallback"``: 無法根據語義提供建議時才顯示上下文單詞。 +* ``"Disable"``: 不顯示上下文單詞。 + ## default ```json @@ -249,9 +252,10 @@ string ## enum -* `"Enable"`: 總是診斷這些檔案。 -* `"Opened"`: 只有打開這些檔案時才會診斷。 -* `"Disable"`: 不診斷這些檔案。 +* ``"Enable"``: 總是診斷這些檔案。 +* ``"Opened"``: 只有打開這些檔案時才會診斷。 +* ``"Disable"``: 不診斷這些檔案。 + ## default ```json @@ -270,9 +274,10 @@ string ## enum -* `"Enable"`: 總是診斷這些檔案。 -* `"Opened"`: 只有打開這些檔案時才會診斷。 -* `"Disable"`: 不診斷這些檔案。 +* ``"Enable"``: 總是診斷這些檔案。 +* ``"Opened"``: 只有打開這些檔案時才會診斷。 +* ``"Disable"``: 不診斷這些檔案。 + ## default ```json @@ -294,9 +299,10 @@ object<string, string> ## enum -* `"Any"` -* `"Opened"` -* `"None"` +* ``"Any"`` +* ``"Opened"`` +* ``"None"`` + ## default ```json @@ -360,10 +366,11 @@ object<string, string> ## enum -* `"Error"` -* `"Warning"` -* `"Information"` -* `"Hint"` +* ``"Error"`` +* ``"Warning"`` +* ``"Information"`` +* ``"Hint"`` + ## default ```json @@ -491,9 +498,10 @@ string ## enum -* `"Enable"`: 所有的表中都提示陣列索引。 -* `"Auto"`: 只有表大於3項,或者表是混合型別時才進行提示。 -* `"Disable"`: 停用陣列索引提示。 +* ``"Enable"``: 所有的表中都提示陣列索引。 +* ``"Auto"``: 只有表大於3項,或者表是混合型別時才進行提示。 +* ``"Disable"``: 停用陣列索引提示。 + ## default ```json @@ -544,9 +552,10 @@ string ## enum -* `"All"`: 所有型別的參數均進行提示。 -* `"Literal"`: 只有字面常數型別的參數進行提示。 -* `"Disable"`: 停用參數提示。 +* ``"All"``: 所有型別的參數均進行提示。 +* ``"Literal"``: 只有字面常數型別的參數進行提示。 +* ``"Disable"``: 停用參數提示。 + ## default ```json @@ -730,9 +739,10 @@ object<string, string> ## enum -* `"default"` -* `"enable"` -* `"disable"` +* ``"default"`` +* ``"enable"`` +* ``"disable"`` + ## default ```json @@ -767,10 +777,11 @@ string ## enum -* `"utf8"` -* `"ansi"` -* `"utf16le"` -* `"utf16be"` +* ``"utf8"`` +* ``"ansi"`` +* ``"utf16le"`` +* ``"utf16be"`` + ## default ```json @@ -803,6 +814,21 @@ string Array<string> ``` +## enum + +* ``"//"`` +* ``"/**/"`` +* ``"`"`` +* ``"+="`` +* ``"-="`` +* ``"*="`` +* ``"/="`` +* ``"||"`` +* ``"&&"`` +* ``"!"`` +* ``"!="`` +* ``"continue"`` + ## default ```json @@ -912,11 +938,12 @@ string ## enum -* `"Lua 5.1"` -* `"Lua 5.2"` -* `"Lua 5.3"` -* `"Lua 5.4"` -* `"LuaJIT"` +* ``"Lua 5.1"`` +* ``"Lua 5.2"`` +* ``"Lua 5.3"`` +* ``"Lua 5.4"`` +* ``"LuaJIT"`` + ## default ```json diff --git a/tools/build-doc.lua b/tools/build-doc.lua index 28f29283..7fa56706 100644 --- a/tools/build-doc.lua +++ b/tools/build-doc.lua @@ -99,11 +99,12 @@ local function buildEnum(md, lang, conf) for i, enum in ipairs(conf.enum) do local desc = getDesc(lang, conf.markdownEnumDescriptions and conf.markdownEnumDescriptions[i]) if desc then - md:add('md', ('* `%s`: %s'):format(json.encode(enum), desc)) + md:add('md', ('* ``%s``: %s'):format(json.encode(enum), desc)) else - md:add('md', ('* `%s`'):format(json.encode(enum))) + md:add('md', ('* ``%s``'):format(json.encode(enum))) end end + md:emptyLine() return end @@ -115,14 +116,30 @@ local function buildEnum(md, lang, conf) for i, enum in ipairs(first.enum) do local desc = getDesc(lang, conf.markdownEnumDescriptions and conf.markdownEnumDescriptions[i]) if desc then - md:add('md', ('* `%s`: %s'):format(json.encode(enum), desc)) + md:add('md', ('* ``%s``: %s'):format(json.encode(enum), desc)) else - md:add('md', ('* `%s`'):format(json.encode(enum))) + md:add('md', ('* ``%s``'):format(json.encode(enum))) end end + md:emptyLine() return end end + + if conf.type == 'array' and conf.items.enum then + md:add('md', '## enum') + md:emptyLine() + for i, enum in ipairs(conf.items.enum) do + local desc = getDesc(lang, conf.markdownEnumDescriptions and conf.markdownEnumDescriptions[i]) + if desc then + md:add('md', ('* ``%s``: %s'):format(json.encode(enum), desc)) + else + md:add('md', ('* ``%s``'):format(json.encode(enum))) + end + end + md:emptyLine() + return + end end local function buildMarkdown(lang) |