prog8/docs/source/todo.rst

====
TODO
====

- fix manderbrot compiler issue


- remove statements after an exit() or return
- fix warnings about that unreachable code?

- add a compiler option to not include variable initialization code (useful if the program is expected to run only once, such as a game)
  the program will then rely solely on the  values as they are in memory at the time of program startup.

- create real assembly routines for the bresenham line and circle code
- also add assembly routines in c64scr for drawing rectangles (filled/open)
- add these routines for bitmap screen modes as well
- add a turtle example once we have highres drawing routines

- aliases for imported symbols for example perhaps '%alias print = c64scr.print'
- option to load library files from a directory instead of the embedded ones


Memory Block Operations integrated in language?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

array/string memory block operations?

- vector inc/dec/add/sub/mul/div...?  (on array or string):
  ``arrayvar++ / arrayvar-- / arrayvar += 2 / arrayvar -= 2 / arrayvar *= 3 / arrayvar /= 3``

- array operations
  copy (from another array with the same length), shift-N(left,right), rotate-N(left,right)
  clear (set whole array to the given value, default 0)

- array operations ofcourse work identical on vars and on memory mapped vars of these types.

- strings: identical operations as on array.

For now, we have the ``memcopy`` and ``memset`` builtin functions.


More optimizations
^^^^^^^^^^^^^^^^^^

Add more compiler optimizations to the existing ones.

- on the language AST level
- on the final assembly source level
- can the parameter passing to subroutines be optimized to avoid copying?
- working subroutine inlining (taking care of vars and identifier refs to them)

Also some library routines and code patterns could perhaps be optimized further


Eval stack redesign? (lot of work)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The eval stack is now a split lsb/msb stack using X as the stackpointer.
Is it easier/faster to just use a single page unsplit stack?
It could then even be moved into the zeropage to greatly reduce code size and slowness.

Or just move the LSB portion into a slab of the zeropage.

Allocate a fixed word in ZP that is the TOS so we can always operate on TOS directly
without having to to index into the stack?


Bugs
^^^^
Ofcourse there are still bugs to fix ;)


Misc
^^^^

Several ideas were discussed on my reddit post
https://www.reddit.com/r/programming/comments/alhj59/creating_a_programming_language_and_cross/
new docs 2018-08-06 01:35:43 +00:00			`====`
			`TODO`
			`====`

fixed subroutine parameter value issue 2020-03-22 22:50:15 +00:00			`- fix manderbrot compiler issue`


added warning about sgn() of unsigned type 2020-03-14 20:09:34 +00:00			`- remove statements after an exit() or return`
			`- fix warnings about that unreachable code?`
Initial variable values semantics changed: now always sets value at program (re)start (except strings/arrays). This may change later by introducing a compiler option to choose a strategy, perhaps. 2020-03-22 14:12:26 +00:00
			`- add a compiler option to not include variable initialization code (useful if the program is expected to run only once, such as a game)`
			`the program will then rely solely on the values as they are in memory at the time of program startup.`
tweak error reporting, expanded lines and circles example 2020-03-21 23:43:46 +00:00
			`- create real assembly routines for the bresenham line and circle code`
			`- also add assembly routines in c64scr for drawing rectangles (filled/open)`
			`- add these routines for bitmap screen modes as well`
			`- add a turtle example once we have highres drawing routines`
added warning about sgn() of unsigned type 2020-03-14 20:09:34 +00:00
replaced typecastsAdder with version based on astwalker 2020-03-20 21:28:18 +00:00			`- aliases for imported symbols for example perhaps '%alias print = c64scr.print'`
added 'void' keyword to explicitly ignore subroutine return values (and no longer get a warning) 2020-02-09 00:21:23 +00:00			`- option to load library files from a directory instead of the embedded ones`
fixed while and repeat warning messages line number fixed invalid while and repeat asm label names fixed boolean checking of numbers 2020-02-08 18:45:30 +00:00

tweak error reporting, expanded lines and circles example 2020-03-21 23:43:46 +00:00


doc 2019-01-24 01:43:25 +00:00			`Memory Block Operations integrated in language?`
			`^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^`
new docs 2018-08-06 01:35:43 +00:00
doc 2019-08-18 12:18:46 +00:00			`array/string memory block operations?`
new docs 2018-08-06 01:35:43 +00:00
todo 2020-03-13 01:33:02 +00:00			`- vector inc/dec/add/sub/mul/div...? (on array or string):`
doc updates 2020-03-14 14:19:03 +00:00			``arrayvar++ / arrayvar-- / arrayvar += 2 / arrayvar -= 2 / arrayvar *= 3 / arrayvar /= 3``
todo 2020-03-13 01:33:02 +00:00
doc 2019-08-18 12:18:46 +00:00			`- array operations`
			`copy (from another array with the same length), shift-N(left,right), rotate-N(left,right)`
			`clear (set whole array to the given value, default 0)`
new docs 2018-08-06 01:35:43 +00:00
doc 2019-08-18 12:18:46 +00:00			`- array operations ofcourse work identical on vars and on memory mapped vars of these types.`
new docs 2018-08-06 01:35:43 +00:00
doc 2019-08-18 12:18:46 +00:00			`- strings: identical operations as on array.`
new docs 2018-08-06 01:35:43 +00:00
doc 2019-08-18 12:18:46 +00:00			For now, we have the ``memcopy`` and ``memset`` builtin functions.
new docs 2018-08-06 01:35:43 +00:00
doc 2019-01-24 01:43:25 +00:00
			`More optimizations`
			`^^^^^^^^^^^^^^^^^^`

			`Add more compiler optimizations to the existing ones.`

			`- on the language AST level`
			`- on the final assembly source level`
docs about gradle and building the compiler, fix shell build script 2019-01-29 22:32:43 +00:00			`- can the parameter passing to subroutines be optimized to avoid copying?`
doc tweaks 2019-08-11 08:44:58 +00:00			`- working subroutine inlining (taking care of vars and identifier refs to them)`
doc 2019-01-24 01:43:25 +00:00
			`Also some library routines and code patterns could perhaps be optimized further`

Expressions can now be split over multiple lines. Fixed datatype of len(). 2019-01-26 16:32:26 +00:00
docs about gradle and building the compiler, fix shell build script 2019-01-29 22:32:43 +00:00			`Eval stack redesign? (lot of work)`
			`^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^`

			`The eval stack is now a split lsb/msb stack using X as the stackpointer.`
			`Is it easier/faster to just use a single page unsplit stack?`
			`It could then even be moved into the zeropage to greatly reduce code size and slowness.`

			`Or just move the LSB portion into a slab of the zeropage.`

info 2019-08-11 16:21:15 +00:00			`Allocate a fixed word in ZP that is the TOS so we can always operate on TOS directly`
idea 2019-01-29 22:48:26 +00:00			`without having to to index into the stack?`


examples 2019-08-24 22:46:46 +00:00			`Bugs`
			`^^^^`
fixed some type cast compiler errors in for loops 2019-08-26 21:38:59 +00:00			`Ofcourse there are still bugs to fix ;)`
examples 2019-08-24 22:46:46 +00:00

fix some optimizations of loops, added some conditional branch optimizations 2019-01-27 18:14:58 +00:00			`Misc`
			`^^^^`

info 2019-08-11 16:21:15 +00:00			`Several ideas were discussed on my reddit post`
			`https://www.reddit.com/r/programming/comments/alhj59/creating_a_programming_language_and_cross/`