UPGRADING

   1 How do I upgrade my existing LyX system to version 1.3.0?
   2 ---------------------------------------------------------
   3
   4 One of the perennial bug bears of LyX users in the past has been that
   5 they have had to run Edit->Reconfigure when starting their new version
   6 of the code for the first time. Strange and wonderful things would
   7 often result if they forgot to do this, so LyX 1.3.0 now runs
   8 Edit->Reconfigure automatically the first time the program is run.
   9
  10 If you have your own layout files, you may need to update them a little:
  11
  12 - all layout files should have a "DefaultStyle" entry
  13
  14 - the "Latex" font style does not exist anymore. If you really need
  15   its functionality, consider using the "PassThru" keyword instead.
  16
  17 The new layout format keywords are described in the Customization
  18 manual.
  19
  20 If you have your own binding files (especially math.bind), you will
  21 have to update them
  22
  23 - math-insert now takes a latex macro name as argument, so that
  24   "math-insert sqrt" should now be "\math-insert \sqrt"
  25
  26 - math-greek-toggle is now gone, and should be replaced by explicit
  27   bindings like
  28
  29   \bind "M-m g a"      "math-insert \alpha"
  30
  31
  32 Build requirements
  33 ------------------
  34
  35 LyX's graphics handling system has changed substantially. If you
  36 do not have the JPEG library installed, you may need to install
  37 it before you can use the graphics capabilities of LyX. If you
  38 do not have the ImageMagick command-line tools installed, you
  39 will need to modify the default set up of LyX, or install them,
  40 in order to get previews of your document's graphics.
  41
  42 Document transfer
  43 -----------------
  44
  45 LyX 1.3.0 uses an external python script, lyx2lyx, to import documents
  46 written using previous versions of LyX. All versions of LyX as far back as
  47 0.12 are supported, so any klyx users still holding out for an alternative
  48 to xforms will finally be able to put their dinosaur to rest ;-)
  49
  50 Of course, this means that you must have python installed in order to
  51 use LyX 1.3.0 with your old documents.
  52
  53 lyx2lyx also has the framework in place to be able to convert documents
  54 to an earlier format. However, these converters have not yet been written
  55 so older versions of LyX will NOT be able to read documents saved with
  56 LyX 1.3.0.
  57
  58 If you were previously using the floatflt paragraph option to
  59 wrap text around a figure, you will need to modify this for LyX 1.2.0
  60 manually, as described in the manuals. Please ask on the lyx-users
  61 list for assistance if you have trouble with this.
  62
  63 The babel package is now loaded after the user-defined
  64 preamble (because some packages really need to be loaded before
  65 babel). If you relied, on babel being loaded before your own
  66 definitions, you can add an extra "\usepackage{babel}" statement at
  67 the beginning of your preamble.
  68
  69 http://bugzilla.lyx.org/show_bug.cgi?id=315