]> git.lyx.org Git - lyx.git/blobdiff - lib/RELEASE-NOTES
Update RELEASE NOTES
[lyx.git] / lib / RELEASE-NOTES
index 875c095cfa5587bf268738adc667b75f51c0a084..0b4efec9d260ff9a6ca7a82463e715c0dbc1bc0e 100644 (file)
-!Important Changes in LyX 2.3.0
+!Important Changes in LyX 2.4.0
 
 
 !!Interface changes
 
-* LyX now has "inverted" branch insets, which output their contents just in 
-  case a given branch is not "activated". This makes inclusion of alternate
-  material in different versions easier.
+* It is now possible to cancel background export processes. A menu entry
+  to do so will appear on the Document menu when such a process is underway.
+  The LFUN for this is export-cancel. One can also click on the 'spinner'
+  to cancel export.
 
-* When inserting a command or symbol in mathed, it is now automatically
-  wrapped in a real inset (either \text or \ensuremath) assuring the correct
-  mode, instead of being wrapped only in the output. The wrapping inset can
-  be safely dissolved, as it will be automatically inserted at export time
-  if needed, as usual.
+* The items on the Edit menu have been reordered, and many of the shortcuts
+  have been changed so that they are more intuitive in the case of often
+  used items. We understand that this may frustrate some users and apologize,
+  while noting that menu shortcuts can always be customized by copying the
+  stdmenus.inc file to the user directory and editing it.
 
 
-!!!The following pref variables were added in 2.3:
+!!Documents compilation process and images conversion
 
+* LyX now uses utf8 encoding per default for all languages. This does not affect
+  existing documents. Note that LyX also does not touch personal defaults and templates.
+  That is to say, if you still see traditional encoding preset for new documents,
+  you can change that by selecting "Unicode (utf8) [default]" and hitting "Save
+  as Documents Defaults" afterwards. Your personal templates need to be changed manually
+  if desired.
 
-!!!The following pref variables were changed in 2.3:
+* LyX defaults to the "HE8" LaTeX font encoding with Hebrew if the
+  "Culmus" LaTeX fonts are installed.
 
-* \document_path
-  Default is changed to ".". The best guess for where the user wants to save
-  or find files is the directory the user started LyX from. Before, the
-  default was always the home directory. If desired, the old behavior can be
-  restored by changing the default path in Preferences > "Working directory".
+* Documents that use TeX fonts can only be compiled with XeTeX if the input
+  encoding is set to "utf8-plain" or "ascii".
 
+!!!The following pref variables were added in 2.4:
 
-!!!The following pref variables are obsoleted in 2.3:
+* \ct_additions_underlined true|false: determines whether additions in change tracking
+  are underlined in the workarea (default: true).
 
+* \ct_markup_copied true|false: determines whether change tracking markup should be
+  preserved on copy/paste (default: false).
 
-!!!The following new LyX functions have been introduced in 2.3:
 
-* branch-invert
-  Toggles inversion status of branch inset.
+!!!The following pref variables were changed in 2.4:
 
-* lyx-activate
-  Activates the LyX window. Useful in combination with reverse search.
 
 
-!!!The following LyX functions have been changed in 2.3:
+!!!The following pref variables are obsoleted in 2.4:
 
-* quote-insert
-  The function now has a second and third optional argument to specify
-  the side (left, right, auto) and quotation mark style (english, swedish,
-  german, polish, french, danish).
+* \font_encoding
+  The font encoding is now automatically set depending on the document
+  fonts and languages.
 
-* inset-modify
-  This function now also applies to quote insets. It takes a three-character
-  string as an argument, refering (1.) to the style (e = ``english'',
-  s = ''swedish'', g = ,,german``, p = ,,polish'', f = <<french>>, a = >>danish<<),
-  (2.) to the side (l = left, r = right) and (3.) to the quotation level
-  (s = single, d = double). So "eld" means "English left double quotation mark".
-  A dot in the string means: take the current value. So "inset-modify changetype e.."
-  will only change the style to English, while letting side and level as is,
-  "inset-modify changetype f.s" will change the style to French and the level to
-  single, leaving the side value.
+* \use_qimage
+  This is no longer necessary due to the rewrite of the painter.
 
-  This function is most useful when combined with inset-forall. E.g.,
-  "inset-forall Quotes inset-modify changetype f.."
-   => change all quote insets to French style, maintaining current side and level
-  "inset-forall Quotes inset-modify changetype ..s"
-   => change all quote insets to single quotes, keeping style and level
-  "inset-forall Quotes inset-modify changetype g.s"
-   => change all quote insets to German single quotes, keeping left/right setting
+* \use_pixmap_cacheqimage
+  There is no evidence that this painting mode was useful anymore.
 
+* \date_insert_format
+  The function date-insert has been removed and superseded by info-insert date.
+  The latter does not need a pref value anymore.
 
-!!!The following LyX documents have been moved in 2.3:
 
+!!!The following new LyX functions have been introduced in 2.4:
 
-!!!The following metadata files have been added to the tarball in 2.3:
+* bidi is a helper function to implement icons that are different between LTR and RTL text. 
 
+* buffer-reset-export advises LyX to remove the auxiliary files before doing the next
+  export.
 
-!!Changes with respect to external programs and libraries in 2.3:
-* Inkscape SVG with separate LaTeX + PDF output is experimentally supported.
+* buffer-write-as-template is a new convenience function to ease saving a document
+  in the (personal) templates folder.
 
+* export-cancel: Used to cancel background export processes.
 
-!!Known issues in version 2.3.0
+* ifrelatives is a helper function to check whether a buffer has a master or children.
 
+* master-buffer-forall executes an lfun in the master and all children of a document.
 
-!!Caveats when upgrading from earlier versions to 2.3.x
+* paragraph-select is a new convenience function to select the paragraph
+  surrounding the actual cursor position.
 
+* tabular-style-insert: Insert a table in a specified style.
+
+
+!!!The following LyX functions have been changed in 2.4:
+
+* set-graphics-group was renamed to graphics-set-group.
+
+* info-insert buffer vcs-*: renamed to info-insert vcs *
+
+* file-insert: optional second parameter "ignorelang" to make the insertion
+  ignore the inserted file's main language (and rather adapt it to the insertion
+  context's language).
+
+
+!!!The following LyX functions have been removed in 2.4:
+
+* date-insert: obsoleted by info-insert date.
+
+
+
+!!!The following LyX documents have been moved in 2.4:
+
+* As a result of a major restructuring of the templates and example
+  directories, almost all examples and templates files have been renamed and
+  moved to subfolders that reflect the layout category.
+  The files now have much more decriptive (and longer) names, and they use
+  URL encoding for specific special characters such as '(', ')' and '&'.
+  Notably also the file that opens for new users has been renamed (from
+  splash.lyx to Welcome.lyx).
+
+
+!!!The following new folders have been added to the LyX directory
+
+* The examples and templates directories have been completely re-organized.
+  They are now much more structured (by means of layout categories) and thus
+  consist of many new subfolders. 
+
+
+
+!!!The following preferences files have been removed from the tarball in 2.4:
+
+
+
+!!!The following metadata files have been added to the tarball in 2.4:
+
+
+
+!!Changes with respect to external programs and libraries in 2.4:
+
+* The Qt5 libraries are now used by default. In order to link against
+  Qt4 the configure option --disable-qt5 has to be used.
+
+* The pplatex/dvipost program is no longer used.
+
+
+
+!!Known issues in version 2.4.0
+
+* See http://www.lyx.org/trac/wiki/BugTrackerHome
+
+
+!!Caveats when upgrading from earlier versions to 2.4.x
+
+* Autotools monolithic build option for building LyX binaries was removed,
+  for compilation speedup use parallel building on multiple cores instead.
+
+!! If upgrading from a LyX version before 2.3.0
+
+* Please additionally see the release notes from the versions in-between:
+  https://wiki.lyx.org/LyX/ReleaseNotes
+
+* Several ttf fonts (esint10.ttf, stmary10.ttf, wasy10.ttf) were changed
+  to reflect the fact that newer Qt libraries do not support displaying certain
+  codepoints anymore (bug #8493, #10161). 
+  Distribution packagers need to repack those font files in case they are
+  delivering the fonts as a separated package dependent from core LyX.