-Note: There may later be an updated list of known issues online at
- http://wiki.lyx.org/LyX/ReleaseNotes
+Known issues in version 2.1.0
+-----------------------------
+
+- LyX needs to be run under Python 2 and will not work properly on systems
+ where Python 3 is the default binary. See bug #7030 to know how to fix
+ this properly, since simple sheebang conversion in *.py files will not
+ be enough.
+
+
+Caveats when upgrading from earlier versions to 2.1.x
+-------------------------------------------------------
+
+- In order to improve reported scrolling slowness, we changed the way
+ screen painting is done. This, however, can slow down the performance
+ on remote X connections and we provide the \\use_qimage preference
+ variable, which brings back the old way of painting (when set to false).