development/FORMAT

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