X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=UPGRADING;h=bc8aeb726201111672064e09c34698bc2dcd5a9a;hb=67ad3b90ef1da322807b6b5eef62a15d34aba397;hp=fb07587fb92db60ca9f77399cedd1656dc9a5482;hpb=8dcf6d7871fe8ac3ef2a202cbb727865ba391efc;p=lyx.git diff --git a/UPGRADING b/UPGRADING index fb07587fb9..bc8aeb7262 100644 --- a/UPGRADING +++ b/UPGRADING @@ -1,12 +1,25 @@ -How do I upgrade my existing LyX system to version 1.2.x? +How do I upgrade my existing LyX system to version 1.3.0? --------------------------------------------------------- -If you upgrade from version 1.1.6 or 1.1.5, you shouldn't have any -problems. It is nevertheless a good idea to advise all users to run -Edit->Reconfigure. +One of the perennial bug bears of LyX users in the past has been that +they have had to run Edit->Reconfigure when starting their new version +of the code for the first time. Strange and wonderful things would +often result if they forgot to do this, so LyX 1.3.0 now runs +Edit->Reconfigure automatically the first time the program is run. If you have your own layout files, you may need to update them a little: +- floats are now defined in the layout file, using the "Float"..."End" + construct. In most cases, adding "Input stdfloats.inc" to your layout + file is enough. + +- counters are also defined in the layout files, using the + "Counter"..."End" construct. As for floats, adding "Input + stdfloats.inc" is probably a good idea. + +And of course, if you upgrade from LyX 1.1.x, remember that since +1.2.0, you have to do the following changes: + - all layout files should have a "DefaultStyle" entry - the "Latex" font style does not exist anymore. If you really need @@ -15,6 +28,18 @@ If you have your own layout files, you may need to update them a little: The new layout format keywords are described in the Customization manual. +If you have your own binding files (especially math.bind), you will +have to update them + +- math-insert now takes a latex macro name as argument, so that + "math-insert sqrt" should now be "\math-insert \sqrt" + +- math-greek-toggle is now gone, and should be replaced by explicit + bindings like + + \bind "M-m g a" "math-insert \alpha" + + Build requirements ------------------ @@ -25,49 +50,34 @@ do not have the ImageMagick command-line tools installed, you will need to modify the default set up of LyX, or install them, in order to get previews of your document's graphics. -Note: if you are using convert, and the graphics won't load in LyX, -then you are probably seeing a bug in earlier versions of ImageMagick. -You can either upgrade ImageMagick, change the convertor to use -"convert -depth 8", which shold work around the problem, or set up -a convertor to use a different conversion program as described in -the documentation. - -http://bugzilla.lyx.org/show_bug.cgi?id=360 - Document transfer ----------------- -In general, you don't need to convert any documents saved with LyX -1.1.5 or 1.1.6 to use them with LyX 1.2.0. - -Older versions of LyX cannot read documents saved with LyX 1.2.0. - -LyX 1.2.0 can read most documents saved with lyx 1.1.6 correctly. - -If you were previously using the floatflt paragraph option to -wrap text around a figure, you will need to modify this for LyX 1.2.0 -manually, as described in the manuals. Please ask on the lyx-users -list for assistance if you have trouble with this. - -Note that your document may rely on the floatflt package (for example, -you may use \floatingfigure via LaTeX commands). If your document does -not have "\usepackage{floatflt}" already in the user pre-amble, you will -need to add it. - -The babel package is now loaded after the user-defined +LyX 1.3.0 uses an external python script, lyx2lyx, to import documents +written using previous versions of LyX. All versions of LyX as far back as +0.12 are supported, so any klyx users still holding out for an alternative +to xforms will finally be able to put their dinosaur to rest ;-) + +Of course, this means that you must have python (at least version 1.5) +installed in order to use LyX 1.3.0 with your old documents. + +lyx2lyx also has the framework in place to be able to convert documents +to an earlier format. However, these converters have not yet been written +so older versions of LyX will NOT be able to read documents saved with +LyX 1.3.0. + +If you were previously (in LyX 1.1.x) using the floatflt paragraph +option to wrap text around a figure, it was necessary to modify this +for LyX 1.2.0 manually, as described in the manuals. The feature has +been re-implemented as "Floting figure" inset in 1.3.0. Old files will +be converted automatically, but you may want to convert the +1.2.x-style ERT constructs with the native solution (see section 3.8 +of the Extended Features manual). + +Since LyX 1.2.0, the babel package is loaded after the user-defined preamble (because some packages really need to be loaded before babel). If you relied, on babel being loaded before your own definitions, you can add an extra "\usepackage{babel}" statement at the beginning of your preamble. http://bugzilla.lyx.org/show_bug.cgi?id=315 - -If you are using the minipage paragraph options in your document, you -may find that LyX 1.2.0 fails to import them correctly as minipages. -This might require some editing to correct this. If you have -trouble with this, please ask the lyx-users mailing list for assistance, -and we will be happy to help. - -http://bugzilla.lyx.org/show_bug.cgi?id=374 -http://bugzilla.lyx.org/show_bug.cgi?id=375 -http://bugzilla.lyx.org/show_bug.cgi?id=376