development/FORMAT

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