diff --git a/docs/source/index.rst b/docs/source/index.rst
index ed39682e0..ed4ad104e 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -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
 `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.*
-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.
-It might be possible to use old versions of 64tass, but it is likely that you'll run into assembler errors later.
+If you are on Linux, there's probably a "64tass" package in the repositories, but check if it is a recent enough version.
 
 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.
-For Windows it's possible to get that as well; check out `Adoptium <https://adoptium.net/temurin/releases/?version=11>`_ .
-For MacOS you can use the Homebrew system to install a recent version of OpenJDK.
+If you're scared of Oracle's licensing terms, get one of the versions of another vendor. Even Microsoft provides their own version.
+Other OpenJDK builds can be found at `Adoptium <https://adoptium.net/temurin/releases/?version=11>`_ .
+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.
-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,
 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/>`_.
 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.
 Look in the `syntax-files <https://github.com/irmen/prog8/tree/master/syntax-files>`_ directory in the github repository to find them.
diff --git a/docs/source/libraries.rst b/docs/source/libraries.rst
index 187db6543..31966337a 100644
--- a/docs/source/libraries.rst
+++ b/docs/source/libraries.rst
@@ -324,8 +324,6 @@ point variables.  This includes ``print_f``, the routine used to print floating
 
 ``cos (x)``
     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)``
     Radians to degrees.
@@ -364,8 +362,6 @@ point variables.  This includes ``print_f``, the routine used to print floating
 
 ``sin (x)``
     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)``
     Tangent.
diff --git a/docs/source/todo.rst b/docs/source/todo.rst
index 9c6dce83a..67407cf9e 100644
--- a/docs/source/todo.rst
+++ b/docs/source/todo.rst
@@ -2,6 +2,15 @@
 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())
    modify programs (shell, paint) that now use callfar