Документация Lua Ldoc для таблицы

Question

Я хочу документировать таблицу с использованием Ldoc. documentation утверждает, что

Хорошо, это выглядит хорошо, но когда я применяю форматирование к моему столику:

--- A table of mappings between NodOn remote scene codes and a text description. 
nodonSceneTableVerbose = { 
    [10]="Button 1 Single Press", -- Button 1 Single Press 
    [20]="Button 2 Single Press", -- Button 2 Single Press 
    [30]="Button 3 Single Press", -- Button 3 Single Press 
    [40]="Button 4 Single Press", -- Button 4 Single Press 
    [13]="Button 1 Double Press", -- Button 1 Double Press 
    [23]="Button 2 Double Press", -- Button 2 Double Press 
    [33]="Button 3 Double Press", -- Button 3 Double Press 
    [43]="Button 4 Double Press", -- Button 4 Double Press 
    [12]="Button 1 Hold Press",  -- Button 1 Hold Press 
    [22]="Button 2 Hold Press",  -- Button 2 Hold Press 
    [32]="Button 3 Hold Press",  -- Button 3 Hold Press 
    [42]="Button 4 Hold Press",  -- Button 4 Hold Press 
    [11]="Button 1 Hold Released", -- Button 1 Hold Released 
    [21]="Button 2 Hold Released", -- Button 2 Hold Released 
    [31]="Button 3 Hold Released", -- Button 3 Hold Released 
    [41]="Button 4 Hold Released" -- Button 4 Hold Released 
} 

я получить этот результат

, который является не то, что я ожидал. Команда ldoc не вызывала ошибок. Что не так?

Answer 1

Таким образом, вы не можете использовать inferring more from code на таблицах, которые устанавливают элементы как [10] и т. Д. Вместо этого вы можете определить поля вручную следующим образом:

--- A table of mappings between NodOn remote scene codes and a text description. 
-- @table nodonSceneTableVerbose 
-- @field 10 Button 1 Single Press 
-- @field 20 Button 2 Single Press 
-- @field 30 Button 3 Single Press 
-- @field 40 Button 4 Single Press 
-- @field 13 Button 1 Double Press 
-- @field 23 Button 2 Double Press 
-- @field 33 Button 3 Double Press 
-- @field 43 Button 4 Double Press 
-- @field 12 Button 1 Hold Press 
-- @field 22 Button 2 Hold Press 
-- @field 32 Button 3 Hold Press 
-- @field 42 Button 4 Hold Press 
-- @field 11 Button 1 Hold Released 
-- @field 21 Button 2 Hold Released 
-- @field 31 Button 3 Hold Released 
-- @field 41 Button 4 Hold Released 
nodonSceneTableVerbose = { 
    [10]="Button 1 Single Press", 
    [20]="Button 2 Single Press", 
    [30]="Button 3 Single Press", 
    [40]="Button 4 Single Press", 
    [13]="Button 1 Double Press", 
    [23]="Button 2 Double Press", 
    [33]="Button 3 Double Press", 
    [43]="Button 4 Double Press", 
    [12]="Button 1 Hold Press", 
    [22]="Button 2 Hold Press", 
    [32]="Button 3 Hold Press", 
    [42]="Button 4 Hold Press", 
    [11]="Button 1 Hold Released", 
    [21]="Button 2 Hold Released", 
    [31]="Button 3 Hold Released", 
    [41]="Button 4 Hold Released" 
}