development/FORMAT

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