Tools and Documentation

[Ratstail91]

(Original outline is at #126)

Documentation:

• v2 documentation

Debugging tools:

• pretty-print the AST
• pretty-print the bytecode
• pretty-print the structures
• optimiser that can rework an existing AST
• VSCode syntax highlighting

Optimisations applied to the AST:

• literal folding
• raw string concat
• grouping removal
• string duplication (see String reuse in the bytecode #168)
• removing excess scopes
• always-true and always-false conditionals

[Ratstail91]

Disassembler

A tool for picking apart the bytecode, and displaying the data at the opcode level.

This might be my next task, as disassembling around 100 bytes by hand took multiple hours. Going forward, there will be more and more complexity, so it'll save a lot of time and brain power.

The output would likely resemble this:

https://github.com/Ratstail91/Toy/blob/23eb3e45df685fcd65d44787b590f1879e886041/.notes/disassembly.txt

[Ratstail91]

The branch v2-docs is now being pushed to a mirror repo for deployment, and is visible at https://v2.toylang.com/

I'll start on writing the docs properly - likely as the next step.

[Ratstail91]

I dumped some of my thought processes in the commit message of 002651f.

[Ratstail91]

Can I move CONTRIBUTING.md to the website?

[Ratstail91]

I've swapped the v1 and v2 doc sites, now v1 is mirrored to v1.toylang.com, ans v2 ia puahed directly to toylang.com.

I might rebuild the theme from scratch, idk.