mention shadowing warnings from assembler

codeGenCpu6502/src/prog8/codegen/cpu6502/AssemblyProgram.kt

@@ -27,7 +27,7 @@ internal class AssemblyProgram(
 
                 // add "-Wlong-branch"  to see warnings about conversion of branch instructions to jumps (default = do this silently)
                 val command = mutableListOf("64tass", "--ascii", "--case-sensitive", "--long-branch",
-                    "-Wall", "-Wno-strict-bool", "-Wno-shadow", // "-Werror",
+                    "-Wall", // "-Wno-strict-bool", "-Werror",
                     "--dump-labels", "--vice-labels", "--labels=$viceMonListFile", "--no-monitor"
                 )
 

docs/source/compiling.rst

@@ -300,8 +300,8 @@ You can do one of two things to fix the build error:
 - install a JDK with that version,
 - or change the version number to match the JDK version that *is* installed on your system (must be >= 11)
 
-Strange assembler error
-^^^^^^^^^^^^^^^^^^^^^^^
+Strange assembler errors
+^^^^^^^^^^^^^^^^^^^^^^^^
 If the compilation of your program fails in the assembly step, please check that you have
 the required version of the 64tass assembler installed. See :ref:`requirements`.
 Also make sure that inside hand-written inlined assembly,
@@ -309,6 +309,12 @@ you don't use symbols named just a single letter (especially 'a', 'x' and 'y').
 Sometimes these are interpreted as the CPU register of that name. To avoid such confusions,
 always use 2 or more letters for symbols in your assembly code.
 
+'shadowing' warnings form the assembler
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Avoid using 'a', 'x' or 'y' as symbols in your inlined assembly code.
+Also avoid using 64tass' built-in function or type names as symbols in your inlined assembly code.
+The 64tass manual contains `a list of those <https://tass64.sourceforge.net/#functions>`_.
+
 
 Community
 ---------