X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=RELEASE-NOTES;h=2efe627f2c404285ea53cb885c4808e3e6c690a4;hb=5f3cd55f1dcd85626277968891e5e12bc07287fc;hp=428b4fe58adf66c97ce127ceca4e27b4ec011be1;hpb=11441c85605e023e7c9a0a5d78cd608b6b5e1321;p=lyx.git diff --git a/RELEASE-NOTES b/RELEASE-NOTES index 428b4fe58a..2efe627f2c 100644 --- a/RELEASE-NOTES +++ b/RELEASE-NOTES @@ -1,77 +1,138 @@ -This file lists interface changes that might affect users in 1.5.0 and -also some known problems in LyX 1.5.0 that did not occur in -1.4.5. Note that fixes are available for many of these, but they have -not yet been applied because of incomplete testing. +This file lists interface changes that might affect users in 2.1.0, some +known problems in LyX 2.1.0 and some things you have to take into account +when upgrading from earlier versions to a version of the 2.1.x series. Interface changes ----------------- -Some of the LyX functions have changed names : +Whenever the user closes a (tabbed) view on a document, either by +clicking on the tab close button, or by using the File->Close menu, +LyX now closes exclusively that specific view. If there are other +views showing the same document, they are not closed. When the user +closes the last view, LyX can be configured for either closing the +document, or keeping it into memory as a hidden document (that can be +shown again through the View->Hidden-> submenu). +A new configurable preference option has been added, allowing for either +(close_buffer_with_last_view) -Known issues with version 1.5.0 +There have been some changes to the LyX command line. The following new +options have been added: + +-export-to (-E ) + + Allows one to perform a batch export of the LyX file that is opened + to the specified destination file and format . + For example, to create a PDF of a LyX document, you can run: + lyx -export-to pdf /path/to/dest.pdf /path/to/source.lyx + See the manual page for details. + This functionality is also available via a new menu voice + Export->Export As..., that pops up a dialog allowing one to + choose the export format, as well as the destination pathname. + Also, it is available via the mini-buffer (or the -x switch) + through a proper new LFUN (see below). + +The Advanced Find and Replace feature now supports cancel of a long +search operation by hitting the ESC key. + +The following pref variables were changed in 2.1: + +- \\close_buffer_with_last_view [yes|no|ask] + When user closes the last view on a document, close the document + as well ("yes"), or hide the document ("no"), or ask the user + ("ask"). + +The following pref variables are obsoleted in 2.1: + +- \\default_language +- \\default_papersize + +To set the default language and paper size for new documents, use the +"Save As Document Defaults" button in Document > Settings. + +The support for ArmTeX (a special typesetting engine for Armenian) was removed. +Writing text in Armenian is now possible in a native way using XeTeX. + +The following new LyX functions have been introduced: + +- LFUN_BRANCH_MASTER_ACTIVATE : + LFUN_BRANCH_MASTER_DEACTIVATE : + Activates or deactivates a branch in a master document from within + a child (as opposed to the existing LFUN_BRANCH_[DE]ACTIVATE, which + toggle the branch in the document itself). + +- LFUN_BUFFER_EXPORT_AS + Equivalent to the new -export-to command-line switch (see above). + +- LFUN_CLIPBOARD_PASTE_SIMPLE ("clipboard-paste-simple") + Paste the clipboard contents as simple unformatted text. + This is also available through a new menu voice within the + [Edit]->[Paste Special...] sub-menu. + +- LFUN_VIEW_CLOSE + Close the current document view only, if there are no more views + on the document, either close or hide it (see the new preference + option \\close_buffer_with_last_view) + +The following LyX functions have been removed: + +//template, remove this entry later on +- LFUN_NEXT_INSET_TOGGLE ("next-inset-toggle"): use "inset-toggle" instead. + + +The following LyX functions have been changed: + +//template, remove this entry later on +- LFUN_INSET_TOGGLE ("inset-toggle"): For some insets, this function was used + to show the settings dialog. This is no longer possible and one should use + inset-settings for this purpose. + +- LFUN_CLOSE_TAB_GROUP_CLOSE ("close-tab-group") was renamed to + LFUN_TAB_GROUP_CLOSE ("tab-group-close"). + +- LFUN_SPIT_VIEW ("split-view") was renamed to + LFUN_VIEW_SPLIT ("view-split"). + +- LFUN_BREAK_PARAGRAPH ("break-paragraph") was renamed to + LFUN_PARAGRAPH_BREAK ("paragraph-break"). + +The following LyX key bindings have been changed: + +//template, remove this entry later on +- LFUN_MATH_MACRO_FOLD ("math-macro-fold") + The binding to "C-minus" has changed to "C-S-underscore". + +- The binding "C-w" was moved from "buffer-close" to "view-close" + (only in cua.bind). + + +Linux desktop file specification and scalable icon has been included +into the tarball. + + +New external programs and libraries: ------------------------------------ -- User layout files must be converted to UTF-8 - -In previous version, layout styles were allowed to use non-ASCII names -using the local encodings. LyX-1.5 now assumes that all layout files are -UTF-8 encoded. This means that non-ASCII style names are still allowed -but they nust be valid UTF-8 strings. One way of doing the conversion -is to use iconv. Using bash, the script below should work: - -cd /path/to/layouts -for l in * -do - cp $l tmp.txt - iconv -f latin1 -t utf8 tmp.txt -o $l -done -rm tmp.txt - -- Cursor restoration problems with Multiple-View - -When using multiple Windows to edit different parts of the -same document, the cursor position is sometimes not correctly restored -when you switch from one view to the other. - -- Languages/encodings and insets - -One of the bugs fixed in LyX 1.5.0 is that previously, there were certain -specific cases in which the LaTeX generated did not correctly reflect -language/encoding transitions in and around insets (footnotes, LyX notes). -After much deliberation, it was decided not to change older files such that -they will still reflect the old LaTeX output; rather, they will now correctly -reflect the situation as it appears in the GUI. This means, however, that if -you mangled the text in the GUI in the older versions, in order that it -generate the correct LaTeX output, the LaTeX will now generate the mangled -text. If this is problematic for you, please get in touch with us on the -developers mailing list, we do have some possible solutions for this. - -The effects of this will be more pronounced for RTL (Hebrew, Arabic, Farsi) -users --- though they affect users of other languages as well. - -- Inset encodings and Conversion from earlier LyX versions - -One of the main new features in version 1.5.0 is Unicode. As part of the -transition, lyx2lyx (the scripts used for converting back and forth between -different versions of the lyx files) converts old .lyx files, which may use -a number of different encodings, to UTF-8. This conversion depends on -correctly identifying the language of the text. There were previously some -edge-cases (insets embedded in different-language text type scenarios) in -which the language was incorrectly identified, which caused some text to -appear incorrectly after having upgraded from older versions. This has now been -fixed. Unfortunately, however, the fix cannot be applied to files which have -already been converted past format 249. So if you have already converted -your old files (using a development version or release candidate), this fix -won't help, unless you still have the originals lying around (and haven't -yet made too many changes to the newer versions ;) ). - -Generally, it is probably wise to keep a backup of the old version of your -files, at least until you are sure that the upgrade went smoothly (which it -almost always will). - - -Note: There may later be an updated list of known issues online at - http://wiki.lyx.org/LyX/ReleaseNotes +- LyX links now against libmagic (http://www.darwinsys.com/file/) if it is + available at compile time. This improves the file format detection of + included graphics and other files. The old builtin format detection code + is used if libmagic is not available. + + +Known issues in version 2.1.0 +----------------------------- + +- LyX needs to be run under Python 2 and will not work properly on systems + where Python 3 is the default binary. See bug #7030 to know how to fix + this properly, since simple sheebang conversion in *.py files will not + be enough. + +Caveats when upgrading from earlier versions to 2.1.x +------------------------------------------------------- + +In order to improve reported scrolling slowness, we changed the way screen +painting is done. This, however, can slow down the performance on remote +X connections and we provide RC_USE_QIMAGE variable, which brings back +the old way of painting (when set to false).