mirror of
https://github.com/irmen/prog8.git
synced 2024-06-29 11:29:29 +00:00
doc tweaks
This commit is contained in:
parent
eba0bde6f3
commit
43944a94eb
|
@ -172,21 +172,21 @@ Required additional tools
|
||||||
It's easy to compile yourself, but a recent precompiled .exe (only for Windows) can be obtained from
|
It's easy to compile yourself, but a recent precompiled .exe (only for Windows) can be obtained from
|
||||||
`the files section <https://sourceforge.net/projects/tass64/files/binaries/>`_ in the official project on sourceforge.
|
`the files section <https://sourceforge.net/projects/tass64/files/binaries/>`_ in the official project on sourceforge.
|
||||||
*You need at least version 1.58.0 of this assembler.*
|
*You need at least version 1.58.0 of this assembler.*
|
||||||
If you are on a Debian based Linux, there's a "64tass" package in the repositories, which is a bit old, but it seems to work.
|
If you are on Linux, there's probably a "64tass" package in the repositories, but check if it is a recent enough version.
|
||||||
It might be possible to use old versions of 64tass, but it is likely that you'll run into assembler errors later.
|
|
||||||
|
|
||||||
A **Java runtime (jre or jdk), version 11 or newer** is required to run the prog8 compiler itself.
|
A **Java runtime (jre or jdk), version 11 or newer** is required to run the prog8 compiler itself.
|
||||||
If you're scared of Oracle's licensing terms, most Linux distributions ship OpenJDK or similar in their packages repository instead.
|
If you're scared of Oracle's licensing terms, get one of the versions of another vendor. Even Microsoft provides their own version.
|
||||||
For Windows it's possible to get that as well; check out `Adoptium <https://adoptium.net/temurin/releases/?version=11>`_ .
|
Other OpenJDK builds can be found at `Adoptium <https://adoptium.net/temurin/releases/?version=11>`_ .
|
||||||
For MacOS you can use the Homebrew system to install a recent version of OpenJDK.
|
For MacOS you can also use the Homebrew system to install a recent version of OpenJDK.
|
||||||
|
|
||||||
Finally: an **emulator** (or a real machine of course) to test and run your programs on.
|
Finally: an **emulator** (or a real machine of course) to test and run your programs on.
|
||||||
In C64 mode, the compiler assumes the presence of the `VICE emulator <http://vice-emu.sourceforge.net/>`_.
|
For the PET, C64 and C128 targets, the compiler assumes the presence of the `VICE emulator <http://vice-emu.sourceforge.net/>`_.
|
||||||
If you're targeting the Commander X16 instead,
|
If you're targeting the Commander X16 instead,
|
||||||
download a recent emulator version for the CommanderX16, such as `x16emu <https://cx16forum.com/forum/viewforum.php?f=30>`_
|
download a recent emulator version for the CommanderX16, such as `x16emu <https://cx16forum.com/forum/viewforum.php?f=30>`_
|
||||||
(preferred, this is the official emulator. If required, source code is `here <https://github.com/X16Community/x16-emulator/>`_.
|
(preferred, this is the official emulator. If required, source code is `here <https://github.com/X16Community/x16-emulator/>`_.
|
||||||
There is also `Box16 <https://github.com/indigodarkwolf/box16>`_ which has powerful debugging features.
|
There is also `Box16 <https://github.com/indigodarkwolf/box16>`_ which has powerful debugging features.
|
||||||
You can select which one you want to launch using the ``-emu`` or ``-emu2`` command line options.
|
For the Atari target, it assumes the "atari800" or "altirra" emulator.
|
||||||
|
If multiple options are listed above, you can select which one you want to launch using the ``-emu`` or ``-emu2`` command line options.
|
||||||
|
|
||||||
**Syntax highlighting:** for a few different editors, syntax highlighting definition files are provided.
|
**Syntax highlighting:** for a few different editors, syntax highlighting definition files are provided.
|
||||||
Look in the `syntax-files <https://github.com/irmen/prog8/tree/master/syntax-files>`_ directory in the github repository to find them.
|
Look in the `syntax-files <https://github.com/irmen/prog8/tree/master/syntax-files>`_ directory in the github repository to find them.
|
||||||
|
|
|
@ -324,8 +324,6 @@ point variables. This includes ``print_f``, the routine used to print floating
|
||||||
|
|
||||||
``cos (x)``
|
``cos (x)``
|
||||||
Cosine.
|
Cosine.
|
||||||
If you want a fast integer cosine, have a look at examples/cx16/sincos.p8
|
|
||||||
that contains various lookup tables generated by the 64tass assembler.
|
|
||||||
|
|
||||||
``deg (x)``
|
``deg (x)``
|
||||||
Radians to degrees.
|
Radians to degrees.
|
||||||
|
@ -364,8 +362,6 @@ point variables. This includes ``print_f``, the routine used to print floating
|
||||||
|
|
||||||
``sin (x)``
|
``sin (x)``
|
||||||
Sine.
|
Sine.
|
||||||
If you want a fast integer sine, have a look at examples/cx16/sincos.p8
|
|
||||||
that contains various lookup tables generated by the 64tass assembler.
|
|
||||||
|
|
||||||
``tan (x)``
|
``tan (x)``
|
||||||
Tangent.
|
Tangent.
|
||||||
|
|
|
@ -2,6 +2,15 @@
|
||||||
TODO
|
TODO
|
||||||
====
|
====
|
||||||
|
|
||||||
|
- 'audio' or 'kaudio' or 'romutils' to contain prog8 definitions for the rom bank 10 audio routines
|
||||||
|
and a wrapper to call x16edit with costomization
|
||||||
|
|
||||||
|
- verafx vram-vram copy routine?
|
||||||
|
set the cache fill and cache write bits in fx ctrl, set one data port's increment to 1 and the other one to 4,
|
||||||
|
Assuming your writes are aligned to 32-bit boundaries, do four reads from the increment-1 port
|
||||||
|
(ex: lda DATA1 ; 4 times) and then stz the other one (stz DATA0).
|
||||||
|
The cache is loaded by the DATA1 reads, and the contents are written out with the DATA0 write, 4 bytes at once.
|
||||||
|
|
||||||
- [on branch: call-pointers] allow calling a subroutine via a pointer variable (indirect JSR, optimized form of callfar())
|
- [on branch: call-pointers] allow calling a subroutine via a pointer variable (indirect JSR, optimized form of callfar())
|
||||||
modify programs (shell, paint) that now use callfar
|
modify programs (shell, paint) that now use callfar
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue
Block a user