development/FORMAT

   1 LyX file-format changes
   2 -----------------------
   3
   4 2003-07-28  José Matos  <jamatos@lyx.org>
   5
   6         * \the_end is replaced with \end_document
   7
   8 2003-07-28  José Matos  <jamatos@lyx.org>
   9
  10         * \layout is replaced with \begin_layout
  11
  12 2003-07-28  José Matos  <jamatos@fep.up.pt>
  13
  14         Format bumped to 225
  15
  16         * All layouts finish now with \end_layout
  17
  18 2003-06-04  Angus Leeming  <leeming@lyx.org>
  19
  20         Format bumped to 224
  21
  22         * the storage of the external inset has been changed from
  23
  24                 \begin_inset External XFig,"file.fig",""
  25
  26                 \end_inset
  27
  28         to this
  29
  30                 \begin_inset External
  31                         template XFig
  32                         filename file.fig
  33                         display <display_type>
  34                         lyxscale <scale>
  35
  36                 \end_inset
  37
  38         throwing away the final arg (here "", more generally "<string>") that holds
  39         the parameters variable.
  40         Variables are output if present (filename) or different from the default
  41         values (display, lyxscale).
  42
  43         Moreover, the RasterImage template has been scrapped. All RasterImage
  44         external insets are now converted to Graphics insets.
  45
  46 2003-05-20  Jürgen Spitzmüller  <j.spitzmueller@gmx.de>
  47
  48         * Added new space insets:
  49                 \SpecialChar ~ is now \InsetSpace ~
  50                 ERT: "\ " could be converted to InsetSpace \<space>
  51                 ERT: "\," could be converted to InsetSpace \,
  52
  53 2003-03-12  John Levon  <levon@movementarian.org>
  54
  55         * Added \\end_header to signify the end of the header in a
  56           more robust fashion.
  57
  58         * use_amsmath is now a tristate {0 = never, 1 = auto, 2 = always}
  59
  60 2003-02-10  John Levon  <levon@movementarian.org>
  61
  62         Format bumped to 222
  63
  64         Added \\tracking_changes 0|1 to the header.
  65
  66         Added \\author to the header. This can be present multiple
  67         times, and is of the form :
  68
  69         \\author "Real Name" email@address.com
  70
  71         Added \\change_deleted, \\change_inserted. Each of these does not
  72         span a paragraph, and is delimited by "\\change_unchanged\n". Both are
  73         of the form :
  74
  75         \\change_inserted author time
  76
  77         where author is an integer ID reference into the author list in
  78         the header, and time is time_t.
  79
  80 2002-10-24  Rob Lahaye  <lahaye@snu.ac.kr>
  81
  82         * insetgraphicsParams.h (scale): is now a float, not an unsigned int.
  83
  84 2002-08-22  Rob Lahaye <lahaye@snu.ac.kr>
  85
  86 New graphics dialog. With the removal of buttons in the dialog, also
  87 keywords in the graphics inset went. The following keywords do not
  88 exist anymore:
  89         lyxsize_kind
  90         lyxsize_type
  91         lyxwidth
  92         lyxheight
  93         size_kind
  94         size_type
  95         rotate
  96
  97 Only non-default values are saved to the lyx files. The defaults of the remaining
  98 keywords are;
  99         filename <empty>
 100         lyxscale 100
 101         display default
 102         scale 100
 103         width <empty>
 104         height <empty>
 105         draft <off>
 106         noUnzip <off>
 107         BoundingBox <from file>
 108         clip <off>
 109         rotateAngle 0
 110         rotateOrigin centerBaseline
 111         subcaption <off>
 112         subcaptionText <empty>
 113         special <empty>
 114
 115 The remaining keywords have sufficient overlap with the old ones for a
 116 smooth reading of the 1.2.x inset keywords in most common cases.
 117
 118 Compatibility is certainly broken for the old lyxwidth/lyxheight keywords.
 119 They don't exist anymore and we can't translate them into a scaling value, while
 120 we're reading the graphics inset. The old lyxwidth/lyxheight keyword and its
 121 argument is ignored and lost.
 122
 123 Only few compatibility issues are left for lyx2lyx:
 124
 125 ------------------------------------------------------------------------------
 126 old-token                                   new-token         remove
 127 ------------------------------------------------------------------------------
 128 size_kind original / size_type 0            scale 100         width <val>
 129                                                               height <val>
 130                                                               scale <val>
 131
 132 size_kind width_height / size_type 1            -             scale <val>
 133
 134 lyxsize_kind original / lyxsize_type 0      lyxscale 100      lyxscale <val>
 135 ------------------------------------------------------------------------------
 136 [replace old-token by new-token, and remove any of subsequent tokens as listed]
 137
 138 If "rotate" is absent, lyx2lyx should ignore "rotateAngle <val>":
 139    if ( "rotateAngle <val>" is there WITHOUT being preceded by the keyword "rotate" )
 140    then
 141         replace "rotateAngle <val>" by "rotateAngle 0"
 142
 143
 144 2002-08-12  Andre' Poenitz <poenitz@gmx.de>
 145
 146 Added \lyxlock for locked math inset when written to .lyx file.
 147 When "downgrading" .lyx files this should simple be deleted but it
 148 does not hurt at all if it stays in. It does not have to be added
 149 when "upgrading".
 150
 151
 152 2002-08-02  Angus Leeming  <leeming@lyx.org>
 153
 154 Added a boolean "preview" flag to InsetCommandParams.
 155 Currently it is written only by InsetInclude, because only this
 156 class can generate a preview of its contents.
 157
 158 The LyX file now contains:
 159
 160  \begin_inset Include \input{snapshot_t=40.tex}
 161 +preview true
 162
 163  \end_inset
 164
 165 Earlier versions of LyX just swallow this extra token silently.
 166
 167 2002-08-12  Angus Leeming  <leeming@lyx.org>
 168
 169 The 1.2.0 InsetGraphicsParams "size_type" and "lyxsize_type" have been
 170 renamed as "size_kind" and "lyxsize_kind" respectively.
 171
 172  \begin_inset Graphics FormatVersion 1
 173         filename file.eps
 174         display default
 175 -       size_kind original
 176 +       size_type original
 177         width 7cm
 178         rotateOrigin center
 179 -       lyxsize_kind original
 180 +       lyxsize_type original
 181         lyxwidth 4cm
 182
 183  \end_inset
 184