home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Divers / lyx-0.13.2.tar.gz / lyx-0.13.2.tar / lyx-0.13.2 / UPGRADING < prev    next >
Text File  |  1998-04-23  |  5KB  |  111 lines
  1. How do I upgrade my existing LyX system to version 0.12?
  2. --------------------------------------------------------
  3.  
  4. [Document written 1997-04-03 by Asger Alstrup (alstrup@diku.dk)]
  5. [Updated 1998-02-12 by Jean-Marc Lasgouttes (Jean-Marc.lasgouttes@inria.fr)]
  6.  
  7. Before you run "make install", rename your existing LyX binary
  8. (usually /usr/local/bin/lyx) to something like lyx-0.10.7, in order to
  9. be able to use it in case of problem.  There is not need to backup
  10. your library hierarchy, usually situated at /usr/local/lib/lyx/,
  11. because the installation places files in another place (usually
  12. /usr/local/share/lyx/).  If you don't care about saving your previous
  13. LyX configuration, just delete the old LyX library directory before
  14. running "make install".  You can safely delete "~/.lyxlastfiles" and
  15. "~/.lyxrc" in this case also: these files are not used by lyx v0.12.
  16. Also, you don't need to export the LYX_DIR environment variable anymore.
  17.  
  18. LyX version 0.12.0 introduces a new configuration system.  Also, as a
  19. consequence of the general code clean-up, configuration file syntax
  20. has been enhanced and changed for the better.  This means that you
  21. can't use your old configuration files (.lyxrc and system.lyxrc)
  22. anymore.
  23.  
  24. This is not as sad as you might fear, because LyX now uses an advanced
  25. auto-detection scheme to try to set up much of the configuration to
  26. fit your system.  This means that the required customization has been
  27. reduced, so it's easier to configuring LyX from scratch rather than
  28. to fiddle with old configuration files.
  29.  
  30. The new configuration system enables you to try LyX completely before
  31. installing it.  You can use this feature to ensure that the setup is
  32. correct before you run "make install" and invalidate an old LyX
  33. installation.
  34.  
  35. It is possible to have both a lyx-0.10.x and lyx-0.12.x installed on
  36. the same system, as long as you take care that they have a different
  37. name, specified with the --program-suffix option to configure.  You
  38. might also want to check out the other options of configure (try
  39. "./configure --help" or read INSTALL.autoconf).
  40.  
  41. Document transfer
  42. -----------------
  43.  
  44. In general, you don't need to convert any documents saved with LyX
  45. v0.10 to use them with LyX v0.12.
  46.  
  47. LyX v0.12.x can read all documents saved with lyx-0.10.x correctly up
  48. to the old math mode, which is not supported anymore. If you have
  49. documents with such math formulas, you convert it using the program
  50. COLD, written by Preben Rhandol. COLD can be found at:
  51.   http://www.pvv.org/~randhol/lyx/COLD/
  52.   ftp://ftp.via.ecp.fr/pub/lyx/contrib/
  53. or at one of LyX archive mirror sites listed in README.
  54.  
  55. If you have any documents prepared with LyX v0.8 that cause problems
  56. in v0.12, you should try to load them into LyX v0.10 and save them
  57. there and then use LyX v0.12 to read that.
  58.  
  59. LyX v0.12 saves in LyX format 2.15, which mostly can be read by lyx-0.10.x
  60. except for errors with respect to the new features and changes in table
  61. handling.  If you do this, we recommend that you proof-read the document 
  62. carefully before printing, because spurious codes will be inserted in the 
  63. document that have to be deleted by hand.
  64.  
  65. The new logical font attributes "emph" and "noun" are not supported by
  66. LyX v0.10.  In LyX v0.10 the "emph" attribute is exactly the same as
  67. "italic", while "noun" is the same as "smallcaps".  In version 0.12,
  68. emph and noun are logical attributes, while italic and smallcaps are
  69. concrete attributes.  This means that you might want to update all
  70. "italic" font attributes to "emph" and similar with "noun" for
  71. "smallcaps".  This can only be done by hand (or by hacking the raw
  72. .lyx files).  The logical attributes are superior, because they can
  73. change the concrete font change according to the environment.  In
  74. later versions of LyX, we hope to provide fully customizable logical
  75. character font styles.
  76.  
  77. In LyX v1.0, we aim for reading of LaTeX, so document incompatibilities 
  78. will hopefully be reduced greatly then.
  79.  
  80. If you have VERY large problems with document transfers that can't
  81. wait till v1.0, ask for help on the developers' mailing list at
  82. lyx@via.ecp.fr, and we'll see what we can do.
  83.  
  84. Custom layout files
  85. -------------------
  86.  
  87. If you are an advanced user that have created custom layout files, you
  88. have to update those by hand.  Some syntactic elements have changed
  89. for the better.  Luckily, syntactic error handling has also improved a
  90. lot, so it should not be too hard to update your layout files: just
  91. correct the errors LyX reports.
  92.  
  93. One important new feature is the "Input" directive that allows to
  94. input another layout file, or a layout file snippet.  This has been
  95. used to remove redundancy in layout files and improve
  96. maintainability.  For an example of using this, take a look at
  97. amsart.layout.  Two other new features that help with
  98. redefinition is the possibility to modify or delete an existing
  99. style. 
  100.  
  101. The "DefaultFamily", "DefaultSeries", ..., directives have been
  102. replaced with the "DefaultFont" directive.  See Customization.lyx as a
  103. reference for the new syntax.
  104.  
  105. The "BaseLineStretch" directive has been replaced with the "Spacing"
  106. directive.  Instead of "BaseLineStretch 1.1", use "Spacing Other 1.1".
  107.  
  108. As with document transfers, direct any specific questions about
  109. updating of layout files to the developers' mailing list at
  110. lyx@via.ecp.fr.
  111.