diff --git a/README.md b/README.md
index 4f83aeb02..49b5bc8ea 100644
--- a/README.md
+++ b/README.md
@@ -51,6 +51,7 @@ GNU GPL 3.0 (see file LICENSE), with exception for generated code:
 What does Prog8 provide?
 ------------------------
 
+- can produce smaller and faster running programs than equivalent C code compiled with CC65 or even LLVM-MOS
 - all advantages of a higher level language over having to write assembly code manually
 - programs run very fast because compilation to native machine code
 - modularity, symbol scoping, subroutines
diff --git a/docs/source/index.rst b/docs/source/index.rst
index ec43f5b56..fe7d80b2d 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -70,6 +70,7 @@ Features
 --------
 
 - it is a cross-compiler running on modern machines (Linux, MacOS, Windows, ...)
+- can produce smaller and faster running programs than equivalent C code compiled with CC65 or even LLVM-MOS
 - the compiled programs run very fast, because compilation to highly efficient native machine code.
 - Provides a convenient and fast edit/compile/run cycle by being able to directly launch
   the compiled program in an emulator and provide debugging information to this emulator.
diff --git a/docs/source/syntaxreference.rst b/docs/source/syntaxreference.rst
index 67a8429a0..fe6782260 100644
--- a/docs/source/syntaxreference.rst
+++ b/docs/source/syntaxreference.rst
@@ -390,8 +390,8 @@ type identifier  type                     storage size       example var declara
 ``ubyte[x]``     unsigned byte array      x bytes            ``ubyte[4] myvar``
 ``word[x]``      signed word array        2*x bytes          ``word[4] myvar``
 ``uword[x]``     unsigned word array      2*x bytes          ``uword[4] myvar``
-``float[x]``     floating-point array     5*x bytes          ``float[4] myvar``
-``bool[x]``      boolean array            5*x bytes          ``bool[4] myvar``  note: consider using bit flags in a byte or word instead to save space
+``float[x]``     floating-point array     5*x bytes          ``float[4] myvar``.   The 5 bytes per float is on CBM targets.
+``bool[x]``      boolean array            x bytes            ``bool[4] myvar``  note: consider using bit flags in a byte or word instead to save space
 ``byte[]``       signed byte array        depends on value   ``byte[] myvar = [1, 2, 3, 4]``
 ``ubyte[]``      unsigned byte array      depends on value   ``ubyte[] myvar = [1, 2, 3, 4]``
 ``word[]``       signed word array        depends on value   ``word[] myvar = [1, 2, 3, 4]``