-TODO
-----
-- Somebody should create a rc2rc script...
- http://www.lyx.org/trac/changeset/27531
-
-- some summary about 3rd party programs additions/removals should be
- written for packagers (eg aiksauraus, libtool).
+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 RC_USE_QIMAGE variable, which brings back
+the old way of painting (when set to false).