Documentation Request: Core VM Operation Instructions in fift

[zqy-691001]

Description of the Issue:
Several core virtual machine operation instructions in the fift language, including (vmopdump), vmcont, vmcont@, and (vmoplen), are present in the core Fift library and its C++ implementation but are undocumented in the official Fift whitepaper or other official documentation. This lack of documentation can lead to confusion and hinder the ability of developers and users to understand and effectively use the fift language and its VM operations.

For example
(vmopdump)

Relevant Links:

• Core Fift library reference:

  ton/crypto/fift/lib/Disasm.fif

  Line 137 in eed3153

  { dup @cp @ (vmoplen) dup 0> { 65536 /mod swap sr@+ swap dup @cp @ (vmopdump) parse-op swap s> true } { drop false } cond } : fetch-one-op

• C++ source code:

  ton/crypto/fift/words.cpp

  Line 3414 in eed3153

  d.def_stack_word("(vmopdump) ", interpret_vmop_dump);

• Function implementation:

  ton/crypto/fift/words.cpp

  Line 2710 in eed3153

  void interpret_vmop_dump(vm::Stack& stack) {

Suggested Action:
It would be beneficial to include documentation for the(vmopdump) instruction in the official fift documentation to ensure clarity and ease of use for the community. The documentation should explain the purpose, usage, and any relevant details about the instruction.

Additional Information:

• I have verified that the instruction is not mentioned in the fift whitepaper or any official documentation.
• The implementation suggests that (vmopdump)is used for dumping VM operations and core with Disasm.fif, but without documentation, it's difficult to understand its full functionality and usage context.

Steps to Reproduce:

• N/A (This is a documentation request, not a bug report)

Expected Behavior:

• The(vmopdump)instruction should be documented in the official fift documentation.

Actual Behavior:

• The (vmopdump) instruction is undocumented.

Environment:

• Operating System: [kaili_linux]
• Version: [TON v2024.10]

Additional Comments:

• I believe that documenting this instruction will greatly improve the usability and understanding of the fift language for developers.

Modification Suggestions:
1.Add a New Section in the Fift Whitepaper:
Create a new text in the Fift whitepaper dedicated to the (vmopdump) instruction. This text should provide an overview of the instruction, its syntax, parameters, and output.
2.Include Detailed Usage Examples:
Provide one or more detailed usage examples that demonstrate how to use the (vmopdump) instruction effectively. These examples should cover typical use cases and edge cases.
Syntax:
(vmopdump) ( s cp -- s' dump )
s: The cell slice (vm::CellSlice) containing the VM instruction to be dumped.
cp: The code page identifier, an integer within the range of -0x80000000 to 0x7fffffff.
s': The remaining cell slice after the dumped instruction has been processed.
dump: A string representation of the dumped VM instruction.