Prepare for 2.3.4-3

[lyx.git] / UPGRADING

diff --git a/UPGRADING b/UPGRADING
index 4308e8c73b66e19698790a3e68873d3fadc86d58..f28461caf17584c0fbb2fafd1faf55fdd58e53d6 100644 (file)
--- a/UPGRADING
+++ b/UPGRADING
@@ -3,26 +3,20 @@ How do I upgrade my existing LyX system to version 2.3.x?
 
 * 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:<br>
-0x200b "\\hspace{0pt}" "" "" "" "" # ZERO WIDTH SPACE<br>
-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.
+By default, LyX 2.3 outputs en- and em-dashes as -- and --- respectively,
+so that a line break can occur in the output immediately after the dash.
+Sometimes, this results in undesired line breaks or overfull lines due to
+suppression of hyphenation in the word preceding the dash.
+Select "Document->Settings->Fonts->Disallow line breaks after dashes"
+to keep the LyX 2.2 behaviour.
+See chapter 3.9.1.1, "Dashes and Line Breaks", of the User Guide
+for details.
 
 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:
@@ -31,6 +25,13 @@ option in the LyX preferences;
 2) provides explicit consent to the use of the converter on the first
 compilation of the R-enhanced document.
 
+LyX now gives a warning if a document mixes title and non-title layouts.
+In some cases, this warning is harmless, but in other cases the document has
+a serious problem even though the LaTeX command does not exit with error. For
+example, create a document with a title layout, then a standard layout, and
+then an author layout, and you will see in the PDF that the author is not
+typeset as an author.
+
 * Upgrading from LyX 2.1.x:
 
 The format of preference and session files has changed. LyX 2.2.x is able to