development/FORMAT

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