From cf7f1cb764b00ce734d910150ea40db5a5764db9 Mon Sep 17 00:00:00 2001 From: Scott Kostyshak Date: Sat, 7 Nov 2015 01:49:02 -0500 Subject: [PATCH] Copy caveats from RELEASE-NOTES to UPGRADING --- UPGRADING | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/UPGRADING b/UPGRADING index 122f92d8f8..1f410ac82a 100644 --- a/UPGRADING +++ b/UPGRADING @@ -1,6 +1,44 @@ -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: + +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. + +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. -- 2.39.2