Credit goes to Katsushimi for being the one to first figure this code out.

This is the same macro that has been in the Sonic 2 disassembly for years.

Also added an extra note to LevelOrder.asm

- Moved special stage start positions into startpos/Special Stages/
- Moved credits demos start positions into startpos/Credits Demos/
- Moved decompression algorithms into _inc/Decompression/
- Updated project files to accommodate
- Merged SBZ Palette Scripts.asm into PaletteCycle.asm
- Merged Start Location Array ASM files with LevelSizeLoad & BgScrollSpeed.asm (...why were these ever split to begin with?)
- Demystified LevSz_LoadScrollBlockSize and also did some other misc cleanup in LevelSizeLoad & BgScrollSpeed.asm

Any mentions of the old "JP1" have been removed. This disambiguation hopefully mitigates future confusions for beginners.

On a side note, it has been confirmed that REV01 was not exclusive to Japan (albeit it was most common market for that release).

Specifically, these:

; ||||||||||||||| S U B R O U T I N E |||||||||||||||||||||||||||||||||||||||

They were mostly pointless or redundant, sometimes even straight up misleading. But most of all, they were unsightly obstructions in the source code that made it harder to parse than aid.

Unlike Level Drawing or Deform Layers, this split never made much sense. This split only ever caused confusion because the two files are nearly identical.

Most of these were taken from the "Some changes/fixes for Sonic 1" thread on the Sonic Retro forums: https://forums.sonicretro.org/threads/some-changes-fixes-for-sonic-1.29751

I didn't implement all of them. Anything that leaned too far into a design choice or would require editing more than a handful of lines was skipped.

- Extracted subroutines (_inc): BuildSprites.asm, ExecuteObjects.asm, LevelLayoutLoad.asm, ObjPosLoad.asm, Palette Fading.asm, Special Stage Loading & Drawing.asm, Special Stage Background & Palette Cycle.asm,
- Extracted subroutines (_incObj): Sonic Collision.asm, sub AddPoints.asm, sub ConvertCollisionArray (Unused.asm), sub ExitPlatform.asm, sub PlatformObject.asm, sub ResumeMusic.asm
- Extracted all title cards mapping into a separate _maps/Title Cards.asm, included Game Over title cards. Also added a remark that this file cannot be altered in a sprite editor

- Merged previously multi-part files for Bridge, Swinging Platforms, and GHZ boss objects into single files (the one exception is Object 44, where both parts are so far apart that merging doesn't work). In-between shared subroutines have been annotated
- Grouped Palette bincludes together with the relevant files
- Extracted remaining Sonic collision logic and fixed/improved its label names
- Moved Ledge_Fragment and SlopeObject2 into Collapsing Floors object file, and smash fragments into sub SmashObject
- Moved stray object delete calls into relevant files
- Some miscellaneous code cleanup while I was at it

- Added proper labels for remaining entries that were still loc_ (mostly for bosses)
- Consistently use one index entry per line
- Minor documentation improvements on ending animals