RELEASE-NOTES

   1 This file lists interface changes that might affect users in 1.5.0 and
   2 also some known problems in LyX 1.5.0 that did not occur in
   3 1.4.5. Note that fixes are available for many of these, but they have
   4 not yet been applied because of incomplete testing.
   5
   6
   7 Interface changes
   8 -----------------
   9
  10 Some of the LyX functions have changed names :
  11
  12
  13 Known issues with version 1.5.0
  14 ------------------------------------
  15
  16 - User layout files must be converted to UTF-8
  17
  18 In previous versions, layout styles were allowed to use non-ASCII names
  19 using the local encodings. LyX-1.5 now assumes that all layout files are
  20 UTF-8 encoded. This means that non-ASCII style names are still allowed
  21 but they must be valid UTF-8 strings. One way of doing the conversion
  22 is to use iconv. Using bash, the script below should work:
  23
  24 #! /bin/sh
  25
  26 cd /path/to/layouts
  27 for l in *
  28 do
  29   cp "$l" tmp.txt
  30   iconv -f latin1 -t utf8 tmp.txt -o "$l"
  31 done
  32 rm -f tmp.txt
  33
  34 - Cursor restoration problems with Multiple-View
  35
  36 When using multiple Windows to edit different parts of the
  37 same document, the cursor position is sometimes not correctly restored
  38 when you switch from one view to the other.
  39
  40 - Languages/encodings and insets
  41
  42 One of the bugs fixed in LyX 1.5.0 is that previously, there were certain
  43 specific cases in which the LaTeX generated did not correctly reflect
  44 language/encoding transitions in and around insets (footnotes, LyX notes).
  45 After much deliberation, it was decided not to change older files such that
  46 they will still reflect the old LaTeX output; rather, they will now correctly
  47 reflect the situation as it appears in the GUI. This means, however, that if
  48 you mangled the text in the GUI in the older versions, in order that it
  49 generate the correct LaTeX output, the LaTeX will now generate the mangled
  50 text. If this is problematic for you, please get in touch with us on the
  51 developers mailing list, we do have some possible solutions for this.
  52
  53 The effects of this will be more pronounced for RTL (Hebrew, Arabic, Farsi)
  54 users --- though they affect users of other languages as well.
  55
  56 - Inset encodings and Conversion from earlier LyX versions
  57
  58 One of the main new features in version 1.5.0 is Unicode. As part of the
  59 transition, lyx2lyx (the scripts used for converting back and forth between
  60 different versions of the lyx files) converts old .lyx files, which may use
  61 a number of different encodings, to UTF-8. This conversion depends on
  62 correctly identifying the language of the text. There were previously some
  63 edge-cases (insets embedded in different-language text type scenarios) in
  64 which the language was incorrectly identified, which caused some text to
  65 appear incorrectly after having upgraded from older versions. This has now been
  66 fixed. Unfortunately, however, the fix cannot be applied to files which have
  67 already been converted past format 249.  So if you have already converted
  68 your old files (using a development version or release candidate), this fix
  69 won't help, unless you still have the originals lying around (and haven't
  70 yet made too many changes to the newer versions ;) ).
  71
  72 Generally, it is probably wise to keep a backup of the old version of your
  73 files, at least until you are sure that the upgrade went smoothly (which it
  74 almost always will).
  75
  76 - RTL and keymaps
  77
  78 Currently there is a bug where you can't use two non-RTL language keymaps if
  79 the RTL preference is set (which is now the default). If you need to use two
  80 non-RTL keymaps, for now you should just turn off the RTL preference (Tools ->
  81 Preferences... -> Language settings -> Language, uncheck "Right-to-left
  82 language support").
  83
  84 We hope to offer more comprehensive support for multiple keymaps in the future,
  85 which will solve this bug, as well as allow more than just two keymaps. If you
  86 have any input on this issue, please chime in on the developers mailing list,
  87 or add your comments to http://bugzilla.lyx.org/show_bug.cgi?id=4051.
  88
  89
  90 Note: There may later be an updated list of known issues online at
  91         http://wiki.lyx.org/LyX/ReleaseNotes
  92