X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=UPGRADING;h=15891e74b74482d48ce3d3f0c7b79ff0fa8e3d04;hb=b4e9c794fce47dbaa3742513ac53936e4ab1f2b8;hp=1f410ac82a0559565826f22794669416b2e5f48d;hpb=cf7f1cb764b00ce734d910150ea40db5a5764db9;p=features.git
diff --git a/UPGRADING b/UPGRADING
index 1f410ac82a..15891e74b7 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -1,11 +1,45 @@
-How do I upgrade my existing LyX system to version 2.2.x?
+How do I upgrade my existing LyX system to version 2.4.x?
---------------------------------------------------------
-* Upgrading from LyX 2.1.x:
+* Upgrading from LyX 2.3.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.4.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.
+
+* Upgrading from LyX 2.2.x:
+
+The format of preference and session files has changed. LyX 2.3.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 external_templates file has been split into one file per template,
+which are now located in lib/xtemplates/*.xtemplate. This makes it easier
+to add new templates or modify existing ones. If you have modified
+the external_templates file, you will have to move the modifications to
+the respective *.xtemplate file manually.
+
+If using TeX fonts and en- and em-dashes are output as font ligatures,
+when exporting documents containing en- and em-dashes to the format of
+LyX 2.0 or earlier, the following line has to be manually added to the
+unicodesymbols file of that LyX version:
+0x200b "\\hspace{0pt}" "" "" "" "" # ZERO WIDTH SPACE
+This avoids "uncodable character" issues if the document is actually
+loaded by that LyX version. LyX 2.1 and later versions already have the
+necessary definition in their unicodesymbols file.
+
+If trying to compile documents using R scripts and sweave/knitr, LyX
+2.3.x would not allow for re-running the R scripts, unless the user:
+1) explicitly disables the "Forbid use of needauth converters"
+option in the LyX preferences;
+2) provides explicit consent to the use of the converter on the first
+compilation of the R-enhanced document.
+
+* 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.