1 This file lists interface changes that might affect users in 2.1.0, some
2 known problems in LyX 2.1.0 and some things you have to take into account
3 when upgrading from earlier versions to a version of the 2.1.x series.
9 - There have been changes to some often used menu items.
11 The following menu items moved from View to Document:
12 * View (Default format)
13 * View (Other formats)
14 * Update (Default format)
15 * Update (Other formats)
17 The following menu item moved from Document to View:
18 * Outline -> Outline Pane
20 - Whenever the user closes a (tabbed) view on a document, either by
21 clicking on the tab close button, or by using the File->Close menu,
22 LyX now closes exclusively that specific view. If there are other
23 views showing the same document, they are not closed. When the user
24 closes the last view, LyX can be configured for either closing the
25 document, or keeping it in memory as a hidden document (that can be
26 shown again through the View->Hidden-> submenu).
28 A new configurable preference option has been added, allowing for
29 either (close_buffer_with_last_view).
31 - There have been some changes to the LyX command line. The following
32 new options have been added:
34 --export-to <format> <dest> (-E <format> <dest>)
36 Allows one to perform a batch export of the LyX file that is
37 opened to the specified destination file <dest> and format
38 <format>. For example, to create a PDF of a LyX document,
40 lyx --export-to pdf /path/to/dest.pdf /path/to/source.lyx
41 See the manual page for details.
43 This functionality is also available via a new menu voice
44 Export->Export As..., that pops up a dialog allowing one to
45 choose the export format, as well as the destination pathname.
46 Also, it is available via the mini-buffer (or the -x switch)
47 through a proper new LFUN (see below).
49 - The Advanced Find and Replace feature now supports cancel of a
50 long search operation by hitting the ESC key.
52 - Linux desktop file specification and scalable icon has been
53 included in the tarball.
55 - The format pdf aka "PDF (ps2pdf)" was split in two formats: pdf aka
56 "PDF (ps2pdf)" and pdf6 aka "PDF (graphics)". pdf6 is used for PDF
57 files included as graphics. Custom external templates and converters
58 might need to be adjusted. The format split was needed since otherwise
59 an odt->pdf converter which is intended for included graphics only
60 did interfere with document export via ps2pdf.
62 - The support for ArmTeX (a special typesetting engine for Armenian)
63 was removed. Writing text in Armenian is now possible in a native
67 The following pref variables were added in 2.1:
69 - \\close_buffer_with_last_view [yes|no|ask]
70 When the user closes the last view on a document, close the
71 document as well ("yes"), or hide the document ("no"), or ask
74 - \\completion_minlength
75 Defines the minimal length of a word to be added to the list of
76 words for text completion.
78 - \\default_length_unit
79 Defines the default length unit: 2 for centimers, 6 for inches.
81 - \\default_otf_view_format
82 Defines the default output format for documents with non-tex
83 fonts (OpenType fonts).
86 Defines the prefix for the TEXINPUTS environment variable. A
87 single '.' in the paths will get replaced with the current
88 document dir and also non-absolute paths will be prefixed with
91 The default semantics of TEXINPUTS apply, such that, for example,
92 if a path is terminated with a double slash, all subdirectories
93 will also be searched by both the TeX engine and ancillary programs
94 such as dvi previewers or dvips.
96 (see also commit 1717ef20)
99 See Caveats section below.
101 - \\use_system_theme_icons
102 If set to true, LyX tries to use the theme icons as defined by
106 The following pref variables were changed in 2.1:
108 - \\mac_like_word_movement -> \\mac_like_cursor_movement
109 When this option is set, the cursor is now moved to the end of
110 the current paragraph on paragraph-down. The pref variable was
111 renamed to better reflect this new behaviour.
114 The following pref variables are obsoleted in 2.1:
116 - \\default_language and \\default_papersize
117 To set the default language and paper size for new documents, use
118 the "Save As Document Defaults" button in Document > Settings.
121 The following new LyX functions have been introduced:
124 Inserts an IPA (International Phonetic Alphabet) inset.
126 - LFUN_IPAMACRO_INSERT <char>
127 Inserts special IPA macros into the document. <char> can be
128 one of 'tone-falling', 'tone-rising', 'tone-high-rising',
129 'tone-low-rising', 'tone-high-rising-falling', 'deco bottomtiebar',
132 - LFUN_SPELLING_CONTINUOUSLY
133 Toggles continuous spell-checking.
137 Renames or copies a file under version control.
139 - LFUN_BUFFER_FORALL <command>
140 Applies <command> to all non-hidden buffers.
142 - LFUN_ENVIRONMENT_SPLIT
143 Splits the current environment with a Separator.
145 - LFUN_BRANCH_MASTER_ACTIVATE <branch>
146 LFUN_BRANCH_MASTER_DEACTIVATE <branch>
147 Activates or deactivates a branch in a master document from within
148 a child (as opposed to the existing LFUN_BRANCH_[DE]ACTIVATE, which
149 toggle the branch in the document itself).
151 - LFUN_BUFFER_EXPORT_AS <format> <filename>
152 Equivalent to the new -export-to command-line switch (see above).
154 - LFUN_CLIPBOARD_PASTE_SIMPLE ("clipboard-paste-simple")
155 Paste the clipboard contents as simple unformatted text.
156 This is also available through a new menu voice within the
157 [Edit]->[Paste Special...] sub-menu.
160 Close the current document view only, if there are no more views
161 on the document, either close or hide it (see the new preference
162 option \\close_buffer_with_last_view)
165 The following LyX functions have been changed:
167 - LFUN_CLOSE_TAB_GROUP ("close-tab-group") was renamed to
168 LFUN_TAB_GROUP_CLOSE ("tab-group-close").
170 - LFUN_SPIT_VIEW ("split-view") was renamed to
171 LFUN_VIEW_SPLIT ("view-split").
173 - LFUN_BREAK_PARAGRAPH ("break-paragraph") was renamed to
174 LFUN_PARAGRAPH_BREAK ("paragraph-break").
177 The following LyX key bindings have been changed:
179 - The binding "C-w" was moved from "buffer-close" to "view-close"
182 - sciword.bind was changed significantly (see #8364). The most important
183 change is that "math-delim" commands now work under Windows.
185 The following LyX documents have been moved:
187 - 'AEA', 'JASA', 'springer', 'ACM-siggraph', and 'thesis' have been moved
188 from templates to examples (see #8643).
191 Changes with respect to external programs and libraries:
192 --------------------------------------------------------
194 - LyX now links against libmagic (http://www.darwinsys.com/file/) if it is
195 available at compile time. This improves the file format detection of
196 included graphics and other files. The old builtin format detection code
197 is used if libmagic is not available.
199 - LyX no longer uses gettext for reading the translation files. This
200 especially has an advantage on Windows, reducing the time it takes to
201 find the correct translation.
204 Known issues in version 2.1.0
205 -----------------------------
207 - LyX needs to be run under Python 2 and will not work properly on systems
208 where Python 3 is the default binary. See bug #7030 to know how to fix
209 this properly, since simple sheebang conversion in *.py files will not
213 Caveats when upgrading from earlier versions to 2.1.x
214 -------------------------------------------------------
216 - In order to improve reported scrolling slowness, we changed the way
217 screen painting is done. This, however, can slow down the performance
218 on remote X connections and we provide the \\use_qimage preference
219 variable, which brings back the old way of painting (when set to false).