development/FORMAT

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