-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).
+The following metadata files have been added to the tarball:
+
+- Linux desktop file specification and scalable icon has been
+ included in the tarball.
+
+- AppData file (appdata.xml). It will not be installed by default and
+ distribution maintainers need to handle this file themselves.
+
+
+Changes with respect to external programs and libraries:
+--------------------------------------------------------
+
+- LyX now links against libmagic (http://www.darwinsys.com/file/) if it is
+ available at compile time. This improves the file format detection of
+ included graphics and other files. The old builtin format detection code
+ is used if libmagic is not available.
+
+- LyX no longer uses gettext for handling the translation files. This
+ especially is an advantage on Windows, where translating strings is faster.
+
+
+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).