macros are not deprecated anymore, removed notes and tasks accordingly

This commit is contained in:
sejo 2024-04-26 19:51:24 +02:00
parent d999030fde
commit d878f552f0
2 changed files with 2 additions and 21 deletions

View File

@ -29,24 +29,7 @@ contributions are welcome! some of these issues were managed or identified durin
### pending
* remove square brackets in devices
* update images (to do: emulator needs a patch)
### in order to remove macros
this is an overview of how macros are used and what would be needed to replace them.
* in {uxn tutorial day 1} they are deeply embedded as a learning block, so they need some rewriting
* in {uxn tutorial day 2} they are used to increment coordinates and repeat the drawing of pixels or sprites. Replace with auto byte? (note that it's introduced until {uxn tutorial day 6})
* in {uxn tutorial day 2} we also have them as example for HALF and HALF2.
* in {uxn tutorial day 2} introduce the use of zero-page labels as constants.
```
|40 @color-clear
( and then use it as .color-clear )
```
* in {uxn tutorial day 3} we talk about a ?ASCII-DIGIT macro
* there are some macros from {uxn tutorial day 4} and onwards that are used as constants: replace them with zero-page labels!
* in {uxn tutorial day 4} we introduce MOD, 8MOD, TO-SHORT
* in {uxn tutorial day 5} we re-work MOD
* in {uxn tutorial day 6} we use constants, and HALF, DOUBLE
* it could happen that some wording regarding macros being deprecated is still present somewhere
### further possible changes
* make a folder of examples

View File

@ -497,9 +497,7 @@ we can call macros inside macros, for example:
%NL { #0a EMIT } ( -- )
```
note that macros are a helpful way of grouping and reusing code, especially when beginning to learn uxntal. for more advanced uses, macros are replaced by other strategies.
for that reason, some uxntal assemblers like the one in Uxntal Playground, don't allow their use.
note that macros are a helpful way of grouping and reusing code, especially when beginning to learn uxntal. for more advanced uses, macros can be replaced by other strategies.
# a more idiomatic hello world