development/FORMAT

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