X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=UPGRADING;h=0130ae7d96fe8691550abedbc1d8f3066e85bd78;hb=f16b2cab75752e7b0fbec5520e231b068eb29072;hp=122f92d8f8acb2b4c7ef6ea3f3124ba5c92aab37;hpb=7f52ead718b649da978d09e6d6d4df2c99ead2f8;p=lyx.git

diff --git a/UPGRADING b/UPGRADING
index 122f92d8f8..0130ae7d96 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -1,6 +1,40 @@
-How do I upgrade my existing LyX system to version 2.1.x?
+How do I upgrade my existing LyX system to version 2.2.x?
 ---------------------------------------------------------
 
+* Upgrading from LyX 2.1.x:
+
+The format of preference and session files has changed. LyX 2.2.x is able to
+read old files but will save them in the new format.
+
+The format of layout files has changed but, as before, layout2layout.py will
+convert older versions to the new format automatically.
+
+The prefix for subsections in labels and references has been changed from
+"sub:" to "subsec:" in order to avoid a clash with subfloats (conflicting
+\subref command, see bug #7550). Files are automatically converted to the new
+scheme. Please assure that you adapt external refstyle or prettyref definitions
+and your own layout files.
+
+BibTeX errors are now processed and cause LyX to show the errors dialog.
+Before, these errors were ignored, which means that it may happen that
+documents that compiled without error with a previous version now
+compile with error. However, because now in 2.2.x users can click on
+the "Show Output Anyway" button, the document can still be viewed.
+
+Missing characters in the output are now reported as errors. This leads
+to error reports for documents that compiled without error before.
+However, the error was always present but went undetected!
+
+Documents using Times fonts and containing Greek characters may now fail
+to compile under pdflatex for users of MikTeX due to an automatically
+half-installed "grtimes" package. A workaround in LyX was removed as it
+stands in the way of alternative approaches (see bug #6469).
+
+With LuaTeX, LyX now uses polyglossia instead of babel if the language
+package option "Automatic" is selected. In order to use babel, select
+"Always babel" instead. This may be needed if a document uses code that
+is specific to babel.
+
 * Upgrading from LyX 2.0.x:
 
 Python version >=2.4 is now required.