lib/RELEASE-NOTES

   1 !Important Changes in LyX 2.2.0
   2
   3 (: This file lists interface changes that might affect users in 2.2.0, some
   4    known problems in LyX 2.2.0 and some things you have to take into account
   5    when upgrading from earlier versions to a version of the 2.2.x series. :)
   6
   7
   8 !!Interface changes
   9
  10 * The --Separator-- layout has been removed in favor of an environment
  11   separator inset. There is no provision for inserting this inset from
  12   the GUI (though some menu entries use it) as it is automatically inserted
  13   when needed. See Section 3.4.6 of the User Guide for details.
  14
  15 * The prefix for subsections in labels and references has been changed from
  16   "sub:" to "subsec:" in order to avoid a clash with subfloats (conflicting
  17   \subref command, see bug #7550). Files are automatically converted to the new scheme.
  18   Please assure that you adapt external refstyle or prettyref definitions and
  19   your own layout files.
  20
  21 !!!The following pref variables were added in 2.2:
  22
  23 * \save_origin:
  24   This variable was introduced to allow saving the document directory
  25   path in the document. If allowed, LyX will be able to locate all
  26   included files even when the document is manually moved/copied to
  27   a different location. If a valid \origin tag is present and the
  28   document was actually moved, the path of all included files is
  29   updated relative to the new location and the new origin will be
  30   recorded when saving again the document.
  31
  32 !!!The following pref variables were changed in 2.2:
  33
  34
  35
  36 !!!The following pref variables are obsoleted in 2.2:
  37
  38 * \rtl:
  39   This variable was introduced to guard against any bad consequence of
  40   the then-new right-to-left languages support. It is no longer needed
  41   because of improvements. Now right-to-left support is always enabled.
  42
  43
  44 !!!The following new LyX functions have been introduced in 2.2:
  45
  46 * buffer-view-cache:
  47   Opens the last previewed output of the buffer, if it exists.
  48
  49 * buffer-move-next:
  50   Moves the current tab one spot to the right.
  51
  52 * buffer-move-previous:
  53   Moves the current tab one spot to the left.
  54
  55
  56 !!!The following LyX functions have been changed in 2.2:
  57
  58
  59
  60 !!!The following LyX key bindings have been changed in 2.2:
  61
  62 * For bindings where Control + {PgDn, PgUp} switches to the
  63   {next, previous} tab, Control + Shift + {PgDn, PgUp} moves the current
  64   tab to the {next, previous} tab.
  65
  66
  67 !!!The following LyX documents have been moved in 2.2:
  68
  69
  70
  71 !!!The following metadata files have been added to the tarball in 2.2:
  72
  73
  74
  75 !!Changes with respect to external programs and libraries in 2.2:
  76
  77 * LyX is not yet supposed to work with Qt5. It is advised to compile and
  78   run LyX against Qt 4.8.x. On Windows Qt 4.8.6 or newer is advised.
  79
  80 * LyX now gives an error if the underlying LaTeX command exited with error.
  81
  82 * With LuaTeX, LyX now uses polyglossia instead of babel if the language
  83   package option "Automatic" is selected. In order to use babel, select
  84   "Always babel" instead.
  85
  86
  87 !!Known issues in version 2.2.0
  88
  89 * LyX needs to be run under Python 2 and will not work properly on systems
  90   where Python 3 is the default binary. See bug #7030 to know how to fix
  91   this properly, since simple sheebang conversion in *.py files will not
  92   be enough.
  93
  94
  95 !!Caveats when upgrading from earlier versions to 2.2.x
  96
  97 * BibTeX errors are now processed and cause LyX to show the errors dialog.
  98   Before, these errors were ignored, which means that it may happen that
  99   documents that compiled without error with a previous version now
 100   compile with error. However, because now in 2.2.x users can click on
 101   the "Show Output Anyway" button, the document can still be viewed.
 102