1 #LyX 2.4 created this file. For more info see https://www.lyx.org/
5 \save_transient_properties true
8 \options BCOR8mm,captions=tableheading
9 \use_default_options false
13 \maintain_unincluded_children no
15 \language_package default
18 \font_roman "lmodern" "default"
19 \font_sans "lmss" "default"
20 \font_typewriter "lmtt" "default"
21 \font_math "auto" "auto"
22 \font_default_family default
23 \use_non_tex_fonts false
27 \font_typewriter_osf false
28 \font_sf_scale 100 100
29 \font_tt_scale 100 100
31 \use_dash_ligatures true
33 \default_output_format pdf2
35 \bibtex_command default
36 \index_command default
40 \pdf_title "LyX's Development manual"
41 \pdf_author "LyX Team"
42 \pdf_subject "LyX's development documentation"
43 \pdf_keywords "LyX, Documentation, Development"
45 \pdf_bookmarksnumbered true
46 \pdf_bookmarksopen true
47 \pdf_bookmarksopenlevel 1
52 \pdf_pdfusetitle false
53 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
56 \use_package amsmath 1
57 \use_package amssymb 1
60 \use_package mathdots 1
61 \use_package mathtools 1
63 \use_package stackrel 1
64 \use_package stmaryrd 1
65 \use_package undertilde 1
67 \cite_engine_type default
71 \paperorientation portrait
77 \notefontcolor #0000ff
84 \paragraph_separation indent
85 \paragraph_indentation default
87 \math_numbering_side default
92 \paperpagestyle headings
94 \tracking_changes false
97 \postpone_fragile_content false
101 \docbook_table_output 0
107 Developing \SpecialChar LyX
111 \begin_layout Subtitle
115 \begin_layout Section
119 \begin_layout Subsection
120 When is an update of the .lyx file format number needed?
121 \begin_inset CommandInset label
123 name "sec:When-is-an"
130 \begin_layout Standard
131 When you are working on a new feature you may ask yourself whether it needs
132 an update of the .lyx file format number.
133 Whether an update is needed or not is not always obvious.
138 Whenever there is the danger that a previous version of LyX cannot open
139 a file using the new feature, a file format update is needed.
142 \begin_layout Standard
143 The file format change allows lyx2lyx rules to implement backwards compatibility.
144 Below you can find a list of reasons for file format updates with explanations:
147 \begin_layout Description
156 setting Whenever you introduce a new setting that is stored in the document
157 header, a file format update is needed.
160 \begin_layout Description
169 setting If a certain setting becomes obsolete and gets removed, a file format
173 \begin_layout Description
199 \begin_inset space \thinspace{}
206 \begin_layout Description
207 \paragraph_spacing single
220 package The reason for this is that there is no true ERT inset for math
221 formulas: Each command is parsed, and if a user happens to define a local
222 command with the same name as a command that triggers an automatic load
223 of a package, they need to be able to switch off the automatic loading
225 This switch is stored by the
226 \begin_inset Flex Code
229 \begin_layout Plain Layout
238 \begin_layout Description
243 language that is stored in
244 \begin_inset Flex Code
247 \begin_layout Plain Layout
257 \begin_inset Note Note
260 \begin_layout Plain Layout
261 This requirement is under discussion.
270 \begin_layout Description
275 inset Of course a new inset requires a file format update.
278 \begin_layout Description
283 style If a new style or inset layout is added to any layout file or module
284 shipped with \SpecialChar LyX
285 , then a new file format is needed in the master (development)
287 It is possible to backport new styles to the stable version without a file
291 \begin_layout Description
296 style If a style or inset layout is removed in any layout file or module
297 shipped with \SpecialChar LyX
298 , a new file format is required.
301 \begin_layout Standard
306 layouts and modules do
310 require a file format update (changed 03/16).
314 \begin_layout Standard
315 If you are still unsure, please ask on the development list.
318 \begin_layout Paragraph
319 \begin_inset CommandInset label
321 name "par:export-test-output-formats"
328 \begin_layout Standard
329 The following output formats are currently tested for each sample document:
332 \begin_layout Labeling
333 \labelwidthstring 00.00.0000
338 \begin_layout Labeling
339 \labelwidthstring 00.00.0000
340 lyx16 LyX 1.6 file format (lyx2lyx)
343 \begin_layout Labeling
344 \labelwidthstring 00.00.0000
345 lyx21 LyX 2.1 file format (lyx2lyx)
348 \begin_layout Labeling
349 \labelwidthstring 00.00.0000
350 xhtml LyXHTML (native LyX HTML export)
354 \begin_layout Labeling
355 \labelwidthstring 00.00.0000
368 \begin_layout Labeling
369 \labelwidthstring pdf5msystemFM
370 dvi DVI (8-bit latex)
373 \begin_layout Labeling
374 \labelwidthstring pdf5msystemFM
375 dvi3_texF DVI (LuaTeX with 8-bit TeX fonts)
378 \begin_layout Labeling
379 \labelwidthstring pdf5msystemFM
380 dvi3_systemF DVI (LuaTeX with Unicode fonts)
383 \begin_layout Labeling
384 \labelwidthstring pdf5msystemFM
388 \begin_layout Labeling
389 \labelwidthstring pdf5msystemFM
390 pdf4_texF PDF (XeTeX with 8-bit TeX fonts)
393 \begin_layout Labeling
394 \labelwidthstring pdf5msystemFM
395 pdf4_systemF PDF (XeTeX with Unicode fonts)
398 \begin_layout Labeling
399 \labelwidthstring pdf5msystemFM
400 pdf5_texF PDF (LuaTeX with 8-bit TeX fonts)
403 \begin_layout Labeling
404 \labelwidthstring pdf5msystemFM
405 pdf5_systemF PDF (LuaTeX with Unicode fonts)
409 \begin_layout Labeling
410 \labelwidthstring 00.00.0000
431 \begin_layout Labeling
432 \labelwidthstring pdf5msystemFM
433 pdf DVI -> PS (dvips) -> PDF (ps2pdf)
436 \begin_layout Labeling
437 \labelwidthstring pdf5msystemFM
438 pdf3 DVI -> PDF (dvipdfm)
442 \begin_layout Labeling
443 \labelwidthstring 00.00.0000
448 tested: (or only if set as default output format in the document source)
452 \begin_layout Labeling
453 \labelwidthstring pdf5msystemFM
457 \begin_layout Labeling
458 \labelwidthstring pdf5msystemFM
459 luatex LaTeX (LuaTeX)
462 \begin_layout Labeling
463 \labelwidthstring pdf5msystemFM
464 dviluatex LaTeX (dviluatex)
467 \begin_layout Labeling
468 \labelwidthstring pdf5msystemFM
469 pdflatex LaTeX (pdflatex)
472 \begin_layout Labeling
473 \labelwidthstring pdf5msystemFM
474 platex LaTeX (pLaTeX)
477 \begin_layout Labeling
478 \labelwidthstring pdf5msystemFM
482 \begin_layout Labeling
483 \labelwidthstring pdf5msystemFM
484 eps3 EPS (encapsulated Postscript) (cropped)
487 \begin_layout Labeling
488 \labelwidthstring pdf5msystemFM
489 ps DVI -> Postscript (dvips)
492 \begin_layout Labeling
493 \labelwidthstring pdf5msystemFM
497 \begin_layout Labeling
498 \labelwidthstring pdf5msystemFM
499 text (nor text2, ..., text4)
502 \begin_layout Labeling
503 \labelwidthstring pdf5msystemFM
507 \begin_layout Labeling
508 \labelwidthstring pdf5msystemFM
512 \begin_layout Labeling
513 \labelwidthstring pdf5msystemFM
517 \begin_layout Labeling
518 \labelwidthstring pdf5msystemFM