]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
Add buffer param to opt-out fragile content movement
[lyx.git] / lib / doc / UserGuide.lyx
index dd7d0a1d9ae4a0c67fa58fe4d8451b15990e8619..a514d0c21ce161cfb276948e3c9350b0e9424aab 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.4 created this file. For more info see https://www.lyx.org/
-\lyxformat 573
+\lyxformat 591
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -57,25 +57,29 @@ logicalmkup
 \maintain_unincluded_children false
 \language english
 \language_package default
-\inputencoding auto-legacy
+\inputencoding utf8
 \fontencoding auto
 \font_roman "lmodern" "default"
-\font_sans "lmss" "default"
-\font_typewriter "lmtt" "default"
+\font_sans "default" "default"
+\font_typewriter "default" "default"
 \font_math "auto" "auto"
 \font_default_family default
 \use_non_tex_fonts false
 \font_sc false
-\font_osf false
+\font_roman_osf false
+\font_sans_osf false
+\font_typewriter_osf false
 \font_sf_scale 100 100
 \font_tt_scale 100 100
 \use_microtype false
 \use_dash_ligatures false
 \graphics default
-\default_output_format pdf2
+\default_output_format default
 \output_sync 0
 \bibtex_command bibtex
-\index_command default
+\index_command makeindex
+\float_placement class
+\float_alignment class
 \paperfontsize 12
 \spacing single
 \use_hyperref true
@@ -115,6 +119,7 @@ logicalmkup
 \justification true
 \use_refstyle 1
 \use_minted 0
+\use_lineno 0
 \notefontcolor #0000ff
 \branch Question
 \selected 1
@@ -144,10 +149,15 @@ logicalmkup
 \tablestyle default
 \tracking_changes true
 \output_changes false
+\change_bars false
+\postpone_fragile_content false
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict true
+\author -1402925745 "Günter Milde"
 \author -712698321 "Jürgen Spitzmüller"
+\author -563046850 "Jean-Marc LASGOUTTES"
+\author 5863208 "ab"
 \end_header
 
 \begin_body
@@ -2336,7 +2346,15 @@ Return
 \begin_layout Standard
 The completion options for math in the preferences do the same as the correspond
 ing options for text.
- The special math option 
+\change_inserted -563046850 1560340017
+Additionally, 
+\change_deleted -563046850 1560340019
+T
+\change_inserted -563046850 1560340019
+t
+\change_unchanged
+he special math option 
 \family sans
 Autocorrection
 \family default
@@ -2366,13 +2384,56 @@ autocorrect
 \family default
  that is in \SpecialChar LyX
 's installation folder.
- Math autocorrection can at any time be turned on by pressing the exclamation
+\change_deleted -563046850 1560340086
+Math autocorrection can at any time be turned on by pressing the exclamation
  mark key “!”.
  Pressing 
 \family sans
 Space
 \family default
  turns it off.
+\change_inserted -563046850 1560340324
+Note that using 
+\family sans
+Undo
+\family default
+ after autocorrection has done its magic leaves the un-corrected sequence.
+ In the example above, 
+\family sans
+Undo
+\family default
+ leads to 
+\begin_inset Quotes eld
+\end_inset
+
+
+\series bold
+=>
+\series default
+
+\begin_inset Quotes erd
+\end_inset
+
+, and a second 
+\family sans
+Undo
+\family default
+ yields 
+\begin_inset Quotes eld
+\end_inset
+
+
+\series bold
+=
+\series default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -13450,6 +13511,27 @@ Use True Small Caps
  of scaled capitals.
  Real small caps are often part of expert font sets; they generally look
  better than faked small caps but might have to be purchased separately.
+\change_inserted -712698321 1563000270
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1563000448
+Furthermore, with some fonts, you can add additional (comma-separated) options
+ provided by the font package (or the 
+\family sans
+fontspec
+\family default
+ package, if you use non-TeX fonts), into the 
+\family sans
+Options
+\family default
+ field.
+ This presupposes that you are familiar with the respective \SpecialChar LaTeX
+ font package.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -17912,7 +17994,13 @@ ligature dashes
 
  (-- and ---).
  \SpecialChar LaTeX
- allows line breaks after hyphens, en-dashes and em-dashes.
+ allows line breaks after hyphens
+\change_deleted -1402925745 1558782973
+,
+\change_inserted -1402925745 1558782983
+ and these
+\change_unchanged
+ en-dashes and em-dashes.
 \end_layout
 
 \begin_layout Enumerate
@@ -17932,7 +18020,17 @@ The Elements of Typographic Style
 \end_layout
 
 \begin_layout Enumerate
-Unwanted line breaks after dashes can be prevented by wrapping in a makebox
+Unwanted line breaks 
+\series bold
+after
+\series default
+ dashes 
+\change_inserted -1402925745 1558782702
+must
+\change_deleted -1402925745 1558782715
+can
+\change_unchanged
+ be prevented by wrapping in a makebox
 \begin_inset Foot
 status collapsed
 
@@ -17961,8 +18059,33 @@ Objects
 nobreakdash
 \series default
  in \SpecialChar TeX
- code.
- Examples:
+ code
+\change_inserted -1402925745 1558782753
+, a protected space does not suffice
+\change_unchanged
+.
+ Examples
+\change_inserted -1402925745 1558782332
+
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1402925745 1558782431
+It is generally recommended to set the correct language for text parts not
+ in the document language.
+ We don't do this here to prevent a dependency on LaTeX support for French
+ and Spanish.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+:
 \end_layout
 
 \begin_deeper
@@ -18000,8 +18123,6 @@ status open
 \end_layout
 
 \begin_layout Itemize
-
-\lang french
 Les incises 
 \begin_inset Box Frameless
 position "t"
@@ -18022,8 +18143,6 @@ backgroundcolor "none"
 status open
 
 \begin_layout Plain Layout
-
-\lang french
 –
 \begin_inset space ~
 \end_inset
@@ -18041,8 +18160,6 @@ même
 \end_layout
 
 \begin_layout Itemize
-
-\lang spanish
 En una frase 
 \begin_inset ERT
 status collapsed
@@ -18095,8 +18212,6 @@ Line breaks are still allowed after spaced dashes.
 
 \begin_deeper
 \begin_layout Itemize
-
-\lang french
 Les incises –
 \begin_inset space ~
 \end_inset
@@ -25470,7 +25585,7 @@ Math
 status collapsed
 
 \begin_layout Plain Layout
-Formulas | see
+Formulas|see
 \begin_inset ERT
 status collapsed
 
@@ -29406,7 +29521,7 @@ name "subsec:Table-of-Contents"
 The Table of Contents (TOC) is inserted with the menu 
 \family sans
 Insert\SpecialChar menuseparator
-List/TOC\SpecialChar menuseparator
+List/Contents/References\SpecialChar menuseparator
 Table
 \begin_inset space ~
 \end_inset
@@ -29497,7 +29612,7 @@ Table, figure, listings and algorithm lists are very much like the table
  You can insert them via the 
 \family sans
 Insert\SpecialChar menuseparator
-List/TOC
+List/Contents/References
 \family default
  submenus.
  The list entries are the float captions and the float number.
@@ -29785,7 +29900,10 @@ Appendix
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "chap:Credits"
+reference "chap:Units-available-in"
+plural "false"
+caps "false"
+noprefix "false"
 
 \end_inset
 
@@ -30454,11 +30572,7 @@ To access a database via Bib\SpecialChar TeX
 , use the menu 
 \family sans
 Insert\SpecialChar menuseparator
-List
-\family default
-/
-\family sans
-TOC\SpecialChar menuseparator
+List/Contents/References\SpecialChar menuseparator
 Bib(la)TeX
 \begin_inset space ~
 \end_inset
@@ -30585,11 +30699,7 @@ biblatex
 : Use the menu 
 \family sans
 Insert\SpecialChar menuseparator
-List
-\family default
-/
-\family sans
-TOC\SpecialChar menuseparator
+List/Contents/References\SpecialChar menuseparator
 Bib(la)TeX
 \begin_inset space ~
 \end_inset
@@ -31503,7 +31613,7 @@ arg   "index-insert"
 The index list is inserted in the document with the menu 
 \family sans
 Insert\SpecialChar menuseparator
-List/TOC\SpecialChar menuseparator
+List/Contents/References\SpecialChar menuseparator
 Index
 \begin_inset space ~
 \end_inset
@@ -32383,7 +32493,7 @@ Once the document changes have been applied, you can find the new index
  list in 
 \family sans
 Insert\SpecialChar menuseparator
-List/TOC
+List/Contents/References
 \family default
  and the 
 \family sans
@@ -33338,7 +33448,7 @@ Nomenclature ! Printing
 To print the nomenclature, use the menu 
 \family sans
 Insert\SpecialChar menuseparator
-Lists/TOC\SpecialChar menuseparator
+List/Contents/References\SpecialChar menuseparator
 Nomenclature
 \family default
 .
@@ -38096,6 +38206,8 @@ The toolbar has two buttons to handle notes because notes are often important
 \end_layout
 
 \begin_layout Standard
+
+\change_deleted -712698321 1577206802
 To show the changes made in the output you need the \SpecialChar LaTeX
  package 
 \series bold
@@ -38124,6 +38236,8 @@ literal "true"
 
  or in the package manager of your \SpecialChar LaTeX
 -system.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -38722,7 +38836,7 @@ DVI
 \end_layout
 
 \begin_layout Description
-DVI DVI-format that also allows the useage of special characters or spaces
+DVI DVI-format that also allows the usage of special characters or spaces
  in files paths or file names
 \end_layout
 
@@ -40879,7 +40993,9 @@ Other\SpecialChar ldots
 \end_layout
 
 \begin_layout Subsection
-List/TOC
+
+\family sans
+List/Contents/References
 \end_layout
 
 \begin_layout Standard
@@ -45334,24 +45450,162 @@ The document language and quote styles are set here.
 -commands (this can fail if a \SpecialChar LaTeX
 -command is not known for
  a particular character).
+\change_inserted -712698321 1557594829
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1557596095
+By default, \SpecialChar LyX
+ outputs \SpecialChar LaTeX
+ files in Unicode – or utf8, for that matter (which
+ is nowadays also \SpecialChar LaTeX
+'s default encoding).
+ This should normally fit your needs, since \SpecialChar LaTeX
+'s Unicode support covers the
+ characters of most scripts.
+ Nonetheless it is not yet comprehensive, so there might be cases where
+ using one of the traditional, or 
+\begin_inset Quotes eld
+\end_inset
+
+legacy
+\begin_inset Quotes erd
+\end_inset
+
+, encodings is necessary.
 \end_layout
 
 \begin_layout Standard
+
+\change_inserted -712698321 1557596136
+\SpecialChar LyX
+ provides support for these traditional encodings.
+ If you chose 
+\family sans
+Traditional (auto-selected)
+\family default
+ from the 
+\family sans
+Encodings
+\family default
+ dropdown, \SpecialChar LyX
+ automatically selects the appropriate traditional encoding for
+ the given language(s).
+\change_deleted -712698321 1557595310
+
+\end_layout
+
+\begin_layout Standard
+
+\change_deleted -712698321 1557595310
 If you use the option 
 \family sans
 Language Default
 \family default
 , \SpecialChar LyX
  determines the encoding of a text part from the language of this text.
- If the document contains text in more than one language you may get more
- than one encoding in the \SpecialChar LaTeX
+\change_unchanged
+If the document contains text in more than one language you 
+\change_inserted -712698321 1557595342
+thus 
+\change_unchanged
+may get more than one encoding in the \SpecialChar LaTeX
  file.
- If you do not use this option then the complete document will always use
+\change_deleted -712698321 1557595350
+If you do not use this option then the complete document will always use
  exactly one encoding.
  Checking this option is the preferred setting.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1557596155
+As a third option, \SpecialChar LyX
+ provides the 
+\family sans
+ASCII
+\family default
+ selection.
+ If this is chosen, any character outside the 7bit ASCII range will be output
+ as a \SpecialChar LaTeX
+ command.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1557645585
+Finally, you can also select 
+\family sans
+Custom
+\family default
+, which lets you specify a specific (single) encoding for the whole document.
+ Note that this encoding is then used for 
+\emph on
+any
+\emph default
+ language.
+ The custom list (which is spelled out below) consists of traditional encodings
+ and some special cases of Unicode for specific purposes (see explanation
+ below).
 \end_layout
 
 \begin_layout Standard
+
+\change_inserted -712698321 1557645268
+The 
+\family sans
+Do not load inputenc
+\family default
+ checkbox does what it states: It prevents \SpecialChar LyX
+ from automatically loading the
+ \SpecialChar LaTeX
+-package 
+\series bold
+inputenc
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1557645185
+\SpecialChar LaTeX
+ packages ! inputenc
+\end_layout
+
+\end_inset
+
+.
+ This option might be useful if you use a class or package that pre-loads
+ inputenc or if inputenc must not be used for some reason.
+ When using this, you probably need to load some additional packages manually
+ in the preamble and specify the used encoding for text parts in foreign
+ languages in \SpecialChar TeX
+ code.
+ Note that this option is only available for the standard 
+\family sans
+Unicode
+\family default
+ and 
+\family sans
+Traditional (auto-selected)
+\family default
+ encodings.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Standard
+
+\change_deleted -712698321 1557596063
 \SpecialChar LyX
  also supports Unicode output, which is particularly useful if you need
  lots of special symbols or non-alphabetic scripts, respectively.
@@ -45419,6 +45673,8 @@ reference "subsec:Output-file-formats"
 Language Default
 \family default
  fails, you might try out one of these new engines.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -45553,6 +45809,8 @@ Here is a list with the important encodings:
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1557645284
 Language
 \begin_inset space ~
 \end_inset
@@ -45590,6 +45848,8 @@ status collapsed
  in the preamble and specify the used encoding for text parts in foreign
  languages in \SpecialChar TeX
  code.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -45599,6 +45859,19 @@ ASCII the ASCII encoding, covers only plain English (7-bit ASCII).
  commands, which may result in a big
  file when lots of \SpecialChar LaTeX
 -commands are needed.
+
+\change_inserted -712698321 1557596221
+ This is the same as the 
+\family sans
+ASCII
+\family default
+ option in the main 
+\family sans
+Encoding
+\family default
+ dropdown list.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -46070,6 +46343,21 @@ status collapsed
 \end_inset
 
  (for the languages Chinese, Japanese and Korean)
+\change_inserted -712698321 1557596410
+.
+ This encoding is selected by \SpecialChar LyX
+ with the default encoding (
+\family sans
+Unicode (utf8) [default]
+\family default
+ in the main 
+\family sans
+Encoding
+\family default
+ dropdown list) with CJK languages.
+ Normally you do not need to set this encoding manually.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -46133,7 +46421,24 @@ status collapsed
 
 \end_inset
 
- (comprehensive, including Latin, Greek, Cyrillic and CJK scripts).
+ (
+\change_deleted -712698321 1557596443
+comprehensive, 
+\change_unchanged
+including Latin, Greek, Cyrillic and CJK scripts).
+
+\change_inserted -712698321 1557596475
+ This used to be more comprehensive than 
+\family sans
+Unicode
+\begin_inset space ~
+\end_inset
+
+(utf8)
+\family default
+, but meanwhile it is rather outdated.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -46158,8 +46463,24 @@ status collapsed
 \end_inset
 
 .
- Currently only a limited range of characters (mainly for Latin scripts)
+\change_deleted -712698321 1557596266
+Currently only a limited range of characters (mainly for Latin scripts)
  is supported.
+\change_inserted -712698321 1557596400
+This encoding is selected by \SpecialChar LyX
+ with the default encoding (
+\family sans
+Unicode (utf8) [default]
+\family default
+ in the main 
+\family sans
+Encoding
+\family default
+ dropdown list) with non-CJK languages.
+ Normally you do not need to set this encoding manually.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -46547,6 +46868,42 @@ Objects
  manual.
 \end_layout
 
+\begin_layout Section
+
+\change_inserted -712698321 1577206827
+Change Tracking
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1577206929
+Here you can do some settings related to change tracking (see sec.
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:Change-Tracking"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+).
+ Alternatively to the menu or toolbar, you can set here whether changes
+ are being tracked and whether they are shown in the output.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1577207214
+Additionally, you can advise LyX to place a change bar in the margin of
+ the output.
+ This might be useful to make changed passages more salient.
+\end_layout
+
 \begin_layout Section
 Numbering & TOC
 \end_layout
@@ -46572,6 +46929,55 @@ reference "subsec:Numbering-depth"
 \end_inset
 
 .
+\change_inserted 5863208 1558620045
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 5863208 1558620379
+You can typeset lines numbering in the output file by enabling the checkbox
+ at the bottom.
+ The functionality is handled by package lineno and and additional options
+ of this package can be used as well.
+ The most common one are:
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620630
+right Line numbers to the right margin
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620589
+switch Line number to the outer margin (left – even pages, right – odd pages)
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620637
+switch* Line numbers to the inner margin 
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620780
+modulo Print numbers only on multiples of five lines
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 5863208 1558620792
+displaymath,
+\begin_inset space ~
+\end_inset
+
+mathlines Line numbers for math environments (both options needed).
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -47320,25 +47726,105 @@ reference "sec:File-Formats"
 \end_layout
 
 \begin_layout Description
+
+\change_inserted -712698321 1578647276
+Allow
+\begin_inset space ~
+\end_inset
+
+running
+\begin_inset space ~
+\end_inset
+
+external
+\begin_inset space ~
+\end_inset
+
+programs If this is switched on, \SpecialChar LaTeX
+ is run with the 
+\family typewriter
+-shell-escape
+\family default
+ option which is needed with some packages.
+ Note that this comes with security risks, so please use this only when
+ really necessary and if you know what you are doing.
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1578647006
+LaTeX
+\begin_inset space ~
+\end_inset
+
+Output
+\begin_inset space ~
+\end_inset
+
+Options offers settings for the 
+\family sans
+LaTeX
+\family default
+ export.
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+
+\family sans
 Synchronize
+\change_inserted -712698321 1578646679
+\change_deleted -712698321 1578646679
+
 \begin_inset space ~
 \end_inset
 
+
+\change_unchanged
 with
+\change_deleted -712698321 1578646686
+
 \begin_inset space ~
 \end_inset
 
-Output settings for the menu 
+
+\change_inserted -712698321 1578646686
+\change_unchanged
+Output
+\family default
+\change_inserted -712698321 1578646719
+enables 
+\change_deleted -712698321 1578646729
+settings for the menu 
 \family sans
 Navigate\SpecialChar menuseparator
+
+\change_unchanged
 Forward
 \begin_inset space ~
 \end_inset
 
 search
+\change_inserted -712698321 1578646752
+
 \family default
+ and allows to customize the macro used in this process
+\change_deleted -712698321 1578646757
 .
- For a detailed description see section 
+
+\change_unchanged
+\change_inserted -712698321 1578646759
+(
+\change_deleted -712698321 1578646759
+F
+\change_inserted -712698321 1578646759
+f
+\change_unchanged
+or a detailed description see section 
 \emph on
 Reverse DVI/PDF search
 \emph default
@@ -47350,9 +47836,55 @@ Additional
 
 Features
 \emph default
- manual.
+ manual
+\change_inserted -712698321 1578646762
+)
+\change_unchanged
+.
+\change_inserted -712698321 1578647009
+
 \end_layout
 
+\begin_layout Itemize
+
+\change_inserted -712698321 1578647929
+
+\family sans
+Put fragile content out of moving arguments
+\family default
+ determines whether so-called 
+\begin_inset Quotes els
+\end_inset
+
+fragile
+\begin_inset Quotes ers
+\end_inset
+
+ \SpecialChar LaTeX
+ constructs (such as labels or index entries) are placed outside of so-called
+\begin_inset Quotes els
+\end_inset
+
+moving arguments
+\begin_inset Quotes ers
+\end_inset
+
+ in \SpecialChar LaTeX
+ (such as sections or captions), even if the corresponding insets are
+ placed in such context in \SpecialChar LyX
+.
+ This setting is on by default, since it prevents nasty \SpecialChar LaTeX
+ errors.
+ If you rely on labels or index entries being kept inside the problematic
+ macros, you can uncheck this.
+ If you don't know what we are talking about here, worry not: just leave
+ it checked.
+\change_unchanged
+
+\end_layout
+
+\end_deeper
 \begin_layout Description
 XHTML
 \begin_inset space ~
@@ -49372,6 +49904,16 @@ literal "false"
 \end_inset
 
 
+\change_inserted -712698321 1563708959
+
+\end_layout
+
+\begin_layout Subsubsection
+
+\change_inserted -712698321 1563708986
+LaTeX Language Support
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -49460,14 +50002,63 @@ Command
 \begin_inset space ~
 \end_inset
 
-start If a special \SpecialChar LaTeX
+start 
+\change_deleted -712698321 1563708374
+If a special \SpecialChar LaTeX
 -package is needed to write in a certain document language,
- you can here specify the command to start the package.
- An example is the start command 
+ you can h
+\change_inserted -712698321 1563708374
+H
+\change_unchanged
+ere
+\change_inserted -712698321 1563708377
+ you
+\change_unchanged
+\change_deleted -712698321 1563708382
+specify
+\change_inserted -712698321 1563708384
+customize
+\change_unchanged
+ the command 
+\change_inserted -712698321 1563708639
+that is used to switch to a different language
+\change_deleted -712698321 1563708410
+to start the package
+\change_unchanged
+.
+\change_inserted -712698321 1563708611
+This might be useful if you want to use a different command with 
+\series bold
+babel
+\series default
+ (which provides several alternative commands with different behavior),
+ or if you use a custom language package with specific commands, such as
+\series bold
+Arab\SpecialChar TeX
+
+\series default
+\begin_inset CommandInset citation
+LatexCommand cite
+key "Arabic"
+literal "true"
+
+\end_inset
+
+, which needs 
+\change_deleted -712698321 1563708616
+An example is 
+\change_unchanged
+the start command 
 \family sans
 
 \backslash
 begin{arabtext}
+\change_deleted -712698321 1563708621
+
 \family default
  that is needed to write Arabic using the package 
 \series bold
@@ -49482,18 +50073,39 @@ literal "true"
 
 \end_inset
 
+
+\change_unchanged
 .
  The default is the 
 \series bold
 babel
 \series default
  command 
-\family sans
+\family typewriter
 
 \backslash
 selectlanguage{$$lang}
+\change_inserted -712698321 1563708571
+
 \family default
+, whereby 
+\family sans
+$$lang
+\family default
+ is a placeholder that is substituted with the respective language name
+ in the \SpecialChar LaTeX
+ output
+\change_unchanged
 .
+
+\change_inserted -712698321 1563708571
+ Note that with 
+\series bold
+polyglossia
+\series default
+, this setting is ignored.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -49501,16 +50113,69 @@ Command
 \begin_inset space ~
 \end_inset
 
-end Counterpart to 
+end 
+\change_deleted -712698321 1563857836
+Counterpart to 
 \family sans
 Command start
 \family default
 .
- Some packages, like the default, don't have an end command since the start
- command toggles the package on and off.
+\change_inserted -712698321 1563857869
+Use this if the language switch set in 
+\family sans
+Command start
+\family default
+ needs to be explicitly ended, as in 
+\series bold
+babel
+\series default
+'s alternative command 
+\family typewriter
+
+\backslash
+begin{otherlanguage*}\SpecialChar ldots
+\SpecialChar allowbreak
+
+\backslash
+end{otherlanguage*}
+\family default
+.
+\change_deleted -712698321 1563708866
+Some packages, like the default, don't have an end command since the start
+ command toggles the package on and off
+\change_inserted -712698321 1563858041
+Empty by default, as 
+\family typewriter
+
+\backslash
+selectlanguage{$$lang}
+\family default
+ does not need to be explicitly ended (the switch remains valid until the
+ next 
+\family typewriter
+
+\backslash
+selectlanguage{$$lang}
+\family default
+)
+\change_unchanged
+.
+
+\change_inserted -712698321 1563857868
+ Note that with 
+\series bold
+polyglossia
+\series default
+, this setting is ignored.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1563708996
 Default
 \begin_inset space ~
 \end_inset
@@ -49524,6 +50189,8 @@ separator Defines the default decimal point for use in tables (decimal point
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1563708996
 Default
 \begin_inset space ~
 \end_inset
@@ -49534,6 +50201,8 @@ length
 
 unit Defines the unit that is used as default for lengths in \SpecialChar LyX
 's dialogs.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -49545,24 +50214,99 @@ languages
 \begin_inset space ~
 \end_inset
 
-globally When this option is set, the languages used in the document will
- be added as options to the document class options, so that they can be
- used by all \SpecialChar LaTeX
--packages.
- Otherwise they will only be used as options for the 
+globally 
+\change_deleted -712698321 1563709051
+When
+\change_inserted -712698321 1563709052
+If
+\change_unchanged
+ this option is set, the languages used in the document will be added 
+\change_deleted -712698321 1563709127
+as options 
+\change_unchanged
+to the document class options
+\change_inserted -712698321 1563709259
+ rather than the language package options.
+\change_deleted -712698321 1563709186
+,
+\change_unchanged
+\change_deleted -712698321 1563709191
+so that they can be used by all \SpecialChar LaTeX
+-packages
+\change_inserted -712698321 1563709305
+Since the document class passes all options in gets to all loaded \SpecialChar LaTeX
+-packages,
+ all language-aware packages will be informed about the used languages this
+ way
+\change_unchanged
+.
+\change_deleted -712698321 1563709264
+Otherwise they will only be used as options for the 
 \series bold
 babel
 \series default
  package.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1563709314
 Auto
 \begin_inset space ~
 \end_inset
 
-begin When this option is set, documents start with the chosen document
- language.
+begin
+\change_inserted -712698321 1563709328
+Set
+\begin_inset space ~
+\end_inset
+
+document
+\begin_inset space ~
+\end_inset
+
+language
+\begin_inset space ~
+\end_inset
+
+explicitly
+\change_unchanged
+\change_deleted -712698321 1563709331
+When
+\change_inserted -712698321 1563709331
+If
+\change_unchanged
+ this option is set, 
+\change_inserted -712698321 1563709808
+the language switch defined in 
+\family sans
+Command
+\begin_inset space ~
+\end_inset
+
+start
+\family default
+ is output at the beginning of the document, thereby explicitly switching
+ to the document language.
+ This assures that the correct language is used in any case.
+ This might be needed if you use a non-default 
+\family sans
+Command
+\begin_inset space ~
+\end_inset
+
+start
+\family default
+ or if a package resets the document language.
+ If not set, the language that is active at document start is used (this
+ usually should be the document language).
+\change_deleted -712698321 1563709548
+documents start with the chosen document language.
  When this option is not set, the 
 \family sans
 Command
@@ -49582,23 +50326,55 @@ Command
 start
 \family default
  than the default.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1563709354
 Auto
 \begin_inset space ~
 \end_inset
 
-end Counterpart to 
+end
+\change_inserted -712698321 1563709358
+Unset
+\begin_inset space ~
+\end_inset
+
+document
+\begin_inset space ~
+\end_inset
+
+language
+\begin_inset space ~
+\end_inset
+
+explicitly
+\change_unchanged
+ Counterpart to 
+\change_deleted -712698321 1563709361
+
 \family sans
 Auto
 \begin_inset space ~
 \end_inset
 
 begin
+\change_inserted -712698321 1563709392
+Set document language explicitly
+\change_unchanged
+
 \family default
 .
- When it is not set, the 
+\change_deleted -712698321 1563709618
+When it is not
+\change_inserted -712698321 1563709618
+If
+\change_unchanged
+ set, the 
 \family sans
 Command
 \begin_inset space ~
@@ -49606,7 +50382,30 @@ Command
 
 end
 \family default
- is set to the end of the document.
+ is 
+\change_deleted -712698321 1563709625
+set
+\change_inserted -712698321 1563709626
+output
+\change_unchanged
+\change_inserted -712698321 1563709628
+at
+\change_deleted -712698321 1563709628
+to
+\change_unchanged
+ the end of the document.
+\change_inserted -712698321 1563709816
+
+\end_layout
+
+\begin_layout Subsubsection
+\paragraph_spacing single
+
+\change_inserted -712698321 1563709833
+Editor Settings
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -49614,15 +50413,81 @@ Mark
 \begin_inset space ~
 \end_inset
 
+
+\change_inserted -712698321 1563709847
+additional
+\change_deleted -712698321 1563709845
 foreign
+\change_unchanged
+
+\begin_inset space ~
+\end_inset
+
+languages 
+\change_inserted -712698321 1563709877
+If set, all 
+\change_deleted -712698321 1563709877
+T
+\change_inserted -712698321 1563709878
+t
+\change_unchanged
+ext 
+\change_deleted -712698321 1563709882
+marked formatted 
+\change_unchanged
+in a language different 
+\change_deleted -712698321 1563709886
+from
+\change_inserted -712698321 1563709886
+to
+\change_unchanged
+ the document language will be 
+\change_inserted -712698321 1563709907
+marked (by default with a blue 
+\change_unchanged
+underline
+\change_deleted -712698321 1563709911
+d in blue
+\change_inserted -712698321 1563709911
+)
+\change_unchanged
+.
+\change_inserted -712698321 1563709927
+
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1563711969
+Respect
 \begin_inset space ~
 \end_inset
 
-languages Text marked formatted in a language different from the document
- language will be underlined in blue.
+OS
+\begin_inset space ~
+\end_inset
+
+keyboard
+\begin_inset space ~
+\end_inset
+
+language If set, \SpecialChar LyX
+ will switch the input language if the keyboard map is
+ switched via the operating system.
+ This is particularly useful if you switch between languages with different
+ scripts (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., English and Hebrew: in this case, switching the keyboard to Hebrew will
+ automatically switch the input language to Hebrew as well, and vice versa).
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1563709926
 Enable
 \begin_inset space ~
 \end_inset
 
 support Enables the use of languages, written from right to left (RTL),
  like Arabic, Hebrew or Farsi.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
-Cursor
+
+\change_inserted -712698321 1563710132
+Right-to-left
+\begin_inset space ~
+\end_inset
+
+
+\change_deleted -712698321 1563710132
+C
+\change_inserted -712698321 1563710132
+c
+\change_unchanged
+ursor
+\begin_inset space ~
+\end_inset
+
+movement 
+\change_inserted -712698321 1563710265
+Here you can define how cursor movement (with the arrow keys) behaves 
+\change_deleted -712698321 1563710266
+W
+\change_inserted -712698321 1563710267
+w
+\change_unchanged
+hen writing 
+\change_deleted -712698321 1563710171
+RTL
+\change_inserted -712698321 1563710286
+scripts with right-to-left direction (e.g., Arabic, Hebrew or Farsi).
+\change_deleted -712698321 1563857456
+, you can define if the left and right arrow keys move the cursor visually
+ to the left or right, respectively, or logically.
+\change_inserted -712698321 1563859701
+
+\end_layout
+
+\begin_deeper
+\begin_layout Standard
+
+\family sans
+Logical
+\family default
+ means that the cursor 
+\change_inserted -712698321 1563859940
+follows the logic of the text direction, and the arrows' direction relates
+ to the directionality of the main paragraph language.
+ E.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., in embedded right-to-left text in a left-to-right paragraph (say, Hebrew
+ embedded in English), the cursor starts at the right (that is, at the 
+\emph on
+beginning
+\emph default
+ of the embedded passage in the right-to-left logic) when coming from the
+ left.
+ The meaning of the key is thus swapped for that part; right arrow in this
+ specific case always means: move 
+\emph on
+forward
+\emph default
+ in text (even if this means: 
+\emph on
+move left
+\emph default
+).
+\change_deleted -712698321 1563857456
+is moved to the left when pressing the right arrow key 
+\change_inserted -712698321 1563859705
+This setting might be useful in texts that mix left-to-right and right-to-left
+ scripts, since the cursor then follows a coherent 
+\begin_inset Quotes eld
+\end_inset
+
+text logic
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1563860084
+
+\family sans
+Visual
+\family default
+ means: always move to the direction towards which the arrows really point.
+ In this case, in embedded right-to-left text in a left-to-right paragraph,
+ the cursor starts at the left (in the text logic: 
+\emph on
+from the end
+\emph default
+) when coming from the left.
+ The visual meaning of the key is thus maintained in all cases, at the expense
+ of the text logic.
+\change_deleted -712698321 1563857456
+and the cursor is inside text in an RTL language.
+\change_inserted -712698321 1563858627
+
+\end_layout
+
+\end_deeper
+\begin_layout Subsubsection
+
+\change_inserted -712698321 1563710235
+Local Preferences
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1563776004
+Default
 \begin_inset space ~
 \end_inset
 
-movement When writing RTL, you can define if the left and right arrow keys
- move the cursor visually to the left or right, respectively, or logically.
- Logical means that the cursor is moved to the left when pressing the right
- arrow key and the cursor is inside text in an RTL language.
+decimal
+\begin_inset space ~
+\end_inset
+
+separator Defines the default decimal separator for use in tables (decimal
+ separator alignment).
+ By default, the appropriate character for the current language is selected
+ (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., dot for English, comma for German), but you can also specify a specific
+ (static) custom character here.
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1563709001
+Default
+\begin_inset space ~
+\end_inset
+
+length
+\begin_inset space ~
+\end_inset
+
+unit Defines the unit that is used as default for lengths in \SpecialChar LyX
+'s dialogs.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Subsection
@@ -51896,7 +52907,7 @@ literal "false"
  of the \SpecialChar LaTeX
  package 
 \series bold
-microtpye
+microtype
 \series default
 
 \begin_inset Index idx
@@ -51904,7 +52915,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
- packages ! microtpye
+ packages ! microtype
 \end_layout
 
 \end_inset