Merge branch 'master' into max-fields-count

Author: halflifefan

.vscode/launch.json

@@ -26,7 +26,7 @@
 			"type": "lua",
 			"request": "attach",
 			"stopOnEntry": false,
-			"address": "127.0.0.1:11413",
+			"address": "127.0.0.1:11414",
 			"outputCapture": [
 			],
 			"sourceFormat": "string",

changelog.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 <!-- Add all new changes here. They will be moved under a version at release -->
+* `NEW` Support Lua 5.5
 * `FIX` Incorrect generation of function signatures with tuple-parameters
 * `NEW` Doc output now contains file paths for `@alias` and `@enum` types
 * `FIX` Typos in a few error messages.

locale/en-us/meta.lua

@@ -15,22 +15,58 @@ cgopt.restart       =
 cgopt.count         =
 'Returns the total memory in Kbytes.'
 cgopt.step          =
-'Performs a garbage-collection step.'
+[[
+Performs a garbage-collection step. This option may be followed by an integer `size`.
+If `size` is a positive n, the collector acts as if n new bytes have been allocated; if `size` is zero, the collector performs a basic step.
+In incremental mode, a basic step corresponds to the current step size; in generational mode, a basic step performs a full minor collection,
+or an incremental step if the collector has scheduled one.
+In incremental mode, the function returns `true` if the step finished a collection cycle; in generational mode, it returns `true` if the step finished a major collection.
+]]
 cgopt.setpause      =
 'Set `pause`.'
 cgopt.setstepmul    =
 'Set `step multiplier`.'
 cgopt.incremental   =
-'Change the collector mode to incremental.'
+'Changes the collector mode to incremental and returns the previous mode (either `"generational"` or `"incremental"`).'
 cgopt.generational  =
-'Change the collector mode to generational.'
+'Changes the collector mode to generational and returns the previous mode (either `"generational"` or `"incremental"`).'
 cgopt.param         =
-'Changes and/or retrieves the values of a parameter of the collector. This option must be followed by one or two extra arguments: The name of the parameter and an optional new value.'
+[[
+Changes and/or retrieves the values of a collector parameter. This option must be followed by one or two extra arguments:
+the parameter name (a string) and an optional new value (an integer in the range [0,100000]).
+The call always returns the previous value of the parameter; if no new value is given, the value is left unchanged.
+Lua stores these values in a compressed format, so the value returned as the previous value may not be exactly the last value set.
+]]
+
+gcparam.minormul    =
+'The minor multiplier.'
+gcparam.majorminor  =
+'The major-minor multiplier.'
+gcparam.minormajor  =
+'The minor-major multiplier.'
+gcparam.pause       =
+'The garbage-collector pause.'
+gcparam.stepmul     =
+'The step multiplier.'
+gcparam.stepsize    =
+'The step size.'
+
 cgopt.isrunning     =
 'Returns whether the collector is running.'
 
 collectgarbage      =
-'This function is a generic interface to the garbage collector. It performs different functions according to its first argument, `opt`.'
+[[
+Generic interface to the garbage collector. According to the first argument `opt`, it performs:
+• `"collect"`: Performs a full garbage-collection cycle (default option).
+• `"stop"`: Stops automatic execution of the collector; it runs only when explicitly invoked, until `"restart"`.
+• `"restart"`: Restarts automatic execution of the collector.
+• `"count"`: Returns the total memory in use by Lua in Kbytes (fractional; multiply by 1024 for bytes).
+• `"step"`: Performs a garbage-collection step; optional integer `size` controls behavior and return value (see `cgopt.step`).
+• `"isrunning"`: Returns whether the collector is running (i.e., not stopped).
+• `"incremental"`: Changes the mode to incremental and returns the previous mode.
+• `"generational"`: Changes the mode to generational and returns the previous mode.
+• `"param"`: Changes/reads collector parameters (see `gcparam.*`), always returns the previous value.
+]]
 
 dofile              =
 'Opens the named file and executes its content as a Lua chunk. When called without arguments, `dofile` executes the content of the standard input (`stdin`). Returns all values returned by the chunk. In case of errors, `dofile` propagates the error to its caller. (That is, `dofile` does not run in protected mode.)'

locale/en-us/script.lua

@@ -237,12 +237,18 @@ PARSER_MISS_EXPONENT    =
 'Missed digits for the exponent.'
 PARSER_MISS_EXP         =
 '<exp> expected.'
+PARSER_MISS_LOOP_MIN    =
+'Missing start value of the loop.'
+PARSER_MISS_LOOP_MAX    =
+'Missing limit value of the loop.'
 PARSER_MISS_FIELD       =
 '<field> expected.'
 PARSER_MISS_METHOD      =
 '<method> expected.'
 PARSER_ARGS_AFTER_DOTS  =
 '`...` should be the last arg.'
+PARSER_UNSUPPORT_NAMED_VARARG =
+'`(...name)` syntax is supported in {version}.'
 PARSER_KEYWORD          =
 '<keyword> cannot be used as name.'
 PARSER_EXP_IN_ACTION    =
@@ -317,6 +323,8 @@ PARSER_LOCAL_LIMIT        =
 'Only 200 active local variables and upvalues can be existed at the same time.'
 PARSER_VARIABLE_NOT_DECLARED =
 'Variable `{name}` is not declared. (Use `global *` to allow undefined variables, or declare it with `global {name}`)'
+PARSER_ENV_IS_GLOBAL         =
+'_ENV is global when accessing variable `{name}`.'
 PARSER_ASSIGN_CONST_GLOBAL   =
 'Cannot assign to const global variable `{name}`.'
 PARSER_LUADOC_MISS_CLASS_NAME           =

locale/es-419/meta.lua

@@ -15,22 +15,58 @@ cgopt.restart       =
 cgopt.count         =
 'Retorna el total de memoria en Kbytes.'
 cgopt.step          =
-'Realiza un paso de recolección de basura.'
+[[
+Realiza un paso de recolección de basura. Esta opción puede seguirse por un entero `size`.
+Si `size` es un n positivo, el recolector actúa como si se hubieran asignado n nuevos bytes; si `size` es cero, realiza un paso básico.
+En modo incremental, un paso básico corresponde al tamaño de paso actual; en modo generacional, un paso básico realiza una recolección menor completa,
+o un paso incremental si el recolector ha agendado uno.
+En modo incremental, la función retorna `true` si el paso terminó un ciclo de recolección; en modo generacional, retorna `true` si el paso terminó una recolección mayor.
+]]
 cgopt.setpause      =
 'Establece la pausa.'
 cgopt.setstepmul    =
 'Establece el multiplicador para el paso de recolección de basura.'
 cgopt.incremental   =
-'Cambia el modo de recolección a incremental.'
+'Cambia el modo del recolector a incremental y retorna el modo anterior (sea `"generational"` o `"incremental"`).'
 cgopt.generational  =
-'Cambia el modo de recolección a generacional.'
+'Cambia el modo del recolector a generacional y retorna el modo anterior (sea `"generational"` o `"incremental"`).'
 cgopt.param         =
-'Cambia y/o recupera los valores de un parámetro del recolector. Esta opción debe ser seguida por uno o dos argumentos extra: El nombre del parámetro y un nuevo valor opcional.'
+[[
+Cambia y/o recupera los valores de un parámetro del recolector. Esta opción debe ir seguida de uno o dos argumentos adicionales:
+el nombre del parámetro (una cadena) y un nuevo valor opcional (un entero en el rango [0,100000]).
+La llamada siempre retorna el valor anterior del parámetro; si no se da un nuevo valor, el valor se mantiene sin cambios.
+Lua almacena estos valores en un formato comprimido, por lo que el valor retornado como anterior puede no ser exactamente el último valor establecido.
+]]
+
+gcparam.minormul    =
+'El multiplicador menor.'
+gcparam.majorminor  =
+'El multiplicador mayor-menor.'
+gcparam.minormajor  =
+'El multiplicador menor-mayor.'
+gcparam.pause       =
+'La pausa del recolector de basura.'
+gcparam.stepmul     =
+'El multiplicador de paso.'
+gcparam.stepsize    =
+'El tamaño del paso.'
+
 cgopt.isrunning     =
 'Retorna si el recolector está corriendo.'
 
 collectgarbage      =
-'Esta función es una interfaz genérica al recolector de basura. Realiza diferentes funcionalidades según su primer argumento `opt`'
+[[
+Interfaz genérica al recolector de basura. Según el primer argumento `opt`, realiza:
+• `"collect"`: Realiza un ciclo completo de recolección de basura (opción predeterminada).
+• `"stop"`: Detiene la ejecución automática; el recolector corre sólo cuando se invoca explícitamente, hasta `"restart"`.
+• `"restart"`: Reinicia la ejecución automática.
+• `"count"`: Retorna la memoria total usada por Lua en Kbytes (fraccionario; multiplique por 1024 para bytes).
+• `"step"`: Realiza un paso de recolección; entero opcional `size` controla el comportamiento y el retorno (vea `cgopt.step`).
+• `"isrunning"`: Retorna si el recolector está corriendo (es decir, no detenido).
+• `"incremental"`: Cambia el modo a incremental y retorna el modo anterior.
+• `"generational"`: Cambia el modo a generacional y retorna el modo anterior.
+• `"param"`: Cambia/lee parámetros del recolector (vea `gcparam.*`), siempre retorna el valor anterior.
+]]
 
 dofile              =
 'Abre el archivo mencionado y ejecuta su contenido como un bloque Lua. Cuando es llamada sin argumentos, `dofile` ejecuta el contenido de la entrada estándar (`stdin`). Retorna todos los valores retornado por el bloque. En caso de error `dofile` propaga el error a la función que la llama. (Eso sí, `dofile` no corre en modo protegido.)'

locale/es-419/script.lua

@@ -231,12 +231,18 @@ PARSER_MISS_EXPONENT    =
 'Faltan los dígitos para el exponente.'
 PARSER_MISS_EXP         =
 'Se esperaba <exp>.'
+PARSER_MISS_LOOP_MIN    =
+'Falta el valor inicial del bucle.'
+PARSER_MISS_LOOP_MAX    =
+'Falta el valor límite del bucle.'
 PARSER_MISS_FIELD       =
 'Se esperaba <field>.'
 PARSER_MISS_METHOD      =
 'Se esperaba <method>.'
 PARSER_ARGS_AFTER_DOTS  =
 '`...` should be the last arg.'
+PARSER_UNSUPPORT_NAMED_VARARG =
+'La sintaxis `(...name)` es compatible con {version}.'
 PARSER_KEYWORD          =
 '<keyword> cannot be used as name.'
 PARSER_EXP_IN_ACTION    =
@@ -311,6 +317,8 @@ PARSER_LOCAL_LIMIT        =
 'Solo 200 variables locales activas y valores anteriores pueden existir al mismo tiempo.'
 PARSER_VARIABLE_NOT_DECLARED =
 'Variable `{name}` no está declarada. (Use `global *` para permitir variables indefinidas, o declárela con `global {name}`)'
+PARSER_ENV_IS_GLOBAL         =
+'_ENV es global al acceder a la variable `{name}`.'
 PARSER_ASSIGN_CONST_GLOBAL   =
 'No se puede asignar a la variable global constante `{name}`.'
 PARSER_LUADOC_MISS_CLASS_NAME          =

locale/ja-jp/meta.lua

@@ -15,22 +15,58 @@ cgopt.restart       =
 cgopt.count         =
 '利用されているメモリ量の合計をキロバイト単位で返す。'
 cgopt.step          =
-'ガベージコレクションのステップを実行する。'
+[[
+ガベージコレクションのステップを実行します。このオプションの後には整数 `size` を付けることができます。
+`size` が正の n の場合、コレクタは n バイトが新たに割り当てられたかのように動作します。`size` が 0 の場合、基本ステップを実行します。
+インクリメンタルモードでは、基本ステップは現在のステップサイズに対応します。世代別モードでは、基本ステップは完全なマイナー収集、
+またはコレクタがインクリメンタルステップを予定している場合はそのインクリメンタルステップを実行します。
+インクリメンタルモードでは、ステップが収集サイクルを完了した場合に `true` を返します。世代別モードでは、ステップがメジャー収集を完了した場合に `true` を返します。
+]]
 cgopt.setpause      =
 '`pause` の値を設定する。'
 cgopt.setstepmul    =
 '`step multiplier` の値を設定する。'
 cgopt.incremental   =
-'ガベージコレクションのモードをインクリメンタルに変更する。'
+'モードをインクリメンタルに変更し、以前のモード（`"generational"` または `"incremental"`）を返します。'
 cgopt.generational  =
-'ガベージコレクションのモードを世代別に変更する。'
+'モードを世代別に変更し、以前のモード（`"generational"` または `"incremental"`）を返します。'
 cgopt.param         =
-'コレクターのパラメータの値を変更・取得する。この選択肢の後には1つまたは2つの追加引数が必要：パラメータ名と新しい値（オプション）。'
+[[
+コレクタのパラメータの値を変更／取得します。このオプションの後には 1 つまたは 2 つの追加引数が必要です：
+対象パラメータ名（文字列）と、オプションの新しい値（[0,100000] の範囲の整数）。
+呼び出しは常にそのパラメータの「以前の値」を返します。新しい値が与えられない場合、値は変更されません。Lua はこれらの値を圧縮形式で保存するため、
+返される以前の値は最後に設定された値と完全には一致しない場合があります。
+]]
+
+gcparam.minormul    =
+'マイナー乗数。'
+gcparam.majorminor  =
+'メジャー・マイナー乗数。'
+gcparam.minormajor  =
+'マイナー・メジャー乗数。'
+gcparam.pause       =
+'ガベージコレクターの一時停止。'
+gcparam.stepmul     =
+'ステップ乗数。'
+gcparam.stepsize    =
+'ステップサイズ。'
+
 cgopt.isrunning     =
 'ガベージコレクションが実行中かどうかを返す。'
 
 collectgarbage      =
-'この関数はガベージコレクション機能への汎用的なインターフェース。第一引数 `opt` に応じて異なる操作を実行する。'
+[[
+ガベージコレクタへの汎用インターフェース。第1引数 `opt` によって次を実行します：
+• `"collect"`: 完全なガベージコレクションサイクルを実行（デフォルト）。
+• `"stop"`: コレクタの自動実行を停止；`"restart"` まで明示的に呼び出したときのみ実行。
+• `"restart"`: コレクタの自動実行を再開。
+• `"count"`: Lua が使用しているメモリ総量を KBytes で返す（小数あり；1024 を掛けるとバイト数）。
+• `"step"`: ガベージコレクションのステップを実行；整数 `size` により動作と戻り値が制御される（`cgopt.step` 参照）。
+• `"isrunning"`: コレクタが実行中かどうか（停止されていないか）を返す。
+• `"incremental"`: インクリメンタルモードに変更し、以前のモードを返す。
+• `"generational"`: 世代別モードに変更し、以前のモードを返す。
+• `"param"`: コレクタのパラメータを変更／取得（`gcparam.*` 参照）。常に以前の値を返す。
+]]
 
 dofile              =
 '指定されたファイルを開き、その内容をLuaチャンクとして実行する。引数が指定されなかった場合、標準入力（`stdin`）の内容を実行する。チャンクによって返されたすべての値を返す。エラーが発生した場合、そのエラーが呼び出し元まで伝播される（つまり、`dofile` は保護モードでは実行されない）。'

locale/ja-jp/script.lua

@@ -233,12 +233,18 @@ PARSER_MISS_EXPONENT    =
 '指数部が不足しています。'
 PARSER_MISS_EXP         =
 '式が不足しています。'
+PARSER_MISS_LOOP_MIN    =
+'ループの開始値が不足しています。'
+PARSER_MISS_LOOP_MAX    =
+'ループの終了値が不足しています。'
 PARSER_MISS_FIELD       =
 'フィールド/プロパティ名が不足しています。'
 PARSER_MISS_METHOD      =
 'メソッド名が不足しています。'
 PARSER_ARGS_AFTER_DOTS  =
 '`...` は最後の引数でなければなりません。'
+PARSER_UNSUPPORT_NAMED_VARARG =
+'`(...name)` 構文は {version} でサポートされています。'
 PARSER_KEYWORD          =
 'キーワードは名前として使用できません。'
 PARSER_EXP_IN_ACTION    =
@@ -313,6 +319,8 @@ PARSER_LOCAL_LIMIT        =
 '同時に存在できるローカル変数とアップバリューの数は200個までです。'
 PARSER_VARIABLE_NOT_DECLARED =
 '変数 `{name}` は宣言されていません。（`global *` を使用して未定義の変数を許可するか、`global {name}` で宣言してください）'
+PARSER_ENV_IS_GLOBAL         =
+'変数 `{name}` にアクセスする際、_ENV がグローバル変数です。'
 PARSER_ASSIGN_CONST_GLOBAL   =
 '定数グローバル変数 `{name}` に代入できません。'
 PARSER_LUADOC_MISS_CLASS_NAME           =