Uxnfor is a formatter for Uxntal.

The formatter expects the standard Uxntal Notation, sometimes called Drifblim-style.

• Struct labels are capitalized.
• Source is indented with tabulators.
• Comments that should be on their own line begin with a ( | pipe ).
• Names of routines that are emitting are <wrapped> inside angle brackets.
• Subroutines definitions without an stack effect will be left inlined
• Tokens inside square brackets will be formatted as blocks of binary data.
• The zero-page is indicated by |000, the one-page is indicated by |100.
• Local forward references are indicated by &>loop for nesting.
• Routines that fall through to the next one end with ( >> ).

If a routine is printing, drawing, or sometimes ingesting all of its arguments, the routine can be wrapped within angular brackets to indicate that it should end a line.

@<emit-num> ( num* -- )
	LIT "0 ADD .Console/write DEO JMP2r

If a label should not be accessed from outside its scope, it is indicated by the &+name convention.

@scope/get-value ( -- value )
	[ LIT &+value $1 ] JMP2r

@scope/set-value ( value -- )
	,&+value STR JMP2r

@main ( -> )
	;scope/+value LDA ( uxnlin will throw a warning )
	POP BRK

Block widths can be specified by using a number next with the opening bracket:

@three-items-wide [3
	a b c
	d e f
	g h i ]
	
@four-items-wide [4
	a b c e
	d e f g 
	h i ]

• Source, Uxntal

incoming: uxntal notation uxntal software 2024