feat: RUNVM/RUNVMX flag description

cp0.json

@@ -38140,7 +38140,7 @@
       },
       "doc": {
         "category": "cont_basic",
-        "description": "Runs child VM with code `code` and stack `x_1...x_n`. Returns the resulting stack `x'_1...x'_m` and exitcode. Other arguments and return values are enabled by flags.",
+        "description": "Runs child VM with code `code` and stack `x_1...x_n`. Returns the resulting stack `x'_1...x'_m` and exitcode. Other arguments and return values are enabled by flags.\n\nFlags operate similarly to `RUNVMX` in Fift:\n- `+1`: sets `c3` to code.\n- `+2`: pushes an implicit `0` before executing the code.\n- `+4`: takes persistent data `c4` from the stack and returns its final value.\n- `+8`: takes the gas limit `g_l` from the stack and returns the consumed gas `g_c`.\n- `+16`: takes `c7` (smart contract context) from the stack.\n- `+32`: returns the final value of `c5` (actions).\n- `+64`: pops the hard gas limit `g_m` enabled by `ACCEPT` from the stack.\n- `+128`: enables \"isolated gas consumption\", meaning the child VM maintains a separate set of visited cells and a `chksgn` counter.\n- `+256`: pops an integer `r` and ensures exactly `r` values are returned from the top of the stack:\n  - If `RUNVM` call succeeds and `r` is set, it returns `r` elements. If `r` is not set, it returns all available elements.\n  - If `RUNVM` is successful but lacks elements on the stack, meaning the stack depth is less than `r`, it is treated as an exception in the child VM. The `exit_code` is set to `-3`, and `exit_arg` is set to `0`, so `0` is returned as the only stack element.\n  - If `RUNVM` fails with an exception, only one element is returned, `exit_arg`, which should not be confused with `exit_code`.\n  - In the case of running out of gas, `exit_code` is set to `-14`, and `exit_arg` contains the amount of gas.\n\nGas cost:\n- 66 gas;\n- 1 gas for each stack element passed to the child VM (the first 32 elements are free);\n- 1 gas for each stack element returned from the child VM (the first 32 elements are free).",
         "fift": "flags RUNVM",
         "fift_examples": [],
         "gas": "74",
@@ -38178,7 +38178,7 @@
       },
       "doc": {
         "category": "cont_basic",
-        "description": "Runs child VM with code `code` and stack `x_1...x_n`. Returns the resulting stack `x'_1...x'_m` and exitcode. Other arguments and return values are enabled by flags.",
+        "description": "Runs child VM with code `code` and stack `x_1...x_n`. Returns the resulting stack `x'_1...x'_m` and exitcode. Other arguments and return values are enabled by flags.\n\nFlags operate similarly to `RUNVMX` in Fift:\n- `+1`: sets `c3` to code.\n- `+2`: pushes an implicit `0` before executing the code.\n- `+4`: takes persistent data `c4` from the stack and returns its final value.\n- `+8`: takes the gas limit `g_l` from the stack and returns the consumed gas `g_c`.\n- `+16`: takes `c7` (smart contract context) from the stack.\n- `+32`: returns the final value of `c5` (actions).\n- `+64`: pops the hard gas limit `g_m` enabled by `ACCEPT` from the stack.\n- `+128`: enables \"isolated gas consumption\", meaning the child VM maintains a separate set of visited cells and a `chksgn` counter.\n- `+256`: pops an integer `r` and ensures exactly `r` values are returned from the top of the stack:\n  - If `RUNVM` call succeeds and `r` is set, it returns `r` elements. If `r` is not set, it returns all available elements.\n  - If `RUNVM` is successful but lacks elements on the stack, meaning the stack depth is less than `r`, it is treated as an exception in the child VM. The `exit_code` is set to `-3`, and `exit_arg` is set to `0`, so `0` is returned as the only stack element.\n  - If `RUNVM` fails with an exception, only one element is returned, `exit_arg`, which should not be confused with `exit_code`.\n  - In the case of running out of gas, `exit_code` is set to `-14`, and `exit_arg` contains the amount of gas.\n\nGas cost:\n- 66 gas;\n- 1 gas for each stack element passed to the child VM (the first 32 elements are free);\n- 1 gas for each stack element returned from the child VM (the first 32 elements are free).",
         "fift": "RUNVMX",
         "fift_examples": [],
         "gas": "66",