Skip to content

Changelog

Jump to bottom Edit New page
Lorenzi edited this page Jul 2, 2023 · 13 revisions

v0.13.2

  • Fixes certain errors not being caught by the assembler, one related to ruledef-typed parameters, and another one to asm blocks.

v0.13.1

  • Adds the conditional compilation directives #if, #elif, and #else.
  • Adds constant overwriting via the command-line with -d.
  • Makes it possible again to reference constants in #bankdef arguments.

v0.13.0

  • A complete internal overhaul, this version enables speed-ups of up to 7x for big projects.
  • You can now use alternative-style number literals anywhere, such as %0110 for binary literals, and $12abcd for hexadecimal literals.
  • You can specify multiple output formats for a single execution of the assembler, separated by --, such as customasm main.asm -f binary -o main.bin -- -f symbols -o symbols.txt.
  • Some format options have been extended with parameters, such as -f annotated,base:8,group:3.
  • You can now specify --color=off to disable colored output.
  • Breaking change: The usage of some directives has changed. #bits and #labelalign should now only appear inside a #bankdef definition. #noemit on should be replaced by something like #const(noemit) x = 0 at each affected constant declaration.

v0.12.0

  • Breaking change: Whitespace is now respected within rule patterns.
  • Adds the decspace and hexspace output formats.
  • Removed the old sized-literal syntax with a standard quotation mark 'X. New code should use backquote slices `X.

v0.11.14

v0.11.13

  • Adds the #once directive. Details here.
  • Adds string encoding conversion functions: utf8(), ascii(), utf16be(), utf16le(), utf32be(), and utf32le(). Details here.

v0.11.9

  • Makes it so the assembler will select the rule with the fewest amount of output bits in the case of multiple matches.
  • Adds the mesen-mlb symbol output format, for use with the Mesen NES emulator.

v0.11.8

  • Adds the built-in function le(), which reverses the bytes of an integer, essentially performing little-endian encoding. It's important that the argument be sized with a multiple of 8 bits. For example: le(0x1234) or le(65000`16). Details here.
  • Makes it so assembly won't stop at the first resolve error, which allows more errors to be caught in a single execution.
Add a custom footer

Changelog

  1. Getting started
  2. Defining mnemonics — #ruledef, #subruledef
  3. Declaring labels and constants
  4. Setting the minimum addressable unit — #bits
  5. Outputting data blocks — #d
  6. Working with banks — #bankdef, #bank
  7. Address manipulation directives — #addr, #align, #res
  8. Splitting your code into multiple files — #include, #once
  9. Advanced mnemonics, cascading, and deferred resolution — assert()
  10. Available expression operators and functions — incbin(), incbinstr(), inchexstr()
  11. Functions — #fn
  12. Conditional Compilation — #if, #elif, #else
Clone this wiki locally