Skip to content

MD Debugger and Error Handler v.2.6

Latest

Choose a tag to compare

@vladikcomper vladikcomper released this 15 Dec 12:02
· 8 commits to master since this release

- AXM68K, Psylink and GAS support, better assertions, compact error handler offsets and tons of QoL improvements!

Compact offsets Better assertions

MD Debugger 2.6 is finally out, including ~1.5 years worth of work, with tons of stability and QoL improvements! This release focuses on extending supported assemblers and improving the existing features: better asserts, compact offsets and displacements on error screens, KDebug integration is no longer experimental.

Feature highlights

  • Official AXM68K and GAS support (allows SGDK integration), support for ASM68K projects using Psy-Q Linker;
  • Error handler now uses compact offsets and symbol displacements: offsets are rendered as 24-bit instead of 32-bit and displacements don't have leading zeros (+000X is now +X);
  • Better assertions: you can now assign custom debuggers to failed assertions, assertion failed exception is improved and displays the received value;
  • KDebug integration is no longer experimental; you can use KDebug.Write[Line] in console programs;
  • Console.WriteLine, Console.Write, KDebug.WriteLine, KDebug.Write are now much faster when formatted string doesn't include any printable arguments;
  • Added _Console.*, _KDebug.*, _assert macros for advanced users ("shadow macros"): they behave like the original ones, but don't save/restore CCR as an optimization;
  • ASM68K version: Support projects that use "." for local labels, support projects with /o ae+ compile flag;
  • AS version: Support xxx.w, (xxx).w, xxx.l and (xxx).l syntax in formatted string arguments;
  • Many optimizations, bugfixes and stability improvements.

Special thanks to @OrionNavattan for contributing a few optimizations and bugfixes for this release.

See MD Debugger's version history for the detailed changelog.

Version 2.5 to 2.6 migration guide

If you were already using version 2.5, migration is as simple as upgrading your Debugger.asm and ErrorHandler.asm files from the bundle for your assembler and upgrading ConvSym utility. As usual, versions are 100% backwards-compatible.

  1. Download errorhandler-2.6.zip below;
  2. Inside this archive, find the directory that matches your assembler (e.g. asm68k for ASM68K, as for the AS Macro Assembler);
  3. Replace Debugger.asm and ErrorHandler.asm files in your projects with ones from that directory;
  4. Download convsym-2.12.1.zip, find executable for your platform (64-bit Windows or Linux) and replace one in your project;

Installation guides, documentation and help

MD Debugger comes with exhaustive documentation, installation guides and usage examples. See the following links for details: