development/batchtests/compare_tests/long_doc/diffs.expected.lyx

   1 #LyX 2.4 created this file. For more info see https://www.lyx.org/
   2 \lyxformat 613
   3 \begin_document
   4 \begin_header
   5 \save_transient_properties true
   6 \origin unavailable
   7 \textclass article
   8 \begin_preamble
   9 % DO NOT ALTER THIS PREAMBLE!!!
  10 %
  11 %This preamble is designed to ensure that the document prints
  12 % out as advertised. If you mess with this preamble,
  13 % parts of the document may not print out as expected.  If you
  14 % have problems LaTeXing this file, please contact
  15 % the documentation team
  16 % email: lyx-docs@lists.lyx.org
  17
  18 % the pages of the TOC is numbered roman
  19 % and a pdf-bookmark for the TOC is added
  20 \pagenumbering{roman}
  21 \let\myTOC\tableofcontents
  22 \renewcommand\tableofcontents{%
  23   \pdfbookmark[1]{\contentsname}{}
  24   \myTOC
  25   \cleardoublepage
  26   \pagenumbering{arabic} }
  27 \end_preamble
  28 \use_default_options false
  29 \maintain_unincluded_children no
  30 \language english
  31 \language_package default
  32 \inputencoding utf8
  33 \fontencoding auto
  34 \font_roman "palatino" "default"
  35 \font_sans "helvet" "default"
  36 \font_typewriter "courier" "default"
  37 \font_math "auto" "auto"
  38 \font_default_family default
  39 \use_non_tex_fonts false
  40 \font_sc true
  41 \font_roman_osf false
  42 \font_sans_osf false
  43 \font_typewriter_osf false
  44 \font_sf_scale 100 100
  45 \font_tt_scale 100 100
  46 \use_microtype false
  47 \use_dash_ligatures false
  48 \graphics default
  49 \default_output_format pdf2
  50 \output_sync 0
  51 \bibtex_command default
  52 \index_command default
  53 \paperfontsize 12
  54 \spacing single
  55 \use_hyperref true
  56 \pdf_title "Introduction to LyX"
  57 \pdf_author "LyX Team"
  58 \pdf_subject "LyX-documentation Intro"
  59 \pdf_keywords "LyX, documentation"
  60 \pdf_bookmarks true
  61 \pdf_bookmarksnumbered true
  62 \pdf_bookmarksopen true
  63 \pdf_bookmarksopenlevel 2
  64 \pdf_breaklinks true
  65 \pdf_pdfborder false
  66 \pdf_colorlinks true
  67 \pdf_backref false
  68 \pdf_pdfusetitle false
  69 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
  70 \papersize a4
  71 \use_geometry false
  72 \use_package amsmath 1
  73 \use_package amssymb 1
  74 \use_package cancel 1
  75 \use_package esint 1
  76 \use_package mathdots 1
  77 \use_package mathtools 1
  78 \use_package mhchem 1
  79 \use_package stackrel 1
  80 \use_package stmaryrd 1
  81 \use_package undertilde 1
  82 \cite_engine basic
  83 \cite_engine_type default
  84 \biblio_style plain
  85 \use_bibtopic false
  86 \use_indices false
  87 \paperorientation portrait
  88 \suppress_date false
  89 \justification true
  90 \use_refstyle 0
  91 \use_minted 0
  92 \use_lineno 0
  93 \index Index
  94 \shortcut idx
  95 \color #008000
  96 \end_index
  97 \secnumdepth 3
  98 \tocdepth 2
  99 \paragraph_separation indent
 100 \paragraph_indentation default
 101 \is_math_indent 0
 102 \math_numbering_side default
 103 \quotes_style english
 104 \dynamic_quotes 0
 105 \papercolumns 1
 106 \papersides 1
 107 \paperpagestyle default
 108 \tablestyle default
 109 \tracking_changes true
 110 \output_changes true
 111 \change_bars false
 112 \postpone_fragile_content false
 113 \html_math_output 0
 114 \html_css_as_file 0
 115 \html_be_strict false
 116 \docbook_table_output 0
 117 \docbook_mathml_prefix 1
 118 \author 1660427103 "Document Comparison"
 119 \end_header
 120
 121 \begin_body
 122
 123 \begin_layout Title
 124 Introduction to \SpecialChar LyX
 125
 126 \end_layout
 127
 128 \begin_layout Author
 129 by the \SpecialChar LyX
 130  Team
 131 \begin_inset Foot
 132 status collapsed
 133
 134 \begin_layout Plain Layout
 135 \noindent
 136 If you have comments on or corrections to this documentation,
 137  please send them to the \SpecialChar LyX
 138  Documentation mailing list:
 139
 140 \begin_inset CommandInset href
 141 LatexCommand href
 142 target "lyx-docs@lists.lyx.org"
 143 type "mailto:"
 144 literal "false"
 145
 146 \end_inset
 147
 148
 149 \end_layout
 150
 151 \end_inset
 152
 153
 154 \end_layout
 155
 156 \begin_layout Standard
 157 \begin_inset CommandInset toc
 158 LatexCommand tableofcontents
 159
 160 \end_inset
 161
 162
 163 \end_layout
 164
 165 \begin_layout Section
 166 The Philosophy of \SpecialChar LyX
 167
 168 \end_layout
 169
 170 \begin_layout Subsection
 171 What is \SpecialChar LyX
 172 ?
 173 \end_layout
 174
 175 \begin_layout Standard
 176 \SpecialChar LyX
 177  is a document preparation system.
 178  It excels at letting you create complex technical and scientific articles with mathematics,
 179  cross-references,
 180  bibliographies,
 181  indexes,
 182  etc.
 183  It is very good for working with documents of any length in which the usual processing abilities are required:
 184  automatic sectioning and pagination,
 185  spell checking and so forth.
 186  It can also be used to write a letter to your mom,
 187  though granted,
 188  there are probably simpler programs available for that.
 189  It is definitely not the best tool for creating banners,
 190  flyers,
 191  or advertisements (we'll explain why later),
 192  though with some effort all these can be done,
 193  too.
 194  Here are some examples of what it is used for:
 195  memos,
 196  letters,
 197  dissertations and theses,
 198  lecture notes,
 199  seminar notebooks,
 200  conference proceedings,
 201  software documentation,
 202  books,
 203  articles in refereed scientific journals,
 204  scripts for plays and movies,
 205  business proposals,
 206  presentations \SpecialChar ldots
 207
 208 \end_layout
 209
 210 \begin_layout Standard
 211
 212 \change_deleted 1660427103 1670920569
 213 \SpecialChar LyX
 214  is a program that provides a modern approach to writing documents with a computer by using a markup language paradigm,
 215  an approach that breaks with the obsolete tradition of the
 216 \begin_inset Quotes eld
 217 \end_inset
 218
 219 typewriter concept
 220 \begin_inset Quotes erd
 221 \end_inset
 222
 223 .
 224  It is designed for authors who want professional output quickly with a minimum of effort and without becoming specialists in typesetting.
 225  The job of typesetting is done mostly by the computer,
 226  not the author;
 227  with \SpecialChar LyX
 228 ,
 229  the author can concentrate on the contents of his writing.
 230 \end_layout
 231
 232 \begin_layout Standard
 233 Part of the initial challenge of using \SpecialChar LyX
 234  comes from the change in thinking that you,
 235  the user,
 236  must make.
 237  At one time,
 238  all we had for creating documents were typewriters,
 239  so we all learned certain tricks to get around their limitations.
 240  Underlining,
 241  which is little more than overstriking with the
 242 \begin_inset Quotes eld
 243 \end_inset
 244
 245 _
 246 \begin_inset Quotes erd
 247 \end_inset
 248
 249  character,
 250  became a way to emphasize text.
 251  You were forced to figure out column sizes and tab stops,
 252  and set them,
 253  before creating a table.
 254  The same applied for letters and other right justified text.
 255  Hyphenation at the end of a line required a careful eye and a lot of foresight.
 256 \end_layout
 257
 258 \begin_layout Standard
 259 In other words,
 260  we've all been trained to worry about the little details of which character goes where.
 261  Consequently,
 262  almost all word processors have this mentality.
 263  They still use tab stops for adding whitespace.
 264  You still need to worry about exactly where on the page something will appear.
 265  Emphasizing text means changing a font,
 266  similar to changing the typewriter wheel.
 267  This is the underlying philosophy of a WYSIWYG word processor:
 268
 269 \begin_inset Quotes eld
 270 \end_inset
 271
 272 What You See Is What You Get
 273 \begin_inset Quotes erd
 274 \end_inset
 275
 276 .
 277  Unfortunately,
 278  that paradigm often results in
 279 \begin_inset Quotes eld
 280 \end_inset
 281
 282 What You See Is All You Get
 283 \begin_inset Quotes erd
 284 \end_inset
 285
 286 .
 287 \end_layout
 288
 289 \begin_layout Standard
 290 This is where \SpecialChar LyX
 291  differs from an ordinary word processor.
 292  You don't concern yourself with what character goes where.
 293  You tell \SpecialChar LyX
 294
 295 \emph on
 296 what you're doing
 297 \emph default
 298  and \SpecialChar LyX
 299  takes care of the rest,
 300  following a set of rules called a
 301 \emph on
 302 style
 303 \emph default
 304 .
 305 \change_deleted 1660427103 1670920570
 306
 307 \begin_inset Foot
 308 status collapsed
 309
 310 \begin_layout Plain Layout
 311 To be fair,
 312  most recent versions of the most popular office suites now have some sort of style sheets which follow a similar markup method.
 313  However,
 314  our experience is that they are still rarely used in practice.
 315 \end_layout
 316
 317 \end_inset
 318
 319
 320 \change_unchanged
 321  Let's look at a little example:
 322 \end_layout
 323
 324 \begin_layout Standard
 325 Suppose you are writing a report.
 326  To begin your report,
 327  you want a section called
 328 \begin_inset Quotes eld
 329 \end_inset
 330
 331 Introduction\SpecialChar endofsentence
 332
 333 \begin_inset Quotes erd
 334 \end_inset
 335
 336  So,
 337  you go into whatever menu it is in your word processor that changes font sizes and decide on a new font size.
 338  Then you turn on bold face.
 339  Then you type,
 340
 341 \begin_inset Quotes eld
 342 \end_inset
 343
 344 1.
 345 \begin_inset space ~
 346 \end_inset
 347
 348
 349 \begin_inset space ~
 350 \end_inset
 351
 352 Introduction
 353 \begin_inset Quotes erd
 354 \end_inset
 355
 356 .
 357  Of course,
 358  if you later decide that this section belongs someplace else in the document or if you insert a new section before it,
 359  you need to change the numbering for this and all following sections,
 360  as well as any entry in the table of contents.
 361 \end_layout
 362
 363 \begin_layout Standard
 364 In \SpecialChar LyX
 365 ,
 366  you go to the pull-down on the far left of the button bar and select
 367 \family sans
 368 Section
 369 \family default
 370 ,
 371  and type
 372 \begin_inset Quotes eld
 373 \end_inset
 374
 375 Introduction
 376 \begin_inset Quotes erd
 377 \end_inset
 378
 379 .
 380 \end_layout
 381
 382 \begin_layout Standard
 383 Yes,
 384  that's all.
 385  If you cut and paste the section,
 386  it will automatically be renumbered —
 387  everywhere.
 388  And if you enter references to that section correctly (by inserting cross-reference tags),
 389  \SpecialChar LyX
 390  will automatically update them all throughout the file so that you never,
 391  ever type a section number.
 392 \end_layout
 393
 394 \begin_layout Standard
 395 Now let's look at the problem of consistency.
 396  Five days later,
 397  you reopen your report and start Section
 398 \begin_inset space ~
 399 \end_inset
 400
 401 4.
 402  However,
 403  you forget that you were using 18
 404 \begin_inset space \thinspace{}
 405 \end_inset
 406
 407 pt bold instead of 16
 408 \begin_inset space \thinspace{}
 409 \end_inset
 410
 411 pt,
 412  so you type in the heading for Section
 413 \begin_inset space ~
 414 \end_inset
 415
 416 4 in a different font from the one you used for Section
 417 \begin_inset space ~
 418 \end_inset
 419
 420 1.
 421  That problem doesn't even exist in \SpecialChar LyX
 422 .
 423  The computer takes care of all that silly bookkeeping about which thing has what size font,
 424  not you.
 425  After all,
 426  that's what a computer is good at.
 427 \end_layout
 428
 429 \begin_layout Standard
 430 Here's another example.
 431  Suppose you're making a list.
 432  In other word processors,
 433  a list is just a bunch of tab stops and newlines.
 434  You need to figure out where to put the label for each list item,
 435  what that label should be,
 436  how many blank lines to put between each item,
 437  and so on.
 438  Under \SpecialChar LyX
 439 ,
 440  you have only two concerns:
 441  what kind of list is this,
 442  and what do I want to put in it?
 443  That is it.
 444 \end_layout
 445
 446 \begin_layout Standard
 447 So,
 448  the basic idea behind \SpecialChar LyX
 449  is:
 450  specify
 451 \emph on
 452 what
 453 \emph default
 454  you're doing,
 455  not
 456 \emph on
 457 how
 458 \emph default
 459  to do it.
 460  Instead of
 461 \begin_inset Quotes eld
 462 \end_inset
 463
 464 What You See Is What You Get,
 465 \begin_inset Quotes erd
 466 \end_inset
 467
 468  the \SpecialChar LyX
 469  model is
 470 \begin_inset Quotes eld
 471 \end_inset
 472
 473 What You See Is What You
 474 \emph on
 475 Mean
 476 \emph default
 477
 478 \begin_inset Quotes erd
 479 \end_inset
 480
 481  or
 482 \begin_inset Quotes eld
 483 \end_inset
 484
 485 WYSIWYM.
 486 \begin_inset Quotes erd
 487 \end_inset
 488
 489  It's a powerful idea that greatly simplifies the mechanics of writing documents.
 490  This is also why \SpecialChar LyX
 491  isn't so good for creating posters and flyers.
 492  In this case,
 493  you
 494 \emph on
 495 do
 496 \emph default
 497  want to specify exactly where everything goes,
 498  because there are no functional units like paragraphs,
 499  sections,
 500  etc.
 501  This doesn't mean \SpecialChar LyX
 502  is missing some cool function.
 503  It simply means that it isn't the right tool for the job —
 504  you don't use a screwdriver to dr
 505 \change_inserted 1660427103 1670920570
 506 ive in nails.
 507 \end_layout
 508
 509 \begin_layout Standard
 510
 511 \change_inserted 1660427103 1670920570
 512 Yes,
 513  that's all.
 514  If you cut and paste the section,
 515  it will automat
 516 \change_unchanged
 517 i
 518 \change_inserted 1660427103 1670920570
 519 cally be renumbered —
 520  e
 521 \change_unchanged
 522 v
 523 \change_inserted 1660427103 1670920570
 524 erywhere.
 525  And if you enter references to that section corr
 526 \change_unchanged
 527 e
 528 \change_inserted 1660427103 1670920570
 529 ctly (by
 530 \change_unchanged
 531  in
 532 \change_inserted 1660427103 1670920570
 533 serting
 534 \change_unchanged
 535
 536 \change_inserted 1660427103 1670920570
 537 cross-refere
 538 \change_unchanged
 539 n
 540 \change_inserted 1660427103 1670920570
 541 ce t
 542 \change_unchanged
 543 a
 544 \change_inserted 1660427103 1670920570
 545 gs),
 546  \SpecialChar LyX
 547  will automatically update them all throughout the f
 548 \change_unchanged
 549 il
 550 \change_inserted 1660427103 1670920570
 551 e
 552 \change_unchanged
 553 s
 554 \change_inserted 1660427103 1670920570
 555 o that you never,
 556  ever type a section number
 557 \change_unchanged
 558 .
 559 \end_layout
 560
 561 \begin_layout Subsection
 562 Differences between \SpecialChar LyX
 563  and Other
 564 \change_inserted 1660427103 1670920570
 565 (Crappy)
 566 \change_unchanged
 567 Word Processors
 568 \end_layout
 569
 570 \begin_layout Standard
 571 Here's a list of things you won't find in \SpecialChar LyX
 572 :
 573 \end_layout
 574
 575 \begin_layout Itemize
 576 The document ruler
 577 \end_layout
 578
 579 \begin_layout Itemize
 580 Tab stops
 581 \end_layout
 582
 583 \begin_layout Itemize
 584 Extra whitespace (e.
 585 \begin_inset space \thinspace{}
 586 \end_inset
 587
 588 g.
 589 \begin_inset space \space{}
 590 \end_inset
 591
 592 hitting
 593 \family sans
 594 Enter
 595 \family default
 596  or
 597 \family sans
 598 Space
 599 \family default
 600  two or more times)
 601 \end_layout
 602
 603 \begin_layout Standard
 604 Tab stops,
 605  along with a ruler showing you the position of things on the page,
 606  are useless in \SpecialChar LyX
 607 .
 608  The program worries about where things go on the page,
 609  not you.
 610  Extra whitespace is similar;
 611  \SpecialChar LyX
 612  adds it where necessary,
 613  depending on context.
 614  Not being able to type two blank lines in a row will be annoying at first,
 615  but it makes more sense once you're thinking in WYSIWYM terms.
 616 \end_layout
 617
 618 \begin_layout Standard
 619 Here are some things that exist in \SpecialChar LyX
 620 ,
 621  but aren't used as you might think:
 622 \end_layout
 623
 624 \begin_layout Itemize
 625 Indenting controls
 626 \end_layout
 627
 628 \begin_layout Itemize
 629 Page breaks
 630 \end_layout
 631
 632 \begin_layout Itemize
 633 Line spacing (e.
 634 \begin_inset space \thinspace{}
 635 \end_inset
 636
 637 g.
 638 \begin_inset space \space{}
 639 \end_inset
 640
 641 single spaced,
 642  double spaced,
 643  etc.)
 644 \end_layout
 645
 646 \begin_layout Itemize
 647 Whitespace,
 648  horizontal and vertical
 649 \end_layout
 650
 651 \begin_layout Itemize
 652 Fonts and font sizes
 653 \end_layout
 654
 655 \begin_layout Itemize
 656 Typefaces (bold,
 657  italic,
 658  underline,
 659  etc.)
 660 \end_layout
 661
 662 \begin_layout Standard
 663 Although they exist in \SpecialChar LyX
 664 ,
 665  you generally don't need them.
 666  \SpecialChar LyX
 667  will take care of these things for you,
 668  depending on what you're doing.
 669  Different parts of the document are automatically set in a different typeface and font size.
 670  Paragraph indenting is context dependent;
 671  different types of paragraphs get indented differently.
 672  Page breaks get handled automatically,
 673  as well.
 674  In general,
 675  the space between lines,
 676  between words,
 677  and between paragraphs is variable,
 678  set by \SpecialChar LyX
 679 .
 680 \begin_inset Foot
 681 status collapsed
 682
 683 \begin_layout Plain Layout
 684 There are ways to adjust all of these (only some of which require knowledge of \SpecialChar LaTeX
 685 ),
 686  either for a whole document or for a specific location in a document.
 687  See the
 688 \emph on
 689 User's Guide
 690 \emph default
 691  and/or the
 692 \emph on
 693 Additional Features
 694 \emph default
 695  manual for details.
 696 \end_layout
 697
 698 \end_inset
 699
 700
 701 \end_layout
 702
 703 \begin_layout Standard
 704 Lastly,
 705  there are a few areas where we believe \SpecialChar LyX
 706  (and \SpecialChar LaTeX
 707 ) surpasses many word processors:
 708 \end_layout
 709
 710 \begin_layout Itemize
 711 Hyphenation
 712 \end_layout
 713
 714 \begin_layout Itemize
 715 Lists of any type
 716 \end_layout
 717
 718 \begin_layout Itemize
 719 Mathematics
 720 \end_layout
 721
 722 \begin_layout Itemize
 723 Tables
 724 \end_layout
 725
 726 \begin_layout Itemize
 727 Cross-referencing
 728 \end_layout
 729
 730 \begin_layout Standard
 731 Granted,
 732  many modern word processors can handle mathematical symbols,
 733  tables,
 734  and hyphenation,
 735  and many have moved towards style definitions and the WYSIWYM concept.
 736  However,
 737  they've only recently been able to do so,
 738  whereas \SpecialChar LyX
 739  is built upon the \SpecialChar LaTeX
 740  document preparation system.
 741  \SpecialChar LaTeX
 742  has been around since 1985,
 743  and
 744 \emph on
 745 works
 746 \emph default
 747 .
 748 \end_layout
 749
 750 \begin_layout Subsection
 751 What is \SpecialChar LaTeX
 752 ?
 753 \end_layout
 754
 755 \begin_layout Standard
 756 \SpecialChar LaTeX
 757  is a document preparation system designed by Leslie Lamport in 1985.
 758 \begin_inset Foot
 759 status collapsed
 760
 761 \begin_layout Plain Layout
 762 The source for the info in this section is
 763 \emph on
 764 A Guide to \SpecialChar LaTeX2e
 765
 766 \emph default
 767 ,
 768  by Helmut Kopka and Patrick Daly,
 769  which has an entry in the bibliography of the
 770 \emph on
 771 User's Guide
 772 \emph default
 773 \SpecialChar endofsentence
 774
 775 \end_layout
 776
 777 \end_inset
 778
 779  It was built up from a typesetting language called \SpecialChar TeX
 780 ,
 781  created by Donald Knuth in 1984.
 782  \SpecialChar TeX
 783  takes a sequence of typesetting commands,
 784  written in a script in an ASCII file,
 785  and executes them.
 786  Many of the
 787 \begin_inset Quotes eld
 788 \end_inset
 789
 790 tricks
 791 \begin_inset Quotes erd
 792 \end_inset
 793
 794  of the printing trade were modeled by Knuth as computer algorithms and incorporated into \SpecialChar TeX
 795 ,
 796  hence its excellent printed appearance.
 797  What comes directly out of \SpecialChar TeX
 798  is the portable document format
 799 \emph on
 800 pdf
 801 \emph default
 802  or the so-called
 803 \begin_inset Quotes eld
 804 \end_inset
 805
 806 device independent
 807 \begin_inset Quotes erd
 808 \end_inset
 809
 810  format file
 811 \emph on
 812 dvi
 813 \emph default
 814 .
 815  The dvi format is often used for previews and can later be converted to other formats like PostScript.
 816
 817 \end_layout
 818
 819 \begin_layout Standard
 820 \SpecialChar TeX
 821  isn't only a typesetting engine;
 822  it also allows you to define macros.
 823  Most people who use \SpecialChar TeX
 824  are actually using a macro package which Knuth created to hide a lot of the typesetting details.
 825  This is where Leslie Lamport enters our story.
 826  He wanted a macro package that was more user- and less typesetter-oriented,
 827  with a set of commands that consistently typeset things like sections,
 828  tables or math formulas in a uniform,
 829  consistent fashion.
 830  This is how \SpecialChar LaTeX
 831  was born.
 832 \end_layout
 833
 834 \begin_layout Standard
 835 Now,
 836  in parallel with the development and growth of \SpecialChar LaTeX
 837 ,
 838  other folks were creating their own custom macro packages for \SpecialChar TeX
 839 ,
 840  ones to make slides or articles for math journals and so on.
 841  Some used the raw \SpecialChar TeX
 842  facilities to do this,
 843  others began modifying \SpecialChar LaTeX
 844 .
 845  To try and unify this mess,
 846  a team of \SpecialChar LaTeX
 847 -nicians began to work on \SpecialChar LaTeX2e
 848 ,
 849  the current version of \SpecialChar LaTeX
 850 ,
 851  during the late 1980's.
 852  This new version of \SpecialChar LaTeX
 853  has commands which provide an easier-to-use interface to \SpecialChar TeX
 854 's macro-creating commands,
 855  aid in the use of new fonts,
 856  and so on.
 857  In fact,
 858  \SpecialChar LaTeX
 859  is quite an extensive language in its own right!
 860  Users around the world have been creating their own add-ons for \SpecialChar LaTeX
 861  beyond the standard ones.
 862 \end_layout
 863
 864 \begin_layout Standard
 865 There are two ways to extend \SpecialChar LaTeX
 866 :
 867  classes and styles.
 868  A
 869 \emph on
 870 class
 871 \emph default
 872  is a set of \SpecialChar LaTeX
 873  macros describing a new type of document,
 874  like a book,
 875  or an article.
 876  There are classes for slides,
 877  for physics and math journals\SpecialChar ldots
 878  many universities even have a class for their thesis format.
 879  A
 880 \emph on
 881 style
 882 \emph default
 883  differs from a class in that it doesn't define a new type of document,
 884  but a different type of
 885 \emph on
 886 behavior
 887 \emph default
 888  that any document can use.
 889  For example,
 890  \SpecialChar LyX
 891  controls page margins and line spacing using two different \SpecialChar LaTeX
 892  style-files designed for these purposes.
 893  There are style-files for a whole slew of things:
 894  printing labels or envelopes,
 895  changing indentation behavior,
 896  adding new fonts,
 897  manipulating graphics,
 898  designing fancy page headings,
 899  customizing bibliographies,
 900  altering the location and appearance of footnotes,
 901  tables,
 902  and figures,
 903  customizing lists,
 904  etc.
 905 \end_layout
 906
 907 \begin_layout Standard
 908 Here is a summary:
 909 \end_layout
 910
 911 \begin_layout Description
 912 \SpecialChar TeX
 913 :
 914  Typesetting language with macro capability.
 915 \end_layout
 916
 917 \begin_layout Description
 918 \SpecialChar LaTeX
 919 :
 920  Macro package built upon \SpecialChar TeX
 921 \SpecialChar endofsentence
 922
 923 \end_layout
 924
 925 \begin_layout Description
 926 classes:
 927  Descriptions of types of document used with \SpecialChar LaTeX
 928 \SpecialChar endofsentence
 929
 930 \end_layout
 931
 932 \begin_layout Description
 933 styles:
 934  Descriptions of the default behavior of particular elements of \SpecialChar LaTeX
 935 .
 936 \end_layout
 937
 938 \begin_layout Description
 939 \SpecialChar LyX
 940 :
 941  Visual,
 942  WYSIWYM document processor that uses \SpecialChar LaTeX
 943  to do its typesetting.
 944 \end_layout
 945
 946 \begin_layout Standard
 947 This section attempts to explain the difference between \SpecialChar LyX
 948  and a word processor.
 949  Simply put,
 950  \SpecialChar LaTeX
 951  is the difference.
 952  By using \SpecialChar LaTeX
 953  as its backend,
 954  \SpecialChar LyX
 955  helps you to think more about
 956 \emph on
 957  what
 958 \emph default
 959  (as in the
 960 \emph on
 961 words
 962 \emph default
 963 ) you write.
 964  The computer then handles
 965 \emph on
 966 how
 967 \emph default
 968  they should look.
 969 \end_layout
 970
 971 \begin_layout Section
 972 Navigating the Documentation
 973 \end_layout
 974
 975 \begin_layout Standard
 976 To make it easier to answer your questions and describe all of the features of \SpecialChar LyX
 977 ,
 978  the documentation has been split up into several different files.
 979  Each one has its own purpose,
 980  as described below.
 981  Before you go ploughing into any of those files,
 982  however,
 983  you should read this chapter thoroughly,
 984  since it contains a lot of useful information and commentary that can save you some time.
 985 \end_layout
 986
 987 \begin_layout Standard
 988 Hopefully,
 989  the development of \SpecialChar LyX
 990  will never stop;
 991  so some of the documentation may be incomplete or a bit out of date,
 992  though we try to keep up-to-date.
 993  Like the rest of \SpecialChar LyX
 994 ,
 995  the manuals are the work of a group of volunteers who have
 996 \begin_inset Quotes eld
 997 \end_inset
 998
 999 Real Jobs
1000 \begin_inset Quotes erd
1001 \end_inset
1002
1003 ,
1004  families,
1005  dishes to clean,
1006
1007 \emph on
1008 et cetera
1009 \emph default
1010 .
1011  If you want to help out,
1012  be sure to read Section
1013 \begin_inset space ~
1014 \end_inset
1015
1016
1017 \begin_inset CommandInset ref
1018 LatexCommand ref
1019 reference "sec:Contrib"
1020 nolink "false"
1021
1022 \end_inset
1023
1024  in addition to the rest of this document.
1025 \end_layout
1026
1027 \begin_layout Standard
1028 Also,
1029  please do us a favor – if anything in these manuals confuses you,
1030  is unclear,
1031  or wrong,
1032  don't hesitate to let us know!
1033  You can reach the current document maintainers by emailing
1034 \begin_inset CommandInset href
1035 LatexCommand href
1036 target "lyx-docs@lists.lyx.org"
1037 type "mailto:"
1038 literal "false"
1039
1040 \end_inset
1041
1042 .
1043  If you have questions that are not obviously answered in the documentation,
1044  and need help fast,
1045  there is an active users' mailing list which you can reach at
1046 \begin_inset CommandInset href
1047 LatexCommand href
1048 target "lyx-users@lists.lyx.org"
1049 type "mailto:"
1050 literal "false"
1051
1052 \end_inset
1053
1054 .
1055 \end_layout
1056
1057 \begin_layout Subsection
1058 The Format of the Manuals
1059 \end_layout
1060
1061 \begin_layout Standard
1062 Some of you may have printed out the manuals.
1063  Others may be reading them within \SpecialChar LyX
1064 .
1065  There are some differences between the \SpecialChar LyX
1066 -file and the printed version.
1067  In \SpecialChar LyX
1068 ,
1069  the title is simply at the top of the document,
1070  not formatted on a separate page as in some of the printed versions.
1071  Nor are any of the footnotes or the Table of Contents fully visible.
1072  To open a footnote,
1073  which looks like this:
1074
1075 \begin_inset Graphics
1076         filename ../../../../lib/doc/clipart/footnote.png
1077         scale 95
1078
1079 \end_inset
1080
1081 ,
1082  click on it with the left mouse button.
1083  For the Table of Contents,
1084  either click on the grey box or click on the
1085 \family sans
1086 Navigate
1087 \family default
1088  menu,
1089  where the contents are displayed automatically\SpecialChar endofsentence
1090
1091 \end_layout
1092
1093 \begin_layout Standard
1094 In the printed manuals,
1095  all cross-references appear as the actual numbers for a chapter,
1096  section,
1097  subsection,
1098  and so on.
1099  In the \SpecialChar LyX
1100 -file,
1101  however,
1102  all cross-references appear as light-grey boxes like the following:
1103
1104 \begin_inset Graphics
1105         filename ../../../../lib/doc/clipart/reference.png
1106         scale 95
1107
1108 \end_inset
1109
1110 .
1111  If you click on such a box with the left mouse button,
1112  a dialog box will appear containing a list of all the cross-references in the document.
1113  You can go to the referenced section by right-clicking on the box or by clicking the button
1114 \family sans
1115 Go
1116 \begin_inset space ~
1117 \end_inset
1118
1119 to
1120 \begin_inset space ~
1121 \end_inset
1122
1123 Label
1124 \family default
1125  in the opened dialog.
1126  Going back to where you came from is just as easy.
1127  Click on
1128 \family sans
1129 Go
1130 \begin_inset space ~
1131 \end_inset
1132
1133 Back
1134 \family default
1135  to go back to your earlier location.
1136 \end_layout
1137
1138 \begin_layout Standard
1139 Now that we've cleared up some of the differences between the printed and \SpecialChar LyX
1140 -file versions of this file,
1141  we can start looking at the format of this document.
1142  You'll occasionally notice things in different fonts:
1143 \end_layout
1144
1145 \begin_layout Itemize
1146
1147 \emph on
1148 Emphasized Style
1149 \emph default
1150  is used for general emphasis,
1151  generic arguments,
1152  book titles,
1153  names of sections of other manuals,
1154  and notes from the authors.
1155 \end_layout
1156
1157 \begin_layout Itemize
1158
1159 \family typewriter
1160 Typewriter
1161 \family default
1162  is used for program and file names,
1163  \SpecialChar LyX
1164  code and functions.
1165 \end_layout
1166
1167 \begin_layout Itemize
1168
1169 \family sans
1170 Sans Serif
1171 \family default
1172  is used for menu,
1173  button,
1174  or dialog box names,
1175  and the names of keyboard keys.
1176 \end_layout
1177
1178 \begin_layout Itemize
1179
1180 \noun on
1181 Noun Style
1182 \noun default
1183  is used for people's names.
1184 \end_layout
1185
1186 \begin_layout Itemize
1187
1188 \series bold
1189 Bold
1190 \series default
1191  is used for \SpecialChar LaTeX
1192  code
1193 \end_layout
1194
1195 \begin_layout Standard
1196 When we do need to reference keys,
1197  we'll use the following prefixing convention:
1198 \end_layout
1199
1200 \begin_layout Itemize
1201 \begin_inset Quotes eld
1202 \end_inset
1203
1204
1205 \family sans
1206 Ctrl+
1207 \family default
1208
1209 \begin_inset Quotes erd
1210 \end_inset
1211
1212  indicates the
1213 \family sans
1214 Control
1215 \family default
1216  key.
1217 \end_layout
1218
1219 \begin_layout Itemize
1220 \begin_inset Quotes eld
1221 \end_inset
1222
1223
1224 \family sans
1225 Shift+
1226 \family default
1227
1228 \begin_inset Quotes erd
1229 \end_inset
1230
1231  indicates the
1232 \family sans
1233 Shift
1234 \family default
1235  key.
1236 \end_layout
1237
1238 \begin_layout Itemize
1239 \begin_inset Quotes eld
1240 \end_inset
1241
1242
1243 \family sans
1244 Alt+
1245 \family default
1246
1247 \begin_inset Quotes erd
1248 \end_inset
1249
1250  indicates the
1251 \family sans
1252 Alt
1253 \family default
1254  (
1255 \family sans
1256 Meta
1257 \family default
1258 ) key.
1259 \end_layout
1260
1261 \begin_layout Itemize
1262 \begin_inset Quotes eld
1263 \end_inset
1264
1265
1266 \family sans
1267 F1
1268 \family default
1269
1270 \begin_inset Quotes erd
1271 \end_inset
1272
1273  \SpecialChar ldots
1274
1275 \begin_inset Quotes eld
1276 \end_inset
1277
1278
1279 \family sans
1280 F12
1281 \family default
1282
1283 \begin_inset Quotes erd
1284 \end_inset
1285
1286  are the function keys.
1287 \end_layout
1288
1289 \begin_layout Itemize
1290 \begin_inset Quotes eld
1291 \end_inset
1292
1293
1294 \family sans
1295 Esc
1296 \family default
1297
1298 \begin_inset Quotes erd
1299 \end_inset
1300
1301  is the escape key.
1302 \end_layout
1303
1304 \begin_layout Itemize
1305 \begin_inset Quotes eld
1306 \end_inset
1307
1308
1309 \family sans
1310 Left
1311 \family default
1312
1313 \begin_inset Quotes erd
1314 \end_inset
1315
1316
1317 \begin_inset Quotes eld
1318 \end_inset
1319
1320
1321 \family sans
1322 Right
1323 \family default
1324
1325 \begin_inset Quotes erd
1326 \end_inset
1327
1328
1329 \begin_inset Quotes eld
1330 \end_inset
1331
1332
1333 \family sans
1334 Up
1335 \family default
1336
1337 \begin_inset Quotes erd
1338 \end_inset
1339
1340
1341 \begin_inset Quotes eld
1342 \end_inset
1343
1344
1345 \family sans
1346 Down
1347 \family default
1348
1349 \begin_inset Quotes erd
1350 \end_inset
1351
1352 :
1353  self-explanatory.
1354 \end_layout
1355
1356 \begin_layout Itemize
1357
1358 \family sans
1359 \begin_inset Quotes eld
1360 \end_inset
1361
1362 Insert
1363 \family default
1364
1365 \begin_inset Quotes erd
1366 \end_inset
1367
1368
1369 \begin_inset Quotes eld
1370 \end_inset
1371
1372
1373 \family sans
1374 Delete
1375 \family default
1376
1377 \begin_inset Quotes erd
1378 \end_inset
1379
1380
1381 \begin_inset Quotes eld
1382 \end_inset
1383
1384
1385 \family sans
1386 Home
1387 \family default
1388
1389 \begin_inset Quotes erd
1390 \end_inset
1391
1392
1393 \begin_inset Quotes eld
1394 \end_inset
1395
1396
1397 \family sans
1398 End
1399 \family default
1400
1401 \begin_inset Quotes erd
1402 \end_inset
1403
1404
1405 \begin_inset Quotes eld
1406 \end_inset
1407
1408
1409 \family sans
1410 PageUp
1411 \family default
1412
1413 \begin_inset Quotes erd
1414 \end_inset
1415
1416
1417 \begin_inset Quotes eld
1418 \end_inset
1419
1420
1421 \family sans
1422 PageDown
1423 \family default
1424
1425 \begin_inset Quotes erd
1426 \end_inset
1427
1428 :
1429  these are the 6
1430 \begin_inset space ~
1431 \end_inset
1432
1433 keys that appear above the cursor keys on many PC keyboards.
1434
1435 \begin_inset Quotes eld
1436 \end_inset
1437
1438
1439 \family sans
1440 PageUp
1441 \family default
1442
1443 \begin_inset Quotes erd
1444 \end_inset
1445
1446  and
1447 \begin_inset Quotes eld
1448 \end_inset
1449
1450
1451 \family sans
1452 PageDown
1453 \family default
1454
1455 \begin_inset Quotes erd
1456 \end_inset
1457
1458  are called
1459 \begin_inset Quotes eld
1460 \end_inset
1461
1462
1463 \family sans
1464 Prior
1465 \family default
1466
1467 \begin_inset Quotes erd
1468 \end_inset
1469
1470  and
1471 \begin_inset Quotes eld
1472 \end_inset
1473
1474
1475 \family sans
1476 Next
1477 \family default
1478
1479 \begin_inset Quotes erd
1480 \end_inset
1481
1482  on some keyboards.
1483 \end_layout
1484
1485 \begin_layout Itemize
1486
1487 \family sans
1488 Return
1489 \family default
1490  and
1491 \family sans
1492 Enter
1493 \family default
1494  both refer to the same key.
1495  Some keyboards label the
1496 \family sans
1497 Return
1498 \family default
1499  key as
1500 \begin_inset Quotes eld
1501 \end_inset
1502
1503 Return,
1504 \begin_inset Quotes erd
1505 \end_inset
1506
1507  others as
1508 \begin_inset Quotes eld
1509 \end_inset
1510
1511 Enter,
1512 \begin_inset Quotes erd
1513 \end_inset
1514
1515  still others have two keys.
1516  \SpecialChar LyX
1517  treats all of them as the same key,
1518  so we'll use
1519 \family sans
1520 Return
1521 \family default
1522  and
1523 \family sans
1524 Enter
1525 \family default
1526  interchangeably.
1527 \end_layout
1528
1529 \begin_layout Standard
1530 The list with the currently set shortcuts can be found in the
1531 \family sans
1532 Help
1533 \family default
1534  menu under
1535 \family sans
1536 Shortcuts
1537 \family default
1538 .
1539 \end_layout
1540
1541 \begin_layout Subsection
1542 Units used in the Manuals
1543 \end_layout
1544
1545 \begin_layout Standard
1546 To understand the units described in this documentation,
1547  Table
1548 \begin_inset space ~
1549 \end_inset
1550
1551
1552 \begin_inset CommandInset ref
1553 LatexCommand ref
1554 reference "tab:Units"
1555 nolink "false"
1556
1557 \end_inset
1558
1559  explains all units available in \SpecialChar LyX
1560 .
1561 \end_layout
1562
1563 \begin_layout Standard
1564 \begin_inset Float table
1565 placement document
1566 alignment document
1567 wide false
1568 sideways false
1569 status open
1570
1571 \begin_layout Plain Layout
1572 \begin_inset Caption Standard
1573
1574 \begin_layout Plain Layout
1575 \begin_inset CommandInset label
1576 LatexCommand label
1577 name "tab:Units"
1578
1579 \end_inset
1580
1581 Units
1582 \end_layout
1583
1584 \end_inset
1585
1586
1587 \end_layout
1588
1589 \begin_layout Plain Layout
1590 \begin_inset VSpace medskip
1591 \end_inset
1592
1593
1594 \end_layout
1595
1596 \begin_layout Plain Layout
1597 \align center
1598 \begin_inset Tabular
1599 <lyxtabular version="3" rows="20" columns="2">
1600 <features booktabs="true" tabularvalignment="middle">
1601 <column alignment="center" valignment="top" width="0pt">
1602 <column alignment="center" valignment="top">
1603 <row>
1604 <cell alignment="center" valignment="top" topline="true" bottomline="true" usebox="none">
1605 \begin_inset Text
1606
1607 \begin_layout Plain Layout
1608 unit
1609 \end_layout
1610
1611 \end_inset
1612 </cell>
1613 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
1614 \begin_inset Text
1615
1616 \begin_layout Plain Layout
1617 name/description
1618 \end_layout
1619
1620 \end_inset
1621 </cell>
1622 </row>
1623 <row>
1624 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1625 \begin_inset Text
1626
1627 \begin_layout Plain Layout
1628 mm
1629 \end_layout
1630
1631 \end_inset
1632 </cell>
1633 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1634 \begin_inset Text
1635
1636 \begin_layout Plain Layout
1637 millimeter
1638 \end_layout
1639
1640 \end_inset
1641 </cell>
1642 </row>
1643 <row>
1644 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1645 \begin_inset Text
1646
1647 \begin_layout Plain Layout
1648 cm
1649 \end_layout
1650
1651 \end_inset
1652 </cell>
1653 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1654 \begin_inset Text
1655
1656 \begin_layout Plain Layout
1657 centimeter
1658 \end_layout
1659
1660 \end_inset
1661 </cell>
1662 </row>
1663 <row>
1664 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1665 \begin_inset Text
1666
1667 \begin_layout Plain Layout
1668 in
1669 \end_layout
1670
1671 \end_inset
1672 </cell>
1673 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1674 \begin_inset Text
1675
1676 \begin_layout Plain Layout
1677 inch (1
1678 \begin_inset space \thinspace{}
1679 \end_inset
1680
1681 in = 2.54
1682 \begin_inset space \thinspace{}
1683 \end_inset
1684
1685 cm)
1686 \end_layout
1687
1688 \end_inset
1689 </cell>
1690 </row>
1691 <row>
1692 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1693 \begin_inset Text
1694
1695 \begin_layout Plain Layout
1696 pt
1697 \end_layout
1698
1699 \end_inset
1700 </cell>
1701 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1702 \begin_inset Text
1703
1704 \begin_layout Plain Layout
1705 point (72.27
1706 \begin_inset space \thinspace{}
1707 \end_inset
1708
1709 pt = 1
1710 \begin_inset space \thinspace{}
1711 \end_inset
1712
1713 in)
1714 \end_layout
1715
1716 \end_inset
1717 </cell>
1718 </row>
1719 <row>
1720 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1721 \begin_inset Text
1722
1723 \begin_layout Plain Layout
1724 pc
1725 \end_layout
1726
1727 \end_inset
1728 </cell>
1729 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1730 \begin_inset Text
1731
1732 \begin_layout Plain Layout
1733 pica (1
1734 \begin_inset space \thinspace{}
1735 \end_inset
1736
1737 pc = 12
1738 \begin_inset space \thinspace{}
1739 \end_inset
1740
1741 pt)
1742 \end_layout
1743
1744 \end_inset
1745 </cell>
1746 </row>
1747 <row>
1748 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1749 \begin_inset Text
1750
1751 \begin_layout Plain Layout
1752 sp
1753 \end_layout
1754
1755 \end_inset
1756 </cell>
1757 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1758 \begin_inset Text
1759
1760 \begin_layout Plain Layout
1761 scaled point (65536
1762 \begin_inset space \thinspace{}
1763 \end_inset
1764
1765 sp = 1
1766 \begin_inset space \thinspace{}
1767 \end_inset
1768
1769 pt)
1770 \end_layout
1771
1772 \end_inset
1773 </cell>
1774 </row>
1775 <row>
1776 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1777 \begin_inset Text
1778
1779 \begin_layout Plain Layout
1780 bp
1781 \end_layout
1782
1783 \end_inset
1784 </cell>
1785 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1786 \begin_inset Text
1787
1788 \begin_layout Plain Layout
1789 big point (72
1790 \begin_inset space \thinspace{}
1791 \end_inset
1792
1793 bp = 1
1794 \begin_inset space \thinspace{}
1795 \end_inset
1796
1797 in)
1798 \end_layout
1799
1800 \end_inset
1801 </cell>
1802 </row>
1803 <row>
1804 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1805 \begin_inset Text
1806
1807 \begin_layout Plain Layout
1808 dd
1809 \end_layout
1810
1811 \end_inset
1812 </cell>
1813 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1814 \begin_inset Text
1815
1816 \begin_layout Plain Layout
1817 didot (72
1818 \begin_inset space \thinspace{}
1819 \end_inset
1820
1821 dd
1822 \begin_inset Formula $\approx$
1823 \end_inset
1824
1825  37.6
1826 \begin_inset space \thinspace{}
1827 \end_inset
1828
1829 mm)
1830 \end_layout
1831
1832 \end_inset
1833 </cell>
1834 </row>
1835 <row>
1836 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1837 \begin_inset Text
1838
1839 \begin_layout Plain Layout
1840 cc
1841 \end_layout
1842
1843 \end_inset
1844 </cell>
1845 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1846 \begin_inset Text
1847
1848 \begin_layout Plain Layout
1849 cicero (1
1850 \begin_inset space \thinspace{}
1851 \end_inset
1852
1853 cc = 12
1854 \begin_inset space \thinspace{}
1855 \end_inset
1856
1857 dd)
1858 \end_layout
1859
1860 \end_inset
1861 </cell>
1862 </row>
1863 <row>
1864 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1865 \begin_inset Text
1866
1867 \begin_layout Plain Layout
1868 Scale%
1869 \end_layout
1870
1871 \end_inset
1872 </cell>
1873 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1874 \begin_inset Text
1875
1876 \begin_layout Plain Layout
1877 % of original image width
1878 \end_layout
1879
1880 \end_inset
1881 </cell>
1882 </row>
1883 <row>
1884 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1885 \begin_inset Text
1886
1887 \begin_layout Plain Layout
1888 text%
1889 \end_layout
1890
1891 \end_inset
1892 </cell>
1893 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1894 \begin_inset Text
1895
1896 \begin_layout Plain Layout
1897 % of text width
1898 \end_layout
1899
1900 \end_inset
1901 </cell>
1902 </row>
1903 <row>
1904 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1905 \begin_inset Text
1906
1907 \begin_layout Plain Layout
1908 col%
1909 \end_layout
1910
1911 \end_inset
1912 </cell>
1913 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1914 \begin_inset Text
1915
1916 \begin_layout Plain Layout
1917 % of column width
1918 \end_layout
1919
1920 \end_inset
1921 </cell>
1922 </row>
1923 <row>
1924 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1925 \begin_inset Text
1926
1927 \begin_layout Plain Layout
1928 page%
1929 \end_layout
1930
1931 \end_inset
1932 </cell>
1933 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1934 \begin_inset Text
1935
1936 \begin_layout Plain Layout
1937 % of paper width
1938 \end_layout
1939
1940 \end_inset
1941 </cell>
1942 </row>
1943 <row>
1944 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1945 \begin_inset Text
1946
1947 \begin_layout Plain Layout
1948 line%
1949 \end_layout
1950
1951 \end_inset
1952 </cell>
1953 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1954 \begin_inset Text
1955
1956 \begin_layout Plain Layout
1957 % of line width
1958 \end_layout
1959
1960 \end_inset
1961 </cell>
1962 </row>
1963 <row>
1964 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1965 \begin_inset Text
1966
1967 \begin_layout Plain Layout
1968 theight%
1969 \end_layout
1970
1971 \end_inset
1972 </cell>
1973 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1974 \begin_inset Text
1975
1976 \begin_layout Plain Layout
1977 % of text height
1978 \end_layout
1979
1980 \end_inset
1981 </cell>
1982 </row>
1983 <row>
1984 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
1985 \begin_inset Text
1986
1987 \begin_layout Plain Layout
1988 pheight%
1989 \end_layout
1990
1991 \end_inset
1992 </cell>
1993 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
1994 \begin_inset Text
1995
1996 \begin_layout Plain Layout
1997 % of paper height
1998 \end_layout
1999
2000 \end_inset
2001 </cell>
2002 </row>
2003 <row>
2004 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2005 \begin_inset Text
2006
2007 \begin_layout Plain Layout
2008 ex
2009 \end_layout
2010
2011 \end_inset
2012 </cell>
2013 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2014 \begin_inset Text
2015
2016 \begin_layout Plain Layout
2017 height of letter
2018 \emph on
2019 x
2020 \emph default
2021  in current font
2022 \end_layout
2023
2024 \end_inset
2025 </cell>
2026 </row>
2027 <row>
2028 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
2029 \begin_inset Text
2030
2031 \begin_layout Plain Layout
2032 em
2033 \end_layout
2034
2035 \end_inset
2036 </cell>
2037 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
2038 \begin_inset Text
2039
2040 \begin_layout Plain Layout
2041 width of letter
2042 \emph on
2043 M
2044 \emph default
2045  in current font
2046 \end_layout
2047
2048 \end_inset
2049 </cell>
2050 </row>
2051 <row>
2052 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
2053 \begin_inset Text
2054
2055 \begin_layout Plain Layout
2056 mu
2057 \end_layout
2058
2059 \end_inset
2060 </cell>
2061 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
2062 \begin_inset Text
2063
2064 \begin_layout Plain Layout
2065 math unit (1
2066 \begin_inset space \thinspace{}
2067 \end_inset
2068
2069 mu = 1/18
2070 \begin_inset space \thinspace{}
2071 \end_inset
2072
2073 em)
2074 \end_layout
2075
2076 \end_inset
2077 </cell>
2078 </row>
2079 </lyxtabular>
2080
2081 \end_inset
2082
2083
2084 \end_layout
2085
2086 \end_inset
2087
2088
2089 \end_layout
2090
2091 \begin_layout Subsection
2092 The Manuals
2093 \end_layout
2094
2095 \begin_layout Standard
2096 The following list describes the contents of the basic documentation files that you find in the
2097 \family sans
2098 Help
2099 \family default
2100  menu:
2101 \end_layout
2102
2103 \begin_layout Description
2104 Introduction This file.
2105 \end_layout
2106
2107 \begin_layout Description
2108 Tutorial If you are new to \SpecialChar LyX
2109 ,
2110  and have never used \SpecialChar LaTeX
2111  before,
2112  you should start here.
2113  If you have used \SpecialChar LaTeX
2114  before,
2115  you should still read the
2116 \emph on
2117 Tutorial
2118 \emph default
2119 ,
2120  starting with the section on
2121 \begin_inset Quotes eld
2122 \end_inset
2123
2124 \SpecialChar LyX
2125  for \SpecialChar LaTeX
2126  users.
2127 \begin_inset Quotes erd
2128 \end_inset
2129
2130  (Skimming through the rest of the document wouldn't hurt,
2131  either.)
2132 \end_layout
2133
2134 \begin_layout Description
2135 User's
2136 \begin_inset space ~
2137 \end_inset
2138
2139 Guide The primary documentation.
2140  We'll cover
2141 \emph on
2142 most
2143 \emph default
2144  of the basic operation and available features of \SpecialChar LyX
2145  here.
2146  The main manual assumes that you have read the
2147 \emph on
2148 Tutorial
2149 \emph default
2150 .
2151 \end_layout
2152
2153 \begin_layout Description
2154 Embedded
2155 \begin_inset space ~
2156 \end_inset
2157
2158 Objects Extension of the
2159 \emph on
2160 User's Guide
2161 \emph default
2162 .
2163  Documents in detail how to use tables,
2164  graphics,
2165  floats,
2166  notes,
2167  program listings and boxes.
2168  It also includes many tricks of the \SpecialChar LaTeX
2169  masters.
2170 \end_layout
2171
2172 \begin_layout Description
2173 Math Extension of the
2174 \emph on
2175 User's Guide
2176 \emph default
2177 .
2178  Documents in detail how to typeset any kind of formula.
2179 \end_layout
2180
2181 \begin_layout Description
2182 Additional
2183 \begin_inset space ~
2184 \end_inset
2185
2186 Features Extension of the
2187 \emph on
2188 User's Guide
2189 \emph default
2190 .
2191  Documents how to use raw \SpecialChar LaTeX
2192  commands,
2193  additional layouts and special-purpose editing features.
2194 \end_layout
2195
2196 \begin_layout Description
2197 Customization A description of advanced \SpecialChar LyX
2198  features,
2199  including how to customize the overall behavior of \SpecialChar LyX
2200 \SpecialChar endofsentence
2201  This includes such things as keybindings,
2202  internationalization and configuration files.
2203  It also includes information about layout files,
2204  which are needed to get \SpecialChar LyX
2205  to support \SpecialChar LaTeX
2206  classes or packages.
2207 \end_layout
2208
2209 \begin_layout Description
2210 Shortcuts Tables of the currently defined \SpecialChar LyX
2211  shortcuts.
2212 \end_layout
2213
2214 \begin_layout Description
2215 \SpecialChar LaTeX
2216
2217 \begin_inset space ~
2218 \end_inset
2219
2220 Configuration A report produced by \SpecialChar LyX
2221  about your system.
2222  This file contains information on what \SpecialChar LyX
2223  learned about your installation.
2224  Check it to see if you're missing something you might like to have.
2225 \end_layout
2226
2227 \begin_layout Standard
2228 These files will reference one another as necessary.
2229  For example,
2230  the
2231 \emph on
2232 User's Guide
2233 \emph default
2234  contains
2235 \emph on
2236 some
2237 \emph default
2238  information on installation and customization,
2239  but refers the reader to the
2240 \emph on
2241 Customization Manual
2242 \emph default
2243  for more information.
2244 \end_layout
2245
2246 \begin_layout Standard
2247 We'll state again an important point:
2248 \end_layout
2249
2250 \begin_layout Standard
2251 \begin_inset VSpace bigskip
2252 \end_inset
2253
2254
2255 \end_layout
2256
2257 \begin_layout Standard
2258 \align center
2259 If you are new to \SpecialChar LyX
2260 ,
2261  read the
2262 \emph on
2263 Tutorial
2264 \emph default
2265 .
2266  Now\SpecialChar endofsentence
2267
2268 \end_layout
2269
2270 \begin_layout Standard
2271 \begin_inset VSpace bigskip
2272 \end_inset
2273
2274
2275 \end_layout
2276
2277 \begin_layout Standard
2278 Otherwise,
2279  you could needlessly frustrate yourself.
2280 \end_layout
2281
2282 \begin_layout Section
2283 Contributing to the \SpecialChar LyX
2284  Project
2285 \begin_inset CommandInset label
2286 LatexCommand label
2287 name "sec:Contrib"
2288
2289 \end_inset
2290
2291
2292 \end_layout
2293
2294 \begin_layout Subsection
2295 Contributing to \SpecialChar LyX
2296
2297 \end_layout
2298
2299 \begin_layout Standard
2300 \SpecialChar LyX
2301  is mostly written in C++ (the \SpecialChar LaTeX
2302  importer is written in Python).
2303  It is a large project,
2304  and as a result it is not free from bugs,
2305  or the need for improvements in the source code.
2306 \end_layout
2307
2308 \begin_layout Subsubsection
2309 Reporting a bug
2310 \end_layout
2311
2312 \begin_layout Standard
2313 While using \SpecialChar LyX
2314 ,
2315  you may find behavior which you consider a bug.
2316  Crashes,
2317  though rare,
2318  can happen.
2319  User interface problems are considered major bugs by the \SpecialChar LyX
2320  team:
2321  especially helpful are indications of parts of the \SpecialChar LyX
2322  interface you find confusing,
2323  or unclear.
2324 \end_layout
2325
2326 \begin_layout Standard
2327 \SpecialChar LyX
2328  has a bug tracking system,
2329  which you can find at
2330 \begin_inset Newline newline
2331 \end_inset
2332
2333
2334 \begin_inset CommandInset href
2335 LatexCommand href
2336 target "https://www.lyx.org/trac/wiki/BugTrackerHome"
2337
2338 \end_inset
2339
2340 .
2341  You should check the bug tracker before reporting any bugs,
2342  in case it has already been reported.
2343  If you have a comment on an existing bug,
2344  or wish to report a new bug,
2345  you may either use the bug tracker,
2346  or send an e-mail to the development mailing list,
2347
2348 \begin_inset CommandInset href
2349 LatexCommand href
2350 target "lyx-devel@lists.lyx.org"
2351 type "mailto:"
2352 literal "false"
2353
2354 \end_inset
2355
2356 .
2357  Archives of this list are linked from the main \SpecialChar LyX
2358  website,
2359
2360 \begin_inset CommandInset href
2361 LatexCommand href
2362 target "http://www.lyx.org"
2363
2364 \end_inset
2365
2366 .
2367 \end_layout
2368
2369 \begin_layout Standard
2370 A useful bug report will at a minimum include the version of \SpecialChar LyX
2371  you are having the problem with.
2372  Accurate,
2373  detailed descriptions are preferred —
2374  the more time developers have to spend to pinpoint the source of a bug,
2375  the less time they have for other improvements.
2376  Mention the system and system version on which you are running \SpecialChar LyX
2377 .
2378  Give the versions of the libraries you have installed on your system,
2379  and,
2380  if relevant,
2381  the versions of external programs that \SpecialChar LyX
2382  uses.
2383  If it's a compilation or configuration problem,
2384  include the file
2385 \family typewriter
2386 config.log
2387 \family default
2388 ,
2389  and mention which compiler you are using.
2390 \end_layout
2391
2392 \begin_layout Subsubsection
2393 Contributing fixes and new features
2394 \end_layout
2395
2396 \begin_layout Standard
2397 If you have made changes to \SpecialChar LyX
2398 's source that you think should become part of \SpecialChar LyX
2399 ,
2400  send your changes as a diff file (in unified format) to the development list referenced above,
2401  along with a change log,
2402  and a description of what your patch does.
2403 \end_layout
2404
2405 \begin_layout Subsection
2406 Contributing to the Documentation
2407 \end_layout
2408
2409 \begin_layout Standard
2410 \SpecialChar LyX
2411 's documentation is extensive;
2412  however \SpecialChar LyX
2413  is under constant development,
2414  and each new release adds new features.
2415  You may find some documentation needs improvement.
2416  This section describes what to do if you find an error,
2417  or have some suggestions for improving the documentation.
2418 \end_layout
2419
2420 \begin_layout Subsubsection
2421 Reporting Errors in the Manuals
2422 \end_layout
2423
2424 \begin_layout Standard
2425 If you find a problem with the documentation,
2426  send a message to the mailing list
2427 \begin_inset CommandInset href
2428 LatexCommand href
2429 target "lyx-docs@lists.lyx.org"
2430 type "mailto:"
2431 literal "false"
2432
2433 \end_inset
2434
2435 .
2436  The documentation team will make any necessary fixes.
2437 \end_layout
2438
2439 \begin_layout Subsubsection
2440 Joining the Documentation Team.
2441 \end_layout
2442
2443 \begin_layout Standard
2444 The \SpecialChar LyX
2445  Documentation Project,
2446  like anything else in the \SpecialChar LyX
2447  project,
2448  can always use assistance!
2449  If you're interested in contributing to the Documentation Project,
2450  you need to do the following:
2451 \end_layout
2452
2453 \begin_layout Enumerate
2454 Get the latest \SpecialChar LyX
2455  source code from
2456 \begin_inset Newline newline
2457 \end_inset
2458
2459
2460 \begin_inset CommandInset href
2461 LatexCommand href
2462 target "https://www.lyx.org/trac/browser/lyxgit/lib/doc?rev=master "
2463
2464 \end_inset
2465
2466
2467 \end_layout
2468
2469 \begin_layout Enumerate
2470 Next,
2471  read the
2472 \emph on
2473 User's Guide
2474 \emph default
2475  and the
2476 \emph on
2477 Tutorial
2478 \emph default
2479
2480 \begin_inset Newline newline
2481 \end_inset
2482
2483 The point of this exercise is to give you ideas.
2484  The
2485 \emph on
2486 Tutorial
2487 \emph default
2488  and
2489 \emph on
2490 User's Guide
2491 \emph default
2492  are likely to be the most up-to-date of all of the documentation.
2493  You should be able to glean some insights into how we want the manuals to read and to look.
2494 \end_layout
2495
2496 \begin_layout Enumerate
2497 Contact the team at:
2498 \begin_inset Newline newline
2499 \end_inset
2500
2501
2502 \begin_inset CommandInset href
2503 LatexCommand href
2504 target "lyx-docs@lists.lyx.org"
2505 type "mailto:"
2506 literal "false"
2507
2508 \end_inset
2509
2510
2511 \begin_inset Newline newline
2512 \end_inset
2513
2514 to discuss your intended changes and to get some feedback on them.
2515 \end_layout
2516
2517 \begin_layout Standard
2518 The changes you wish to make may range from improving clarity of the text,
2519  to doing major re-structuring of the documentation.
2520  Any and all improvements are gladly received.
2521 \end_layout
2522
2523 \end_body
2524 \end_document