]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
Customization: some color name fixes.
[lyx.git] / lib / doc / UserGuide.lyx
index b3a5f12b9272ea605323064a997ccafa0c6d9144..c65d7076c8bae30cb0cf909af4afc1f8fdfe8588 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.3 created this file. For more info see http://www.lyx.org/
-\lyxformat 526
+\lyxformat 544
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -69,6 +69,7 @@ enumitem
 \font_sf_scale 100 100
 \font_tt_scale 100 100
 \use_microtype false
+\use_dash_ligatures false
 \graphics default
 \default_output_format pdf2
 \output_sync 0
@@ -95,14 +96,14 @@ enumitem
 \use_geometry false
 \use_package amsmath 1
 \use_package amssymb 1
-\use_package cancel 0
+\use_package cancel 1
 \use_package esint 1
 \use_package mathdots 1
-\use_package mathtools 0
+\use_package mathtools 1
 \use_package mhchem 1
-\use_package stackrel 0
+\use_package stackrel 1
 \use_package stmaryrd 1
-\use_package undertilde 0
+\use_package undertilde 1
 \cite_engine basic
 \cite_engine_type default
 \biblio_style plain
@@ -111,7 +112,8 @@ enumitem
 \paperorientation portrait
 \suppress_date false
 \justification true
-\use_refstyle 0
+\use_refstyle 1
+\use_minted 0
 \notefontcolor #0000ff
 \branch Question
 \selected 1
@@ -131,6 +133,8 @@ enumitem
 \tocdepth 2
 \paragraph_separation skip
 \defskip medskip
+\is_math_indent 0
+\math_numbering_side default
 \quotes_style english
 \dynamic_quotes 0
 \papercolumns 1
@@ -141,9 +145,8 @@ enumitem
 \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 274215730 "scott"
-\author 424524441 "rgheck"
 \end_header
 
 \begin_body
@@ -168,6 +171,7 @@ If you have comments on or error corrections to this documentation, please
 LatexCommand href
 target "lyx-docs@lists.lyx.org"
 type "mailto:"
+literal "false"
 
 \end_inset
 
@@ -184,7 +188,7 @@ type "mailto:"
 \begin_inset Newline newline
 \end_inset
 
-Version 2.2.x
+Version 2.3.x
 \begin_inset Note Note
 status collapsed
 
@@ -195,8 +199,7 @@ The latest PDF-version of this document can be found here:
 
 
 \series bold
-http://wiki.lyx.org/\SpecialChar LyX
-/DocumentationDevelopment#UserGuide
+https://wiki.lyx.org/LyX/Manuals#UserGuide
 \end_layout
 
 \end_inset
@@ -1799,14 +1802,21 @@ Right-clicking on elements in the Outline opens in many cases a context
 \end_layout
 
 \begin_layout Standard
-The “Filter” field at the top allows you to restrict which entries appear
- in the Outline.
- For example, if you are displaying the list of Labels and References and
- wish to see only references to subsections, you can enter the text 
+The 
+\family sans
+Filter
+\family default
+ field at the top allows you to restrict which entries appear in the outline.
+ For example, if you are displaying the list of 
+\emph on
+Labels and References
+\emph default
+ and wish to see only references to subsections, you can enter the text
 \begin_inset Quotes eld
 \end_inset
 
-sub:
+sub
 \begin_inset Quotes erd
 \end_inset
 
@@ -2446,6 +2456,7 @@ Tab
 LatexCommand nomenclature
 symbol "Tab"
 description "Tabulator key"
+literal "false"
 
 \end_inset
 
@@ -2511,6 +2522,7 @@ Esc
 LatexCommand nomenclature
 symbol "Esc"
 description "Escape key"
+literal "false"
 
 \end_inset
 
@@ -2578,6 +2590,7 @@ Ctrl
 LatexCommand nomenclature
 symbol "Ctrl"
 description "Control key"
+literal "false"
 
 \end_inset
 
@@ -2646,6 +2659,7 @@ Shift
 LatexCommand nomenclature
 symbol "Shift"
 description "Shift key"
+literal "false"
 
 \end_inset
 
@@ -2676,6 +2690,7 @@ Alt
 LatexCommand nomenclature
 symbol "Alt"
 description "Alt or Meta key"
+literal "false"
 
 \end_inset
 
@@ -4060,7 +4075,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! fancyhdr
+ packages ! fancyhdr
 \end_layout
 
 \end_inset
@@ -4564,7 +4579,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! setspace
+ packages ! setspace
 \end_layout
 
 \end_inset
@@ -6662,7 +6677,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! enumitem
+ packages ! enumitem
 \end_layout
 
 \end_inset
@@ -7251,7 +7266,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! enumitem
+ packages ! enumitem
 \end_layout
 
 \end_inset
@@ -7261,6 +7276,7 @@ status collapsed
 \begin_inset CommandInset citation
 LatexCommand cite
 key "enumitem"
+literal "true"
 
 \end_inset
 
@@ -7416,7 +7432,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! enumitem
+ packages ! enumitem
 \end_layout
 
 \end_inset
@@ -7426,6 +7442,7 @@ status collapsed
 \begin_inset CommandInset citation
 LatexCommand cite
 key "enumitem"
+literal "true"
 
 \end_inset
 
@@ -10515,21 +10532,48 @@ enumeration
 \begin_layout Standard
 To split an existing list into two lists, set the cursor at the end of a
  list item and use the menu 
+\change_deleted -712698321 1514652028
+
 \family sans
-Edit\SpecialChar menuseparator
+Edit
+\change_inserted -712698321 1514652029
+Insert
+\change_unchanged
+\SpecialChar menuseparator
+
+\change_deleted -712698321 1514652035
 Start New Environment
+\change_inserted -712698321 1514652814
+Separated <Name> Above
+\family default
+ or
+\family sans
+ Insert\SpecialChar menuseparator
+Separated <Name> Below
+\change_unchanged
+
 \family default
 .
  This inserts a plain separator (red line in \SpecialChar LyX
-) and behind it the new list.
- The menu 
+) and 
+\change_inserted -712698321 1514652169
+before or 
+\change_unchanged
+behind it the new list.
+\change_deleted -712698321 1514652256
+The menu 
 \family sans
 Edit\SpecialChar menuseparator
 Start New Parent Environment
 \family default
  only appears if the item is nested.
  It does not only separate the list but also creates a new one outside the
- nesting.
+ nesting
+\change_inserted -712698321 1514652300
+Inside nested environments, it is also possible to split the outer environment
+\change_unchanged
+.
 \end_layout
 
 \begin_layout Standard
@@ -12679,8 +12723,8 @@ status open
 \series bold
 Note:
 \series default
- In practice, some fonts might fail due to bad metrics and other font deficienci
-es; so you might have to experiment.
+ In practice, some fonts might fail due to a legacy (non Unicode) font encoding,
+ bad metrics, or other font deficiencies; so you might have to experiment.
 \end_layout
 
 \end_inset
@@ -12832,8 +12876,9 @@ Default
 Default,
 \family default
  the font that is preset by the current document class is used.
- In most cases, this will be the standard \SpecialChar TeX
- font, known as 
+ With LyX's default font encoding, this is a look-alike of the standard
+ \SpecialChar TeX
+ font 
 \begin_inset Quotes eld
 \end_inset
 
@@ -12853,7 +12898,19 @@ Modern
 \family typewriter
 cm
 \family default
-) or 
+): either 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+cm-super
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+ or the bitmap font 
 \begin_inset Quotes eld
 \end_inset
 
@@ -12869,25 +12926,22 @@ European Computer Modern
 \family typewriter
 ec
 \family default
-), but some classes preset different default fonts.
+).
+ However, some classes set different default fonts.
 \end_layout
 
 \begin_layout Standard
 As 
 \family typewriter
-cm
-\family default
- and 
-\family typewriter
 ec
 \family default
- are bitmap fonts, they often look pixelated in PDF output, especially when
you read the PDF in a zoomed size.
+ is a bitmap font, it looks pixelated in PDF output, especially when you
+ read the PDF in a zoomed size.
 \begin_inset Foot
 status collapsed
 
 \begin_layout Plain Layout
-This problem does not appear if you read PDFs in 
+This problem is less severe if you read PDFs in 
 \family typewriter
 Adobe
 \begin_inset space ~
@@ -12964,159 +13018,6 @@ One difference is improved kerning.
 
 \end_layout
 
-\begin_layout Itemize
-or select the 
-\family sans
-AE
-\begin_inset space ~
-\end_inset
-
-(Almost
-\begin_inset space ~
-\end_inset
-
-European)
-\family default
- fonts in (the rare) case that 
-\family sans
-Latin
-\begin_inset space ~
-\end_inset
-
-Modern
-\family default
- is not available to you or does not work, and you still want to emulate
- the look of 
-\family typewriter
-cm
-\family default
-/
-\family typewriter
-ec
-\family default
-.
-\family typewriter
-AE
-\family default
- is a virtual font.
- Virtual means that it 
-\begin_inset Quotes eld
-\end_inset
-
-steals
-\begin_inset Quotes erd
-\end_inset
-
- outline 
-\family typewriter
-cm
-\family default
--glyphs from other fonts.
- This has the disadvantage that some characters are missing, like the French
- guillemets (
-\begin_inset Quotes eld
-\end_inset
-
-\begin_inset Quotes erd
-\end_inset
-
- and 
-\begin_inset Quotes eld
-\end_inset
-
-\begin_inset Quotes erd
-\end_inset
-
-)
-\begin_inset Foot
-status collapsed
-
-\begin_layout Plain Layout
-Loading the \SpecialChar LaTeX
--package 
-\series bold
-aeguill
-\series default
-
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-\SpecialChar LaTeX
--packages ! aeguill
-\end_layout
-
-\end_inset
-
- with the document preamble line
-\begin_inset Newline newline
-\end_inset
-
-
-\series bold
-
-\backslash
-usepackage[ec]{aeguill}
-\begin_inset Newline newline
-\end_inset
-
-
-\series default
-will fix the guillemet problem.
-\end_layout
-
-\end_inset
-
- and that accented characters are not 
-\emph on
-one
-\emph default
- glyph, but built of 
-\emph on
-two
-\emph default
- characters, the accent and the letter.
- Therefore you cannot search for words with accented characters in documents
- using the 
-\family typewriter
-AE
-\family default
- fonts.
- If you search for example for the French word 
-\begin_inset Quotes eld
-\end_inset
-
-rève
-\begin_inset Quotes erd
-\end_inset
-
- in a PDF, you will not get any result, because the PDF-viewer searches
- for the glyph 
-\begin_inset Quotes eld
-\end_inset
-
- è 
-\begin_inset Quotes erd
-\end_inset
-
- and not for the glyph 
-\begin_inset Quotes eld
-\end_inset
-
- e +
-\begin_inset space ~
-\end_inset
-
- ̀ 
-\begin_inset Quotes erd
-\end_inset
-
-.
-\end_layout
-
 \begin_layout Itemize
 If you do not like the look of 
 \family typewriter
@@ -13372,7 +13273,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! fontenc
+ packages ! fontenc
 \end_layout
 
 \end_inset
@@ -13456,7 +13357,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! CJK
+ packages ! CJK
 \end_layout
 
 \end_inset
@@ -13475,6 +13376,100 @@ CJK
 \end_inset
 
 
+\end_layout
+
+\begin_layout Standard
+The option 
+\family sans
+Enable micro-typographic extensions
+\family default
+ activates extensions such as character protrusion and font expansion via
+ the \SpecialChar LaTeX
+-package 
+\series bold
+microtype
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! microtype
+\end_layout
+
+\end_inset
+
+.
+\change_inserted -1402925745 1514889567
+
+\end_layout
+
+\begin_layout Standard
+The option 
+\change_deleted -1402925745 1514890586
+
+\family sans
+Output en- and em-dashes as ligatures
+\change_unchanged
+
+\family default
+\change_inserted -1402925745 1514890570
+
+\family sans
+Disallow line breaks after dashes
+\family default
+\change_unchanged
+outputs en- and em-dashes as 
+\change_deleted -1402925745 1514890990
+ligatures (--, ---)
+\change_inserted -1402925745 1514891156
+literal characters
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1402925745 1514891207
+Or \SpecialChar LaTeX
+ macro, if the literal character is not supported by the \SpecialChar LaTeX
+ input encoding.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+ instead of 
+\change_deleted -1402925745 1514891082
+a sigle character
+\change_inserted -1402925745 1514891224
+ligatures (--, ---) (cf.
+ section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Dashes-and-line-breaks"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+)
+\change_unchanged
+.
+\end_layout
+
+\begin_layout Standard
 \begin_inset VSpace bigskip
 \end_inset
 
@@ -14810,7 +14805,11 @@ Use this only if a journal absolutely insists on it.
 \labelwidthstring 00.00.0000
 
 \family sans
-Strikeout
+Strike
+\begin_inset space ~
+\end_inset
+
+out
 \family default
  
 \strikeout on
@@ -14834,6 +14833,27 @@ This is frequently used to indicate an older version of text that has been
 \begin_layout Labeling
 \labelwidthstring 00.00.0000
 
+\family sans
+Cross
+\begin_inset space ~
+\end_inset
+
+out
+\family default
+\xout on
+This is text with Cross out on.
+\xout default
+
+\begin_inset Newline newline
+\end_inset
+
+This is used to make text hardly readable.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
 \family sans
 Noun
 \family default
@@ -15597,7 +15617,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! pstricks
+ packages ! pstricks
 \end_layout
 
 \end_inset
@@ -16221,7 +16241,7 @@ In \SpecialChar LyX
 \begin_inset Quotes erd
 \end_inset
 
character comes in four lengths: the 
symbol comes in four variants: the 
 \emph on
 hyphen
 \emph default
@@ -16233,7 +16253,11 @@ en dash
 \emph on
 em dash
 \emph default
-, and the minus sign:
+, and the 
+\emph on
+minus sign
+\emph default
+:
 \begin_inset VSpace defskip
 \end_inset
 
@@ -16241,14 +16265,33 @@ em dash
 \end_layout
 
 \begin_layout Standard
+\begin_inset Box Frameless
+position "t"
+hor_pos "c"
+has_inner_box 1
+inner_pos "t"
+use_parbox 0
+use_makebox 0
+width "100col%"
+special "none"
+height "1in"
+height_special "totalheight"
+thickness "0.4pt"
+separation "3pt"
+shadowsize "4pt"
+framecolor "black"
+backgroundcolor "none"
+status open
+
+\begin_layout Plain Layout
 \begin_inset Tabular
 <lyxtabular version="3" rows="5" columns="3">
 <features tabularvalignment="middle">
-<column alignment="left" valignment="top">
+<column alignment="left" valignment="top" width="0pt">
 <column alignment="left" valignment="top">
 <column alignment="left" valignment="top">
 <row interlinespace="3mm">
-<cell alignment="center" valignment="top" bottomline="true" usebox="none">
+<cell alignment="left" valignment="top" bottomline="true" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -16277,7 +16320,7 @@ inserted with
 </cell>
 </row>
 <row interlinespace="3mm">
-<cell alignment="center" valignment="top" usebox="none">
+<cell alignment="left" valignment="top" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -16317,7 +16360,7 @@ hyphen
 </cell>
 </row>
 <row interlinespace="3mm">
-<cell alignment="center" valignment="top" usebox="none">
+<cell alignment="left" valignment="top" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -16339,7 +16382,55 @@ en dash
 \begin_inset Text
 
 \begin_layout Plain Layout
+system key combination
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+On Mac and Linux, the en dash is entered with 
+\family sans
+Opt+
+\begin_inset Quotes eld
+\end_inset
+
+-
+\begin_inset Quotes erd
+\end_inset
+
+
+\family default
+ and the em dash with 
+\family sans
+Shift-Opt+
+\begin_inset Quotes erd
+\end_inset
+
+-
+\begin_inset Quotes erd
+\end_inset
+
+
+\family default
+ (
+\family sans
+Opt
+\family default
+ is the Mac label for the right 
+\family sans
+Alt
+\family default
+\change_deleted -1402925745 1514650349
 
+\family sans
+/ AltGr
+\change_unchanged
+\family default
+key).
+\change_deleted -1402925745 1514642633
+Alternatively, dashes can be inserted with 
 \family sans
 Insert\SpecialChar menuseparator
 Special
@@ -16348,13 +16439,40 @@ Special
 
 Character\SpecialChar menuseparator
 Symbols
+\family default
+ or with the 
+\begin_inset Quotes eld
+\end_inset
+
+unicode-insert
+\begin_inset Quotes erd
+\end_inset
+
+ \SpecialChar LyX
+ function with the Unicode code point as argument (2013 for the em dash
+ and 2014 for the en dash).
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ or 
+\begin_inset Quotes eld
+\end_inset
+
+--
+\begin_inset Quotes erd
+\end_inset
+
+ in text
 \end_layout
 
 \end_inset
 </cell>
 </row>
 <row interlinespace="3mm">
-<cell alignment="center" valignment="top" usebox="none">
+<cell alignment="left" valignment="top" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -16376,22 +16494,22 @@ em dash
 \begin_inset Text
 
 \begin_layout Plain Layout
+system key combination or 
+\begin_inset Quotes eld
+\end_inset
 
-\family sans
-Insert\SpecialChar menuseparator
-Special
-\begin_inset space ~
+---
+\begin_inset Quotes erd
 \end_inset
 
-Character\SpecialChar menuseparator
-Symbols
+ in text
 \end_layout
 
 \end_inset
 </cell>
 </row>
 <row>
-<cell alignment="center" valignment="top" usebox="none">
+<cell alignment="left" valignment="top" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -16438,6 +16556,11 @@ minus sign
 \end_inset
 
 
+\end_layout
+
+\end_inset
+
+
 \begin_inset VSpace defskip
 \end_inset
 
@@ -16445,56 +16568,52 @@ minus sign
 \end_layout
 
 \begin_layout Standard
-You can alternatively generate the en and em dash by inserting the 
-\begin_inset Quotes eld
+Dashes can also be inserted with 
+\family sans
+Insert\SpecialChar menuseparator
+Special
+\begin_inset space ~
 \end_inset
 
-
-\family typewriter
--
+Character\SpecialChar menuseparator
+Symbols
 \family default
+ or 
+\change_inserted -1402925745 1514890768
+using 
+\change_unchanged
+the 
+\change_deleted -1402925745 1514650507
 
-\begin_inset Quotes erd
-\end_inset
-
- character multiple times in a row.
- They will automatically be converted to the appropriate length dash in
- the final output, but not in \SpecialChar LyX
-.
 \begin_inset Quotes eld
 \end_inset
 
--
-\begin_inset space \thinspace{}
-\end_inset
-
--
-\begin_inset Quotes erd
-\end_inset
 
- gives a en dash, 
-\begin_inset Quotes eld
-\end_inset
+\change_unchanged
 
--
-\begin_inset space \thinspace{}
-\end_inset
+\family typewriter
+unicode-insert
+\change_deleted -1402925745 1514650506
 
--
-\begin_inset space \thinspace{}
-\end_inset
+\family default
 
--
 \begin_inset Quotes erd
 \end_inset
 
- a em dash.
+
+\change_unchanged
+ \SpecialChar LyX
+ function
+\change_inserted -1402925745 1514650396
+ with the Unicode code point as argument (2013 for the em dash and 2014
+ for the en dash)
+\change_unchanged
+.
 \end_layout
 
 \begin_layout Standard
-The three dash types are distinct from the minus sign, which appears in
- math mode and has a length of its own.
+Hyphen and dashes are distinct from the minus sign, which appears in math
+ mode and has a length of its own.
  Here are some examples:
 \end_layout
 
@@ -16511,7 +16630,19 @@ hyphen
 \end_layout
 
 \begin_layout Enumerate
-From A–Z
+
+\change_deleted -1402925745 1514642720
+From 
+\change_unchanged
+A–Z; pages
+\begin_inset space ~
+\end_inset
+
+369–378
+\change_inserted -1402925745 1514642746
+; Oh – there's a dash.
+\change_unchanged
+
 \begin_inset space \hfill{}
 \end_inset
 
@@ -16523,7 +16654,7 @@ en dash
 \end_layout
 
 \begin_layout Enumerate
-Oh — there's a dash.
+The em dash is used without spaces: Oh—there's a dash.
 \begin_inset space \hfill{}
 \end_inset
 
@@ -16549,21 +16680,24 @@ minus sign
 )
 \end_layout
 
-\begin_layout Subsection
-Hyphenation
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-Hyphenation
-\end_layout
+\begin_layout Standard
+See also the 
+\begin_inset CommandInset href
+LatexCommand href
+name "Wikipedia entry on dashes"
+target "https://en.wikipedia.org/wiki/Dash"
+literal "false"
 
 \end_inset
 
+.
+\end_layout
 
+\begin_layout Subsection
+Dashes and Line Breaks
 \begin_inset CommandInset label
 LatexCommand label
-name "subsec:Hyphenation"
+name "subsec:Dashes-and-line-breaks"
 
 \end_inset
 
@@ -16571,86 +16705,135 @@ name "subsec:Hyphenation"
 \end_layout
 
 \begin_layout Standard
-Words are not hyphenated within \SpecialChar LyX
- but automatically in the output.
- Hyphenation is done by the \SpecialChar LaTeX
--package 
-\series bold
-babel
-\series default
+Whether line breaks 
+\change_deleted -1402925745 1514642422
+at
+\change_inserted -1402925745 1514890882
+before or after
+\change_unchanged
+ dashes are allowed depends on the use case and locale
+\change_inserted -1402925745 1514650654
+, e.
+\begin_inset space \thinspace{}
+\end_inset
 
-\begin_inset Index idx
-status collapsed
+g.
+\change_unchanged
+:
+\end_layout
 
-\begin_layout Plain Layout
-\SpecialChar LaTeX
--packages ! babel
+\begin_layout Itemize
+In English, line breaks are generally allowed after the dash
+\change_deleted -1402925745 1514642312
+ in ranges of values such as 1975–1982
+\change_unchanged
+, but no line break should occur if only a single character follows the
+ dash (as in A–Z).
 \end_layout
 
-\end_inset
+\begin_layout Itemize
+In English, dashes used to set off parenthetical statements should not start
+ a new line.
+\end_layout
 
- following the rules of the document language.
+\begin_layout Itemize
+In French and Spanish, dashes around parenthetical statements are treated
+ similar to brackets: line breaks are not allowed on the inner side.
 \end_layout
 
 \begin_layout Standard
-\SpecialChar LaTeX
- hyphenates almost perfectly; it only has problems with text in the 
-\family sans
-typewriter
-\family default
- font and with unusual constructs, like 
+
+\change_deleted -1402925745 1514643928
+The
+\change_inserted -1402925745 1514891332
+By default,
+\change_unchanged
+ dashes 
+\change_deleted -1402925745 1514891353
+that 
+\change_unchanged
+are output by \SpecialChar LyX
+ to \SpecialChar LaTeX
+\change_deleted -1402925745 1514891361
+by default generally
+\change_inserted -1402925745 1514891480
+as 
 \begin_inset Quotes eld
 \end_inset
 
-h3knix/m0n0wall
+ligature dashes
 \begin_inset Quotes erd
 \end_inset
 
-.
- If \SpecialChar LaTeX
- cannot break a word correctly, you can set hyphenation points manually.
- This is done with the menu 
-\family sans
-Insert\SpecialChar menuseparator
-Formatting\SpecialChar menuseparator
-Hyphenation
-\begin_inset space ~
-\end_inset
+ (-- and ---).
+ \SpecialChar LaTeX
+
+\change_unchanged
+ allow
+\change_inserted -1402925745 1514891455
+s
+\change_unchanged
+\change_deleted -1402925745 1514891448
+for 
+\change_unchanged
+line breaks after 
+\change_inserted -1402925745 1514891497
+hyphens, 
+\change_unchanged
+en-dashes and em-dashes.
+\change_inserted -1402925745 1514643799
 
-Point
-\family default
-.
- These extra hyphenation points are only recommendations to \SpecialChar LaTeX
-.
- If no hyphenation is necessary, \SpecialChar LaTeX
- will ignore them.
 \end_layout
 
 \begin_layout Standard
-Sometimes you want to prevent words or constructs from being hyphenated.
- Imagine that you are describing keybindings/shortcuts in your document
- in the form 
-\begin_inset Quotes eld
-\end_inset
 
-A-b c
-\begin_inset Quotes erd
-\end_inset
+\change_deleted -1402925745 1514650817
+Please note:
+\change_unchanged
 
-.
- \SpecialChar LaTeX
- would then see the hyphen 
-\begin_inset Quotes eld
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted -1402925745 1514652254
+Line breaks  before spaced en dashes
+\begin_inset space ~
 \end_inset
 
--
-\begin_inset Quotes erd
+– common in British English and generally recommended by 
+\emph on
+The Elements of Typographic Style
+\emph default
+
+\begin_inset space ~
 \end_inset
 
- as a hyphenation possibility.
- Hyphenating at this point would look ugly.
- To prevent the shortcut from being hyphenated, you can put it into a makebox
- as described in section 
+– can be prevented using protected spaces.
+\end_layout
+
+\begin_layout Enumerate
+Unwanted line breaks 
+\change_inserted -1402925745 1514652276
+after dashes 
+\change_unchanged
+can be prevented by wrapping in a 
+\change_deleted -1402925745 1514891688
+m
+\change_inserted -1402925745 1514891688
+M
+\change_unchanged
+akebox
+\change_inserted -1402925745 1514891707
+ inset
+\change_unchanged
+
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+See section 
 \emph on
 Prevent Hyphenation
 \emph default
@@ -16665,853 +16848,1354 @@ Objects
  manual.
 \end_layout
 
-\begin_layout Subsection
-Punctuation Marks
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-Punctuation marks
-\end_layout
-
 \end_inset
 
 
-\end_layout
+\change_deleted -1402925745 1514652291
+, using protected spaces
+\change_unchanged
+ or preceding with 
+\family typewriter
 
-\begin_layout Subsubsection
-Abbreviations and End of Sentence
-\begin_inset CommandInset label
-LatexCommand label
-name "subsec:Abbreviations"
+\backslash
+nobreakdash
+\family default
+ in \SpecialChar TeX
+ code.
+ Examples:
+\end_layout
 
+\begin_deeper
+\begin_layout Itemize
+Pages
+\begin_inset space ~
 \end_inset
 
 
+\begin_inset Box Frameless
+position "t"
+hor_pos "c"
+has_inner_box 1
+inner_pos "t"
+use_parbox 0
+use_makebox 1
+width ""
+special "none"
+height "1in"
+height_special "totalheight"
+thickness "0.4pt"
+separation "3pt"
+shadowsize "4pt"
+framecolor "black"
+backgroundcolor "none"
+status open
+
+\begin_layout Plain Layout
+36
+\change_deleted -1402925745 1514891557
+8
+\change_unchanged
+–
+\change_inserted -1402925745 1514891614
+3
+\change_unchanged
+9
 \end_layout
 
-\begin_layout Standard
-When \SpecialChar LyX
- calls \SpecialChar LaTeX
- to generate the final version of your document, \SpecialChar LaTeX
- automatically
- distinguishes between words, sentences, and abbreviations.
- \SpecialChar LaTeX
- then adds the 
-\begin_inset Quotes eld
 \end_inset
 
-appropriate amount of space.
-\begin_inset Quotes erd
-\end_inset
 
- That means sentences get a little bit more space between the period and
- the next word.
- Abbreviations get the same amount of space after the period that a word
- gets after another word.
 \end_layout
 
-\begin_layout Standard
-Unfortunately, the algorithm for figuring out what's an abbreviation does
- not work in all cases.
- If a 
-\begin_inset Quotes eld
+\begin_layout Itemize
+
+\change_deleted -1402925745 1514652372
+With spaced en dashes
+\begin_inset space ~
 \end_inset
 
+– common e.
+\begin_inset space \thinspace{}
+\end_inset
 
-\family typewriter
-.
-\family default
+g.
+ in British English and generally recommended by 
+\emph on
+The Elements of Typographic Style
+\emph default
 
-\begin_inset Quotes erd
+\begin_inset space ~
 \end_inset
 
- is at the end of a lowercase letter, it's the end of a sentence; if it's
- at the end of a capitalized letter, it's an abbreviation.
-\end_layout
+– line breaks should not occur before the dash.
+\change_unchanged
 
-\begin_layout Standard
-Here are some examples of 
-\emph on
-correct
-\emph default
- abbreviations and of the end of a sentence:
 \end_layout
 
 \begin_layout Itemize
-M.
- Butterfly
-\end_layout
 
-\begin_layout Itemize
-Don't worry.
- Be happy.
-\end_layout
+\lang french
+Les incises 
+\change_inserted -1402925745 1514642994
 
-\begin_layout Standard
-And here is an example of the algorithm going wrong:
-\end_layout
+\begin_inset Box Frameless
+position "t"
+hor_pos "c"
+has_inner_box 1
+inner_pos "t"
+use_parbox 0
+use_makebox 1
+width ""
+special "none"
+height "1in"
+height_special "totalheight"
+thickness "0.4pt"
+separation "3pt"
+shadowsize "4pt"
+framecolor "black"
+backgroundcolor "none"
+status open
 
-\begin_layout Itemize
-e.
-\begin_inset space \thinspace{}
-\end_inset
+\begin_layout Plain Layout
 
-g.
- this is too much space!
-\end_layout
+\change_inserted -1402925745 1514642994
 
-\begin_layout Itemize
-This is I.
- It's okay.
-\end_layout
+\lang french
+–
+\begin_inset space ~
+\end_inset
 
-\begin_layout Standard
-You will not see anything wrong until you view a final version of your document.
+même
 \end_layout
 
-\begin_layout Standard
-To fix this problem, use one of the following:
-\end_layout
+\end_inset
 
-\begin_layout Enumerate
-Use an 
-\family sans
-Inter-word
+\change_deleted -1402925745 1514642998
+–
 \begin_inset space ~
 \end_inset
 
-Space
-\family default
- after lowercase abbreviations (see section
+même
+\change_unchanged
+ si tout le monde ne les aime pas
 \begin_inset space ~
 \end_inset
 
+– sont très utiles.
+\end_layout
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Inter-word-Space"
-
-\end_inset
+\begin_layout Itemize
 
-).
-\begin_inset Index idx
+\lang spanish
+En una frase 
+\begin_inset ERT
 status collapsed
 
 \begin_layout Plain Layout
-Spaces ! inter-word
+
+
+\backslash
+nobreakdash
 \end_layout
 
 \end_inset
 
-
+—un inciso con rayas— se escribe así.
 \end_layout
 
-\begin_layout Enumerate
-Use a 
-\family sans
-Thin
+\end_deeper
+\begin_layout Standard
+An incorrect line break is easily overlooked because
 \begin_inset space ~
 \end_inset
 
-Space
-\family default
- between two tokens of an abbreviation (see section
+– in contrast to an overfull line
 \begin_inset space ~
 \end_inset
 
+– it does not trigger a warning in the \SpecialChar LaTeX
+ log.
+\change_deleted -1402925745 1514891753
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Thin-Space"
+\end_layout
 
-\end_inset
+\begin_layout Enumerate
 
-).
-\begin_inset Index idx
-status collapsed
+\change_deleted -1402925745 1514643500
+The default dashes output to \SpecialChar LaTeX
+ disable hyphenation in words adjacent to hyphens
+ and ligature dashes.
+\change_unchanged
 
-\begin_layout Plain Layout
-Spaces ! thin
 \end_layout
 
-\end_inset
+\begin_layout Standard
+If you want to globally disable line breaks after dashes, you can select
+ the option 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Fonts\SpecialChar menuseparator
+Disallow line breaks after dashes
+\change_deleted -1402925745 1514653511
 
+\family default
+.
+\change_inserted -1402925745 1514653512
+:
+\change_unchanged
 
 \end_layout
 
 \begin_layout Enumerate
-Use an 
-\family sans
-End
-\begin_inset space ~
-\end_inset
 
-of
-\begin_inset space ~
-\end_inset
+\change_inserted -1402925745 1514891789
+Line breaks are still allowed after spaced dashes.
+ They can be prevented using protected spaces (without need for a Makebox
+ inset or \SpecialChar TeX
+ code).
+ Example:
+\end_layout
 
-sentence
+\begin_deeper
+\begin_layout Itemize
+
+\change_inserted -1402925745 1514653363
+
+\lang french
+Les incises –
 \begin_inset space ~
 \end_inset
 
-period
-\family default
- found under the 
-\family sans
-Insert\SpecialChar menuseparator
-Special
+même  si tout le monde ne les aime pas
 \begin_inset space ~
 \end_inset
 
-Character
-\family default
- menu to force the use of inter-sentence spacing.
- This function is also bound to 
-\begin_inset Info
-type  "shortcut"
-arg   "specialchar-insert end-of-sentence"
-\end_inset
+– sont très utiles.
+\change_unchanged
 
- for easy access.
 \end_layout
 
-\begin_layout Standard
-With the corrections, our earlier examples look like this:
-\end_layout
+\end_deeper
+\begin_layout Enumerate
 
-\begin_layout Itemize
-e.
-\begin_inset space \thinspace{}
-\end_inset
+\change_deleted -1402925745 1514644579
+In this case optional l
+\change_inserted -1402925745 1514644580
+L
+\change_unchanged
+ine breaks after 
+\change_deleted -1402925745 1514646589
+individual
+\family sans
+\change_inserted -1402925745 1514646372
 
-g.
-\begin_inset space \space{}
+\family default
+unspaced 
+\change_unchanged
+dashes can be 
+\change_deleted -1402925745 1514644570
+re-
+\change_unchanged
+allowed via the menu
+\change_inserted -1402925745 1514891813
+
+\begin_inset Newline newline
 \end_inset
 
-this is too much space!
+
+\change_deleted -1402925745 1514891815
+\change_unchanged
+
+\family sans
+Insert\SpecialChar menuseparator
+Formatting\SpecialChar menuseparator
+Optional line break
+\family default
+:
 \end_layout
 
+\begin_deeper
 \begin_layout Itemize
-This is I\SpecialChar endofsentence
- It's okay.
-\end_layout
+Em-dashes without spaces—\SpecialChar allowbreak
 
-\begin_layout Standard
-Some languages don't use extra spacing between sentences.
- If your language is such a language, you don't need to worry, because \SpecialChar LaTeX
+\change_deleted -1402925745 1514644634
+as 
+\change_unchanged
+common in American English—\SpecialChar allowbreak
+should be 
+\change_deleted -1402925745 1514644706
+broken after the dash
+\change_inserted -1402925745 1514644714
+followed by a line break opportunity
+\change_unchanged
+.
+\change_inserted -1402925745 1514890478
 
- will take care of this.
 \end_layout
 
 \begin_layout Standard
-For those that do need to bother, there is help to catch those sneaky errors:
- Check out the 
-\family sans
-Check
+
+\change_inserted -1402925745 1514890517
+This also allows hyphenation of the word following the dash (cf.
+ section
 \begin_inset space ~
 \end_inset
 
-\SpecialChar TeX
-
-\family default
- feature described in the section 
-\emph on
-Checking \SpecialChar TeX
-
-\emph default
- of the 
-\emph on
-Additional Features
-\emph default
- manual.
-\end_layout
-
-\begin_layout Subsubsection
-Quot
-\change_deleted -712698321 1482667523
-es
-\change_inserted -712698321 1482669265
-ation Marks
-\change_unchanged
-
-\begin_inset Index idx
-status collapsed
 
-\begin_layout Plain Layout
-Typography ! Quot
-\change_deleted -712698321 1482669122
-es
-\change_inserted -712698321 1482669123
-ation marks
-\change_unchanged
-
-\end_layout
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Hyphenation"
+plural "false"
+caps "false"
+noprefix "false"
 
 \end_inset
 
-
-\begin_inset Index idx
-status open
-
-\begin_layout Plain Layout
-Quot
-\change_deleted -712698321 1482669129
-es
-\change_inserted -712698321 1482669204
-ation marks
+).
 \change_unchanged
- | see
-\begin_inset ERT
-status collapsed
-
-\begin_layout Plain Layout
 
-{
 \end_layout
 
-\end_inset
+\end_deeper
+\begin_layout Enumerate
 
-Typography
-\begin_inset ERT
-status collapsed
+\change_inserted -1402925745 1514653204
+With this setting, \SpecialChar LaTeX
+ hyphenates words also if immediately followed by em
+ or en dashes (cf.
+ section
+\begin_inset space ~
+\end_inset
 
-\begin_layout Plain Layout
 
-}
-\end_layout
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Hyphenation"
+plural "false"
+caps "false"
+noprefix "false"
 
 \end_inset
 
-
+).
 \end_layout
 
-\end_inset
-
+\begin_layout Subsubsection
 
+\change_inserted -1402925745 1514646777
+Changes and backwards compatibility
 \end_layout
 
 \begin_layout Standard
-\SpecialChar LyX
- usually sets quot
-\change_deleted -712698321 1482666231
-es
-\change_inserted -712698321 1482666233
-ation marks
+
+\change_deleted -1402925745 1514646781
+Note: 
 \change_unchanged
- correctly.
- Specifically, it will 
-\change_deleted -712698321 1482667043
-use
-\change_inserted -712698321 1482667044
-insert
+Up to \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.1, 
+\change_deleted -1402925745 1514653772
+you could insert en-dashes and em-dashes as -- and ---, respectively; they
+ were automatically merged to proper (breakable) dashes in the output, but
+ kept as
 \change_unchanged
- an opening 
-\change_deleted -712698321 1482666244
-quote
-\change_inserted -712698321 1482666245
-mark
+ consecutive hyphen characters 
+\change_inserted -1402925745 1514654314
+(-- and ---) 
 \change_unchanged
- at the beginning of quoted text, and use a closing 
-\change_deleted -712698321 1482666248
-quote
-\change_inserted -712698321 1482666249
-mark
+in the LyX
+\change_deleted -1402925745 1514653785
+ document
+\change_inserted -1402925745 1514654235
+ source were merged to en or em dashes by LaTeX
 \change_unchanged
- at the end.
- For example, 
+.
+\change_inserted -1402925745 1514653905
+These 
 \begin_inset Quotes eld
 \end_inset
 
-open close
+ligature dashes
 \begin_inset Quotes erd
 \end_inset
 
+ retain the line-break properties of hyphens while literal dash characters
+ are regarded by \SpecialChar LaTeX
+ as 
+\emph on
+non-breakable
+\emph default
 .
- The keyboard character, 
-\family sans
-"
-\family default
-, generates this automatically.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
-You can specify what character the 
-\family sans
-"
-\family default
- key produces 
-\change_inserted -712698321 1482669340
-by 
-\change_unchanged
-using the sub
-\change_inserted -712698321 1482667059
--
-\change_unchanged
-menu 
-\family sans
-Language
-\family default
- of the 
-\family sans
-Document\SpecialChar menuseparator
-Settings
-\family default
 
-\begin_inset Index idx
-status collapsed
+\change_deleted -1402925745 1514647104
+If you inserted literal dash characters, however, they were output to \SpecialChar LaTeX
+ as
+\emph on
+non-breakable
+\emph default
+ dashes (this was actually rather by accident than intentionally, but some
+ used these two forms of dashes deliberately).
+\change_inserted -1402925745 1514646979
 
-\begin_layout Plain Layout
-Document ! Settings
 \end_layout
 
-\end_inset
+\begin_layout Standard
 
- dialog 
-\change_deleted -712698321 1482667133
-in the box
-\change_inserted -712698321 1482669342
-and switching the
+\change_deleted -1402925745 1514653950
+As of
 \change_unchanged
  
-\family sans
-Quote Style
-\change_inserted -712698321 1482667108
-
-\family default
- (note that \SpecialChar LyX
- makes a sensible proposal for the selected main language)
-\change_unchanged
-.
- There are 
-\change_deleted -712698321 1482666221
-six
-\change_inserted -712698321 1482756786
-14
+\change_inserted -1402925745 1514653959
+Since 
 \change_unchanged
- choices:
-\end_layout
+\SpecialChar LyX
 
-\begin_layout Labeling
-\labelwidthstring <<Outer>> and <<inner>>:
-\noindent
+\begin_inset space ~
+\end_inset
 
-\change_deleted -712698321 1482666593
+2.2, 
+\change_deleted -1402925745 1514655286
+things work differently: consecutive hyphens are merged to dashes immediately
+ in the input.
 
-\family sans
+\change_inserted -1402925745 1514892048
+ consecutive hyphens in the LyX source are exported to \SpecialChar LaTeX
+ in a way that prevents
+ ligation to dashes.
 \begin_inset Quotes eld
 \end_inset
 
-Text
+Ligature dashes
 \begin_inset Quotes erd
 \end_inset
 
+ in documents from earlier versions are converted to literal dash characters
+ (except in 
+\family typewriter
+typewriter
+\family default
+ font); typed in consecutive hyphens are merged to dash characters immediately
+ after the input (unless the current text font is 
+\family typewriter
+type
+\family default
+writer).
+\change_unchanged
+
+\begin_inset Foot
+status open
 
-\change_inserted -712698321 1482666647
+\begin_layout Plain Layout
+The behavior was changed since 
+\change_deleted -1402925745 1514892102
+it led to different look in \SpecialChar LyX
+, text export, HTML export and the PDF export
+\change_inserted -1402925745 1514892145
 
 \begin_inset Quotes eld
 \end_inset
 
-Outer
+lyx --help
 \begin_inset Quotes erd
 \end_inset
 
-
-\begin_inset space ~
-\end_inset
-
-and
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset Quotes els
+ became 
+\begin_inset Quotes eld
 \end_inset
 
-inner
-\begin_inset Quotes ers
+lyx –help
+\begin_inset Quotes erd
 \end_inset
 
-
+ in PDF, Postscript, and DVI output
 \change_unchanged
+.
 
-\family default
+\change_inserted -1402925745 1514654876
+ An unintended consequence of these changes was that all dashes were output
+ as non-breakable dashes.
+ This also resulted in changed line breaks in some older documents.
  
-\change_deleted -712698321 1482666593
-Use quotes like
-\change_inserted -712698321 1482665592
-Produces
 \change_unchanged
-\begin_inset Quotes eld
-\end_inset
 
-th
-\change_inserted -712698321 1482665595
-e
-\change_deleted -712698321 1482666593
-i
-\change_unchanged
-s
-\change_inserted -712698321 1482665605
-e outer
-\change_unchanged
+\end_layout
 
-\begin_inset Quotes erd
 \end_inset
 
 
-\change_inserted -712698321 1482665637
- and 
-\begin_inset Quotes els
-\end_inset
+\change_deleted -1402925745 1514655286
+ If you copy consecutive hyphens, by contrast, they are output as consecutive
+ hyphen characters.
+ An unintended consequence of this change was that all dashes now were output
+ as non-breakable dashes.
+ Since furthermore, in order to maintain the output, occurrences of consecutive
+ hyphens in documents that were saved by \SpecialChar LyX
 
-these inner
-\begin_inset Quotes ers
+\begin_inset space ~
 \end_inset
 
- quotation marks (as common, e.
-\begin_inset space \thinspace{}
+2.1 or earlier versions, were converted to literal en- and em-dash characters,
+ respectively, these were output to \SpecialChar LaTeX
+ in \SpecialChar LyX
+
+\begin_inset space ~
 \end_inset
 
-g., in the US)
-\change_unchanged
+2.2 as 
+\emph on
+non-breakable
+\emph default
+ dashes as well.
+ An obvious drawback of all this was that it resulted in different line
+ breaks in some documents.
+\change_inserted -1402925745 1514891934
 
 \end_layout
 
-\begin_layout Labeling
-\labelwidthstring <<Outer>> and <<inner>>:
-
-\change_deleted -712698321 1482666660
+\begin_layout Standard
+\SpecialChar LyX
 
-\family sans
-\begin_inset Quotes sld
+\begin_inset space ~
 \end_inset
 
-Text
-\begin_inset Quotes srd
+2.3
+\change_deleted -1402925745 1514688984
+, by contrast and as outlined above,
+\change_unchanged
+ outputs 
+\emph on
+breakable
+\emph default
+ dashes by default
+\change_inserted -1402925745 1514654979
+.
+\change_deleted -1402925745 1514655571
+, so if you load a document saved previous to LyX 2.2, you should get the
+ identical output with LyX 2.3 for the dashes inserted with -- and ---.
+ Furthermore, \SpecialChar LyX
+
+\begin_inset space ~
 \end_inset
 
+2.3 provides the aforementioned option 
+\family sans
+Disallow line breaks after dashes
+\family default
+ in the menu 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Fonts.
 
-\change_inserted -712698321 1482666671
+\family default
+ It is off by default but selected when opening documents edited with \SpecialChar LyX
 
-\begin_inset Quotes sld
+\begin_inset space ~
 \end_inset
 
-Outer
-\begin_inset Quotes sld
-\end_inset
+2.2 in order to maintain line breaking between \SpecialChar LyX
+ 2.2 and 2.3 (so these document
+ have non-breakable dashes).
 
+\change_inserted -1402925745 1514892224
+ When opening documents edited with \SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-and
-\begin_inset space ~
+2.2 or earlier and containing literal dash characters not followed by whitespace,
+ the setting 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Fonts\SpecialChar menuseparator
+Disallow line breaks after dashes
+\family default
+ is active to prevent changes to the line breaks.
+\change_deleted -1402925745 1514655571
+
+\begin_inset Newline newline
 \end_inset
 
+Note the following side-effects of the changes in \SpecialChar LyX
+'s dash handling:
+\end_layout
 
-\begin_inset Quotes sls
-\end_inset
+\begin_layout Itemize
 
-inner
-\begin_inset Quotes srs
+\change_deleted -1402925745 1514649416
+If you used only literal em- and en dashes in pre-\SpecialChar LyX
+
+\begin_inset space ~
 \end_inset
 
+2.2 documents, you must manually select 
+\family sans
+Disallow line breaks after dashes
+\family default
+ to ensure unchanged behavior.
+\end_layout
 
-\change_unchanged
+\begin_layout Standard
 
-\family default
+\change_inserted -1402925745 1514892245
+
+\series bold
+Warning:
+\series default
  
-\change_deleted -712698321 1482666660
-Use quotes like ”this”
-\change_inserted -712698321 1482665692
-Produces 
-\begin_inset Quotes sld
-\end_inset
+\change_unchanged
+If you used both literal and 
+\change_inserted -1402925745 1514655424
 
-these outer
-\begin_inset Quotes sld
+\begin_inset Quotes eld
 \end_inset
 
- and 
-\begin_inset Quotes sls
+ligature
+\begin_inset Quotes erd
 \end_inset
 
-these inner
-\begin_inset Quotes srs
-\end_inset
 
- quotation marks (as common, e.
-\begin_inset space \thinspace{}
+\change_deleted -1402925745 1514655426
+--/---
+\change_unchanged
+ dashes in pre-\SpecialChar LyX
+
+\begin_inset space ~
 \end_inset
 
-g., in Sweden)
-\change_unchanged
+2.2 documents, you may need to enable or prevent individual line breaks as
+ shown above to restore the correct line breaking behavior.
+\change_deleted -1402925745 1514649416
 
 \end_layout
 
-\begin_layout Labeling
-\labelwidthstring <<Outer>> and <<inner>>:
+\begin_layout Itemize
 
-\change_deleted -712698321 1482666683
+\change_deleted -1402925745 1514649416
+Zero-width space (ZWSP) characters in older \SpecialChar LyX
+ documents that follow literal
+ em- and en-dashes are removed during the conversion to the format of \SpecialChar LyX
 
-\family sans
-\begin_inset Quotes gld
+\begin_inset space ~
 \end_inset
 
-Text
-\begin_inset Quotes grd
+2.3.
+ If you used them as optional line breaks after dashes, convert them to
+ space insets before opening your document with \SpecialChar LyX
+
+\begin_inset space ~
 \end_inset
 
+2.3 or the optional line breaks will be lost.
+\change_inserted -1402925745 1514649439
 
-\change_inserted -712698321 1482666696
+\end_layout
 
-\begin_inset Quotes gld
-\end_inset
+\begin_layout Subsection
+Hyphenation
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Hyphenation
+\end_layout
 
-Outer
-\begin_inset Quotes grd
 \end_inset
 
 
-\begin_inset space ~
-\end_inset
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Hyphenation"
 
-and
-\begin_inset space ~
 \end_inset
 
 
-\begin_inset Quotes gls
-\end_inset
+\end_layout
+
+\begin_layout Standard
+Words are not hyphenated within \SpecialChar LyX
+ but automatically in the output.
+ Hyphenation is done by the \SpecialChar LaTeX
+-package 
+\series bold
+babel
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! babel
+\end_layout
 
-inner
-\begin_inset Quotes grs
 \end_inset
 
+ following the rules of the document language.
 
+\change_inserted -1402925745 1514652600
+ \SpecialChar LaTeX
+ does not hyphenate text in the 
+\family sans
+typewriter
+\family default
+ font and words immediately preceded or followed by hyphens or dashes.
 \change_unchanged
 
+\end_layout
+
+\begin_layout Standard
+\SpecialChar LaTeX
+ hyphenates almost perfectly; it only has problems with 
+\change_deleted -1402925745 1514652587
+text in the 
+\family sans
+typewriter
 \family default
-\change_deleted -712698321 1482666683
-Use quotes like 
-\begin_inset Quotes gld
+ font and with 
+\change_unchanged
+unusual constructs, like 
+\begin_inset Quotes eld
 \end_inset
 
-this
-\begin_inset Quotes grd
+h3knix/m0n0wall
+\begin_inset Quotes erd
 \end_inset
 
-
-\change_inserted -712698321 1482665749
-Produces 
-\begin_inset Quotes gld
+.
+ If \SpecialChar LaTeX
+ cannot break a word correctly, you can set hyphenation points manually.
+ This is done with the menu 
+\family sans
+Insert\SpecialChar menuseparator
+Formatting\SpecialChar menuseparator
+Hyphenation
+\begin_inset space ~
 \end_inset
 
-these outer
-\begin_inset Quotes grd
+Point
+\family default
+.
+ These extra hyphenation points are only recommendations to \SpecialChar LaTeX
+.
+ If no hyphenation is necessary, \SpecialChar LaTeX
+ will ignore them.
+\end_layout
+
+\begin_layout Standard
+Sometimes you want to prevent words or constructs from being hyphenated.
+ Imagine that you are describing keybindings/shortcuts in your document
+ in the form 
+\begin_inset Quotes eld
 \end_inset
 
- and 
-\begin_inset Quotes gls
+A-b c
+\begin_inset Quotes erd
 \end_inset
 
-these inner
-\begin_inset Quotes grs
+.
+ \SpecialChar LaTeX
+ would then see the hyphen 
+\begin_inset Quotes eld
 \end_inset
 
- quotation marks (as common, e.
-\begin_inset space \thinspace{}
+-
+\begin_inset Quotes erd
 \end_inset
 
-g., in Germany)
+ as a 
+\change_deleted -1402925745 1514649694
+hyphenation
+\change_inserted -1402925745 1514649696
+line break
+\change_unchanged
+ possibility.
+\change_deleted -1402925745 1514649727
+Hyphenating
+\change_inserted -1402925745 1514649729
+A line break
 \change_unchanged
+ at this point would look ugly.
+ To prevent the shortcut from being 
+\change_deleted -1402925745 1514649715
+hyphenated
+\change_inserted -1402925745 1514649716
+broken
+\change_unchanged
+, you can use a protected hyphen (
+\family sans
+Insert\SpecialChar menuseparator
+Formatting\SpecialChar menuseparator
+Protected Hyphen
+\family default
+) or put it into a makebox as described in section 
+\emph on
+Prevent Hyphenation
+\emph default
+ of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
 
+Objects
+\emph default
+ manual.
 \end_layout
 
-\begin_layout Labeling
-\labelwidthstring <<Outer>> and <<inner>>:
+\begin_layout Subsection
+Punctuation Marks
+\begin_inset Index idx
+status collapsed
 
-\change_deleted -712698321 1482666707
+\begin_layout Plain Layout
+Punctuation marks
+\end_layout
 
-\family sans
-\begin_inset Quotes pld
 \end_inset
 
-Text
-\begin_inset Quotes prd
-\end_inset
 
+\end_layout
 
-\change_inserted -712698321 1482666716
+\begin_layout Subsubsection
+Abbreviations and End of Sentence
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Abbreviations"
 
-\begin_inset Quotes pld
 \end_inset
 
-Outer
-\begin_inset Quotes prd
-\end_inset
 
+\end_layout
 
-\begin_inset space ~
+\begin_layout Standard
+When \SpecialChar LyX
+ calls \SpecialChar LaTeX
+ to generate the final version of your document, \SpecialChar LaTeX
+ automatically
+ distinguishes between words, sentences, and abbreviations.
+ \SpecialChar LaTeX
+ then adds the 
+\begin_inset Quotes eld
 \end_inset
 
-and
-\begin_inset space ~
+appropriate amount of space.
+\begin_inset Quotes erd
 \end_inset
 
+ That means sentences get a little bit more space between the period and
+ the next word.
+ Abbreviations get the same amount of space after the period that a word
+ gets after another word.
+\end_layout
 
-\begin_inset Quotes pls
-\end_inset
-
-inner
-\begin_inset Quotes prs
+\begin_layout Standard
+Unfortunately, the algorithm for figuring out what's an abbreviation does
+ not work in all cases.
+ If a 
+\begin_inset Quotes eld
 \end_inset
 
 
-\change_unchanged
-
+\family typewriter
+.
 \family default
-\change_deleted -712698321 1482666707
-Use quotes like 
-\begin_inset Quotes pld
-\end_inset
 
-this
-\begin_inset Quotes prd
+\begin_inset Quotes erd
 \end_inset
 
+ is at the end of a lowercase letter, it's the end of a sentence; if it's
+ at the end of a capitalized letter, it's an abbreviation.
+\end_layout
 
-\change_inserted -712698321 1482665786
-Produces 
-\begin_inset Quotes pld
-\end_inset
+\begin_layout Standard
+Here are some examples of 
+\emph on
+correct
+\emph default
+ abbreviations and of the end of a sentence:
+\end_layout
 
-these outer
-\begin_inset Quotes prd
-\end_inset
+\begin_layout Itemize
+M.
+ Butterfly
+\end_layout
 
- and 
-\begin_inset Quotes pls
-\end_inset
+\begin_layout Itemize
+Don't worry.
+ Be happy.
+\end_layout
 
-these inner
-\begin_inset Quotes prs
-\end_inset
+\begin_layout Standard
+And here is an example of the algorithm going wrong:
+\end_layout
 
- quotation marks (as common, e.
+\begin_layout Itemize
+e.
 \begin_inset space \thinspace{}
 \end_inset
 
-g., in Poland)
-\change_unchanged
+g.
+ this is too much space!
+\end_layout
 
+\begin_layout Itemize
+This is I.
+ It's okay.
 \end_layout
 
-\begin_layout Labeling
-\labelwidthstring <<Outer>> and <<inner>>:
+\begin_layout Standard
+You will not see anything wrong until you view a final version of your document.
+\end_layout
 
-\change_deleted -712698321 1482666725
+\begin_layout Standard
+To fix this problem, use one of the following:
+\end_layout
 
+\begin_layout Enumerate
+Use an 
 \family sans
-\begin_inset Quotes cld
+Inter-word
+\begin_inset space ~
 \end_inset
 
-Text
-\begin_inset Quotes crd
+Space
+\family default
+ after lowercase abbreviations (see section
+\begin_inset space ~
 \end_inset
 
 
-\change_inserted -712698321 1482666730
-
-\begin_inset Quotes cld
-\end_inset
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Inter-word-Space"
 
-Outer
-\begin_inset Quotes crd
 \end_inset
 
+).
+\begin_inset Index idx
+status collapsed
 
+\begin_layout Plain Layout
+Spaces ! inter-word
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
+Use a 
+\family sans
+Thin
 \begin_inset space ~
 \end_inset
 
-and
+Space
+\family default
+ between two tokens of an abbreviation (see section
 \begin_inset space ~
 \end_inset
 
 
-\begin_inset Quotes cls
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Thin-Space"
+
 \end_inset
 
-inner
-\begin_inset Quotes crs
+).
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Spaces ! thin
+\end_layout
+
 \end_inset
 
 
-\change_unchanged
+\end_layout
+
+\begin_layout Enumerate
+Use an 
+\family sans
+End
+\begin_inset space ~
+\end_inset
+
+of
+\begin_inset space ~
+\end_inset
+
+sentence
+\begin_inset space ~
+\end_inset
 
+period
 \family default
-\change_deleted -712698321 1482666725
-Use quotes like 
-\begin_inset Quotes cld
+ found under the 
+\family sans
+Insert\SpecialChar menuseparator
+Special
+\begin_inset space ~
 \end_inset
 
-this
-\begin_inset Quotes crd
+Character
+\family default
+ menu to force the use of inter-sentence spacing.
+ This function is also bound to 
+\begin_inset Info
+type  "shortcut"
+arg   "specialchar-insert end-of-sentence"
 \end_inset
 
+ for easy access.
+\end_layout
 
-\change_inserted -712698321 1482665816
-Produces 
-\begin_inset Quotes cld
+\begin_layout Standard
+With the corrections, our earlier examples look like this:
+\end_layout
+
+\begin_layout Itemize
+e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+this is too much space!
+\end_layout
+
+\begin_layout Itemize
+This is I\SpecialChar endofsentence
+ It's okay.
+\end_layout
+
+\begin_layout Standard
+Some languages don't use extra spacing between sentences.
+ If your language is such a language, you don't need to worry, because \SpecialChar LaTeX
+
+ will take care of this.
+\end_layout
+
+\begin_layout Standard
+For those that do need to bother, there is help to catch those sneaky errors:
+ Check out the 
+\family sans
+Check
+\begin_inset space ~
+\end_inset
+
+\SpecialChar TeX
+
+\family default
+ feature described in the section 
+\emph on
+Checking \SpecialChar TeX
+
+\emph default
+ of the 
+\emph on
+Additional Features
+\emph default
+ manual.
+\end_layout
+
+\begin_layout Subsubsection
+Quotation Marks
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Typography ! Quotation marks
+\end_layout
+
+\end_inset
+
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Quotation marks | see
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+{
+\end_layout
+
+\end_inset
+
+Typography
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\SpecialChar LyX
+ usually sets quotation marks correctly.
+ Specifically, it will insert an opening mark at the beginning of quoted
+ text, and use a closing mark at the end.
+ For example, 
+\begin_inset Quotes eld
+\end_inset
+
+open close
+\begin_inset Quotes erd
+\end_inset
+
+.
+ The keyboard character, 
+\family sans
+"
+\family default
+, generates this automatically.
+\end_layout
+
+\begin_layout Standard
+You can specify what character the 
+\family sans
+"
+\family default
+ key produces by using the submenu 
+\family sans
+Language
+\family default
+ of the 
+\family sans
+Document\SpecialChar menuseparator
+Settings
+\family default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Document ! Settings
+\end_layout
+
+\end_inset
+
+ dialog and switching the 
+\family sans
+Quote Style
+\family default
+ (note that \SpecialChar LyX
+ makes a sensible proposal for the selected main language).
+ There are 14
+\begin_inset space ~
+\end_inset
+
+choices:
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring <<Outer>> and <<inner>>:
+\noindent
+
+\family sans
+\begin_inset Quotes eld
+\end_inset
+
+Outer
+\begin_inset Quotes erd
+\end_inset
+
+
+\begin_inset space ~
+\end_inset
+
+and
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Quotes els
+\end_inset
+
+inner
+\begin_inset Quotes ers
+\end_inset
+
+
+\family default
+ Produces 
+\begin_inset Quotes eld
 \end_inset
 
 these outer
-\begin_inset Quotes crd
+\begin_inset Quotes erd
 \end_inset
 
  and 
-\begin_inset Quotes cls
+\begin_inset Quotes els
 \end_inset
 
 these inner
-\begin_inset Quotes crs
+\begin_inset Quotes ers
 \end_inset
 
  quotation marks (as common, e.
 \begin_inset space \thinspace{}
 \end_inset
 
-g., in Switzerland)
-\change_unchanged
-
+g., in the US)
 \end_layout
 
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
 
-\change_deleted -712698321 1482666741
+\family sans
+\begin_inset Quotes sld
+\end_inset
+
+Outer
+\begin_inset Quotes sld
+\end_inset
+
+
+\begin_inset space ~
+\end_inset
+
+and
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Quotes sls
+\end_inset
+
+inner
+\begin_inset Quotes srs
+\end_inset
+
+
+\family default
+ Produces 
+\begin_inset Quotes sld
+\end_inset
+
+these outer
+\begin_inset Quotes sld
+\end_inset
+
+ and 
+\begin_inset Quotes sls
+\end_inset
+
+these inner
+\begin_inset Quotes srs
+\end_inset
+
+ quotation marks (as common, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., in Sweden)
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring <<Outer>> and <<inner>>:
 
 \family sans
-\begin_inset Quotes ald
+\begin_inset Quotes gld
 \end_inset
 
-Text
-\begin_inset Quotes ard
+Outer
+\begin_inset Quotes grd
 \end_inset
 
 
-\change_inserted -712698321 1482666747
+\begin_inset space ~
+\end_inset
 
-\begin_inset Quotes ald
+and
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Quotes gls
+\end_inset
+
+inner
+\begin_inset Quotes grs
+\end_inset
+
+
+\family default
+ Produces 
+\begin_inset Quotes gld
+\end_inset
+
+these outer
+\begin_inset Quotes grd
+\end_inset
+
+ and 
+\begin_inset Quotes gls
+\end_inset
+
+these inner
+\begin_inset Quotes grs
+\end_inset
+
+ quotation marks (as common, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., in Germany)
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring <<Outer>> and <<inner>>:
+
+\family sans
+\begin_inset Quotes pld
 \end_inset
 
 Outer
-\begin_inset Quotes ard
+\begin_inset Quotes prd
 \end_inset
 
 
 \end_inset
 
 
-\begin_inset Quotes als
+\begin_inset Quotes pls
 \end_inset
 
 inner
-\begin_inset Quotes ars
+\begin_inset Quotes prs
 \end_inset
 
 
-\change_unchanged
+\family default
+ Produces 
+\begin_inset Quotes pld
+\end_inset
+
+these outer
+\begin_inset Quotes prd
+\end_inset
+
+ and 
+\begin_inset Quotes pls
+\end_inset
+
+these inner
+\begin_inset Quotes prs
+\end_inset
+
+ quotation marks (as common, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., in Poland)
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring <<Outer>> and <<inner>>:
+
+\family sans
+\begin_inset Quotes cld
+\end_inset
+
+Outer
+\begin_inset Quotes crd
+\end_inset
+
+
+\begin_inset space ~
+\end_inset
+
+and
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Quotes cls
+\end_inset
+
+inner
+\begin_inset Quotes crs
+\end_inset
+
 
 \family default
-\change_deleted -712698321 1482666741
-Use quotes like 
+ Produces 
+\begin_inset Quotes cld
+\end_inset
+
+these outer
+\begin_inset Quotes crd
+\end_inset
+
+ and 
+\begin_inset Quotes cls
+\end_inset
+
+these inner
+\begin_inset Quotes crs
+\end_inset
+
+ quotation marks (as common, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., in Switzerland)
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring <<Outer>> and <<inner>>:
+
+\family sans
 \begin_inset Quotes ald
 \end_inset
 
-this
+Outer
 \begin_inset Quotes ard
 \end_inset
 
 
-\change_inserted -712698321 1482665851
-Produces 
+\begin_inset space ~
+\end_inset
+
+and
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Quotes als
+\end_inset
+
+inner
+\begin_inset Quotes ars
+\end_inset
+
+
+\family default
+ Produces 
 \begin_inset Quotes ald
 \end_inset
 
@@ -17572,8 +18346,6 @@ g., in Denmark)
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
 
-\change_inserted -712698321 1482666768
-
 \family sans
 \begin_inset Quotes qrd
 \end_inset
@@ -17622,8 +18394,6 @@ these inner
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
 
-\change_inserted -712698321 1482666784
-
 \family sans
 \begin_inset Quotes bld
 \end_inset
@@ -17676,8 +18446,6 @@ g., in Great Britain)
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
 
-\change_inserted -712698321 1482666803
-
 \family sans
 \begin_inset Quotes fld
 \end_inset
@@ -17730,8 +18498,6 @@ g., in France)
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
 
-\change_inserted -712698321 1482668207
-
 \family sans
 \begin_inset Quotes ild
 \end_inset
@@ -17779,14 +18545,10 @@ these inner
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted -712698321 1482668407
 Maybe you wonder why one does not simply use only outer marks in this case,
  since these look identical to the inner marks.
  The answer is that you cannot easily switch to another style then (where
  the inner marks differ).
-\change_unchanged
-
 \end_layout
 
 \end_inset
@@ -17797,8 +18559,6 @@ Maybe you wonder why one does not simply use only outer marks in this case,
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
 
-\change_inserted -712698321 1482666837
-
 \family sans
 \begin_inset Quotes rld
 \end_inset
@@ -17851,8 +18611,6 @@ g., in Russia)
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
 
-\change_inserted -712698321 1482756796
-
 \family sans
 \begin_inset Quotes wld
 \end_inset
@@ -17900,8 +18658,6 @@ these inner
 
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
-
-\change_inserted -712698321 1482757086
 \begin_inset Quotes jld
 \end_inset
 
@@ -17962,12 +18718,8 @@ g., in Japan)
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted -712698321 1482757158
 Note that these characters are just emulated with similar-looking math symbols
  in many encodings that do not cover these glyphs.
-\change_unchanged
-
 \end_layout
 
 \end_inset
@@ -17977,8 +18729,6 @@ Note that these characters are just emulated with similar-looking math symbols
 
 \begin_layout Labeling
 \labelwidthstring <<Outer>> and <<inner>>:
-
-\change_inserted -712698321 1482757171
 \begin_inset Quotes kld
 \end_inset
 
@@ -18039,8 +18789,6 @@ g., in North Korea and China)
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted -712698321 1482757171
 Note that these characters are just emulated with similar-looking math symbols
  in many encodings that do not cover these glyphs.
 \end_layout
@@ -18048,28 +18796,14 @@ Note that these characters are just emulated with similar-looking math symbols
 \end_inset
 
 
-\change_unchanged
-
 \end_layout
 
 \begin_layout Standard
-
-\change_deleted -712698321 1482667281
-For single
-\change_inserted -712698321 1482667281
-Inner
-\change_unchanged
- quot
-\change_deleted -712698321 1482666272
-es
-\change_inserted -712698321 1482667398
-ation marks
+Inner quotation marks
 \begin_inset Foot
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted -712698321 1482668512
 In many writing cultures, these are single quotation marks.
  But as the British and French styles show, this is not necessarily the
  case (and specifically the British style shows that 
@@ -18106,17 +18840,11 @@ outer
 \end_inset
 
  quotation marks.
-\change_unchanged
-
 \end_layout
 
 \end_inset
 
-
-\change_unchanged
-\change_inserted -712698321 1482668702
-for quotations inside quotations (and other tasks in some languages, such
+ for quotations inside quotations (and other tasks in some languages, such
  as 
 \begin_inset Quotes els
 \end_inset
@@ -18125,35 +18853,21 @@ scare quotes
 \begin_inset Quotes ers
 \end_inset
 
-) 
-\change_deleted -712698321 1482667343
-you have to use
-\change_inserted -712698321 1482667350
-can be obtained by means of
-\change_unchanged
- the shortcut 
+) can be obtained by means of the shortcut 
 \begin_inset Info
 type  "shortcut"
-arg   "quote-insert single"
+arg   "quote-insert inner"
 \end_inset
 
-
-\change_inserted -712698321 1482668731
  and via the 
 \family sans
 Insert\SpecialChar menuseparator
 Special Characters
 \family default
- menu
-\change_unchanged
-.
-\change_inserted -712698321 1482667602
-
+ menu.
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1482668992
 By default, the quotation mark styles are persistent.
  That is to say, a quotation mark maintains the style that was current when
  it was inserted, even if the document-wide style changes.
@@ -18180,8 +18894,6 @@ g., if your publisher requests a different style).
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1482667904
 Individual quotation marks (i.
 \begin_inset space \thinspace{}
 \end_inset
@@ -18189,8 +18901,6 @@ Individual quotation marks (i.
 e., their level [inner, outer], side [opening, closing], and style) can be
  easily switched by a context menu that pops up if you right-click on a
  mark.
-\change_unchanged
-
 \end_layout
 
 \begin_layout Subsection
@@ -18361,13 +19071,7 @@ fest
 \begin_layout Subsection
 \SpecialChar LyX
  and \SpecialChar LaTeX
-\change_deleted -712698321 1482669270
-l
-\change_inserted -712698321 1482669270
-L
-\change_unchanged
-ogos
+ Logos
 \begin_inset Index idx
 status collapsed
 
@@ -18379,13 +19083,6 @@ status collapsed
 \end_inset
 
 
-\begin_inset CommandInset label
-LatexCommand label
-name "subsec:LyX's-Proper-Names"
-
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -18657,6 +19354,7 @@ to the \SpecialChar LaTeX
 \begin_inset CommandInset citation
 LatexCommand cite
 key "latexcompanion"
+literal "true"
 
 \end_inset
 
@@ -18668,6 +19366,7 @@ key "latexcompanion"
 \begin_inset CommandInset citation
 LatexCommand cite
 key "latexguide"
+literal "true"
 
 \end_inset
 
@@ -18897,7 +19596,7 @@ you will see
  a box like this: 
 \begin_inset Graphics
        filename clipart/footnote.png
-       scale 80
+       scale 95
 
 \end_inset
 
@@ -19286,7 +19985,7 @@ The graphics dialog can be called at any time by clicking on an image.
 \begin_layout Standard
 \align center
 \begin_inset Graphics
-       filename clipart/mobius.eps
+       filename clipart/2D-intensity-plot.pdf
        scale 70
 
 \end_inset
@@ -23082,7 +23781,7 @@ Figure
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "fig:Platypus-distorted"
+reference "fig:A-star-in"
 
 \end_inset
 
@@ -23135,13 +23834,13 @@ arg   "layout-paragraph"
 \begin_inset Float figure
 wide false
 sideways false
-status collapsed
+status open
 
 \begin_layout Plain Layout
 \align center
 \begin_inset Graphics
-       filename clipart/platypus.eps
-       lyxscale 50
+       filename clipart/Star-structure.pdf
+       lyxscale 60
        width 50col%
 
 \end_inset
@@ -23155,11 +23854,11 @@ status collapsed
 \begin_layout Plain Layout
 \begin_inset CommandInset label
 LatexCommand label
-name "fig:Platypus-distorted"
+name "fig:A-star-in"
 
 \end_inset
 
-A severely distorted platypus in a float.
+A star in a float.
 \end_layout
 
 \end_inset
@@ -23255,7 +23954,7 @@ reference "subsec:List-of-Figures"
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "fig:Two-distorted-images"
+reference "fig:Two-images"
 
 \end_inset
 
@@ -23275,7 +23974,7 @@ reference "fig:Undefinable"
  and 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "fig:Platypus"
+reference "fig:Star"
 
 \end_inset
 
@@ -23318,7 +24017,8 @@ Undefinable
 
 \begin_layout Plain Layout
 \begin_inset Graphics
-       filename clipart/escher-lsd.eps
+       filename clipart/3D-structure-distort.pdf
+       lyxscale 60
        width 45col%
 
 \end_inset
@@ -23344,11 +24044,11 @@ status collapsed
 \begin_layout Plain Layout
 \begin_inset CommandInset label
 LatexCommand label
-name "fig:Platypus"
+name "fig:Star"
 
 \end_inset
 
-Platypus
+Star
 \end_layout
 
 \end_inset
@@ -23358,7 +24058,7 @@ Platypus
 
 \begin_layout Plain Layout
 \begin_inset Graphics
-       filename clipart/platypus.eps
+       filename clipart/Star-structure.pdf
        lyxscale 60
        width 45col%
 
@@ -23382,11 +24082,11 @@ Platypus
 \begin_layout Plain Layout
 \begin_inset CommandInset label
 LatexCommand label
-name "fig:Two-distorted-images"
+name "fig:Two-images"
 
 \end_inset
 
-Two distorted images.
+Two images.
 \end_layout
 
 \end_inset
@@ -27054,6 +27754,7 @@ multline
 \begin_inset CommandInset citation
 LatexCommand cite
 key "AMS"
+literal "true"
 
 \end_inset
 
@@ -27292,14 +27993,14 @@ reference "subsec:Protected-Space"
 \end_layout
 
 \begin_layout Standard
-There are six formats of cross-references:
+There are eight formats of cross-references:
 \end_layout
 
 \begin_layout Description
 <reference>: prints the number, this is the default: 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "fig:Two-distorted-images"
+reference "fig:Two-images"
 
 \end_inset
 
@@ -27335,7 +28036,7 @@ reference "eq:tanhExp"
 
 \begin_inset CommandInset ref
 LatexCommand pageref
-reference "fig:Two-distorted-images"
+reference "fig:Two-images"
 
 \end_inset
 
@@ -27354,7 +28055,7 @@ page
 <page>: prints the text “on page” and the page number: 
 \begin_inset CommandInset ref
 LatexCommand vpageref
-reference "fig:Two-distorted-images"
+reference "fig:Two-images"
 
 \end_inset
 
@@ -27386,7 +28087,7 @@ page
 <page>: prints the number, the text “on page” and the page number: 
 \begin_inset CommandInset ref
 LatexCommand vref
-reference "fig:Two-distorted-images"
+reference "fig:Two-images"
 
 \end_inset
 
@@ -27450,7 +28151,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! prettyref
+ packages ! prettyref
 \end_layout
 
 \end_inset
@@ -27461,7 +28162,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! refstyle
+ packages ! refstyle
 \end_layout
 
 \end_inset
@@ -27524,15 +28225,11 @@ fig
 \begin_inset Quotes erd
 \end_inset
 
-) can be done
-\change_inserted 424524441 1483414614
-, for refstyle,
-\change_unchanged
- with this command
-\change_inserted 424524441 1483414616
-:
-\change_unchanged
-
+) can be done for 
+\series bold
+refstyle
+\series default
+ with this command:
 \begin_inset Newline newline
 \end_inset
 
@@ -27548,27 +28245,65 @@ pageref{#1}}}
 \begin_inset Newline newline
 \end_inset
 
-For more information about the format, have a look at the package documentations
-, 
+Note that neither 
+\series bold
+prettyref
+\series default
+ nor 
+\series bold
+refstyle 
+\series default
+predefines reference formats for all available types.
+ This is especially true for the wide variety of mathematical `theorem'
+ environments.
+ So if you want to make formatted references to, say, Propositions, then
+ you will need to define the relevant format yourself.
+ For 
+\series bold
+prettyref
+\series default
+, you might do so as follows:
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+
+\backslash
+newrefformat{prop}{Proposition 
+\backslash
+ref{#1}}
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+For more information about defining formatted references, have a look at
+ the package documentation 
 \begin_inset CommandInset citation
 LatexCommand cite
 key "prettyref,refstyle"
+literal "true"
 
 \end_inset
 
 .
-\change_inserted 424524441 1483414624
-
 \begin_inset Newline newline
 \end_inset
 
-The `Plural' and `Capitalized' options will be available with formatted
- references only if you are using the 
+The options 
+\family sans
+Plural
+\family default
+ and 
+\family sans
+Capitalized
+\family default
+ will be available with formatted references only if you are using the 
 \series bold
 refstyle
 \series default
  package.
- See its documentation, again, for more information.
 \end_layout
 
 \begin_layout Description
@@ -27579,33 +28314,70 @@ Textual
 reference: prints the caption or the name of the reference: 
 \begin_inset CommandInset ref
 LatexCommand nameref
-reference "fig:Two-distorted-images"
+reference "fig:Two-images"
 
 \end_inset
 
 
-\change_inserted 424524441 1483414460
-
 \end_layout
 
 \begin_layout Description
-
-\change_inserted 424524441 1483414501
 Label
 \begin_inset space ~
 \end_inset
 
 only: prints only the \SpecialChar LaTeX
- label for the reference.
- This allows for customization, using ERT, if you want to issue a command
- that LyX does not support.
-\change_deleted 424524441 1483414539
+ label for the reference
+\begin_inset CommandInset ref
+LatexCommand labelonly
+reference "fig:Two-images"
 
-\end_layout
+\end_inset
 
-\begin_layout Standard
-The number and current page of the referenced document part in the output
- is automatically calculated by \SpecialChar LaTeX
+
+\begin_inset Newline newline
+\end_inset
+
+This allows for customization, using \SpecialChar TeX
+ Code, if you want to issue a command
+ that \SpecialChar LyX
+ does not support.
+ If you are using 
+\series bold
+refstyle
+\series default
+, then you may want to use the 
+\family sans
+No
+\begin_inset space ~
+\end_inset
+
+Prefix
+\family default
+ option, which will output only the part of the reference following the
+\begin_inset Quotes eld
+\end_inset
+
+:
+\begin_inset Quotes erd
+\end_inset
+
+ separator.
+ This is the form needed for e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+
+\series bold
+refstyle
+\series default
+'s range commands.The number and current page of the referenced document
+ part in the output is automatically calculated by \SpecialChar LaTeX
 .
  The varieties are adjusted in the field 
 \family sans
@@ -27709,87 +28481,6 @@ Embedded
 Objects
 \emph default
  manual.
-\change_inserted 424524441 1483414754
-
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted 424524441 1483414754
-\begin_inset Note Greyedout
-status open
-
-\begin_layout Plain Layout
-
-\change_inserted 424524441 1483414754
-
-\series bold
-Note:
-\series default
- It is recommended to use the \SpecialChar LaTeX
--package 
-\series bold
-refstyle
-\series default
-
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted 424524441 1483414754
-\SpecialChar LaTeX
--packages ! refstyle
-\end_layout
-
-\end_inset
-
- because 
-\series bold
-prettyref
-\series default
-
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted 424524441 1483414754
-\SpecialChar LaTeX
--packages ! prettyref
-\end_layout
-
-\end_inset
-
- does not know all of \SpecialChar LyX
-'s possible label shortcuts
-\begin_inset Foot
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted 424524441 1483414754
-\begin_inset Quotes eld
-\end_inset
-
-fig:
-\begin_inset Quotes erd
-\end_inset
-
- is for example \SpecialChar LyX
-'s shortcut for labels in figure captions.
-\end_layout
-
-\end_inset
-
- and is not internationalized.
-\end_layout
-
-\end_inset
-
-
-\change_unchanged
-
 \end_layout
 
 \begin_layout Section
@@ -27997,7 +28688,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.lyx.org
+https://www.lyx.org
 \end_layout
 
 \end_inset
@@ -28072,7 +28763,8 @@ Name
 \begin_inset CommandInset href
 LatexCommand href
 name "LyX's homepage"
-target "http://www.lyx.org"
+target "https://www.lyx.org"
+literal "false"
 
 \end_inset
 
@@ -28082,10 +28774,21 @@ LatexCommand href
 name "lyx-docs mailing list"
 target "lyx-docs@lists.lyx.org?subject=LyX's documentation"
 type "mailto:"
+literal "false"
 
 \end_inset
 
 , or a link to a file.
+ The option 
+\family sans
+Literal
+\family default
+ in the hyperlink settings dialog allows to input \SpecialChar TeX
+ code to the 
+\family sans
+Name
+\family default
+ field.
 \end_layout
 
 \begin_layout Standard
@@ -28117,7 +28820,8 @@ Hyperlinks will automatically be hyphenated if necessary in the PDF output,
 \begin_inset CommandInset href
 LatexCommand href
 name "LyX's homepage"
-target "http://www.lyx.org"
+target "https://www.lyx.org"
+literal "false"
 
 \end_inset
 
@@ -28255,32 +28959,27 @@ name "sec:Bibliography"
 
 \begin_layout Standard
 There are two ways of generating the bibliography in a \SpecialChar LyX
--document.
- You can include a bibliography database,
-\begin_inset Foot
-status collapsed
-
-\begin_layout Plain Layout
-Known under the name 
-\begin_inset Quotes eld
+ document.
+ You can include a bibliography database, which is explained in sec.
+\begin_inset space ~
 \end_inset
 
-Bib\SpecialChar TeX
- database
-\begin_inset Quotes erd
-\end_inset
 
-.
-\end_layout
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Bibliography-databases"
+plural "false"
+caps "false"
+noprefix "false"
 
 \end_inset
 
- which is explained in the next subsection, or you can insert the bibliography
- manually, using the paragraph environment 
+, or you can insert the bibliography manually, using the paragraph environment
 \family sans
 Bibliography
 \family default
-, which was described in section
+, which is described in the following section (but see also sec.
 \begin_inset space ~
 \end_inset
 
@@ -28291,17 +28990,38 @@ reference "subsec:Biblio_environment"
 
 \end_inset
 
-.
+).
  If you want anything other than the numerical citations that are used in
- this document, like author-year citations, then you must
+ this document, such as author-year citations, and if you have more than
+ a handful of references, then you should seriously consider
 \emph on
  
 \emph default
-use a bibliography database.
+using a bibliography database.
+\end_layout
+
+\begin_layout Standard
+In order to demonstrate the difference between these two approaches, we
+ use two bibliographies in this document, a 
+\family sans
+Bibliography
+\family default
+ environment and a database-generated bibliography.
+ As you can see, the bibliography that is created from a database lists
+ only the database entries that are referenced in the document.
+ In other words, the database approach relieves you, amongst other things,
+ from the burden to check which entries you have actually cited.
 \end_layout
 
 \begin_layout Subsection
 The Bibliography Environment
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:The-Bibliography-Environment"
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Standard
@@ -28322,6 +29042,43 @@ Label
 .
  The key is the symbolic name by which you will refer to this bibliography
  entry.
+ Each entry needs to be given a unique key, which is one word consisting
+ of ASCII characters only.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+ASCII means 
+\begin_inset CommandInset href
+LatexCommand href
+name "this set"
+target "https://en.wikipedia.org/wiki/ASCII#Character_set"
+literal "false"
+
+\end_inset
+
+ of characters:
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Flex URL
+status open
+
+\begin_layout Plain Layout
+
+https://en.wikipedia.org/wiki/ASCII
+\backslash
+#Character_set
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
  For example, our second entry in the bibliography is a book about \SpecialChar LaTeX
  and
  we used 
@@ -28333,6 +29090,26 @@ latexcompanion
 \end_inset
 
 , a short form of its title, as the key.
+\begin_inset Newline newline
+\end_inset
+
+If you set a 
+\family sans
+Label
+\family default
+ for the entry, references to it will appear with this label instead of
+ the number of the entry.
+ The option 
+\family sans
+Literal
+\family default
+ in the bibliography items settings dialog allows to input \SpecialChar TeX
+ code to the
+\family sans
+Label
+\family default
+ field.
 \end_layout
 
 \begin_layout Standard
 \end_layout
 
 \begin_layout Standard
-Citation references appear in the output as the number of the bibliography
- entry with surrounding brackets.
- If you set a 
-\family sans
-Label
-\family default
- for the entry, the label will appear instead of the number.
+Citation references appear in the output as the number or the label of the
+ bibliography entry with surrounding brackets.
  Here are two examples; the first without a label, the second with the label
  
 \begin_inset Quotes eld
@@ -28395,6 +29167,7 @@ Have a look at the
 \begin_inset CommandInset citation
 LatexCommand cite
 key "latexcompanion"
+literal "true"
 
 \end_inset
 
@@ -28407,12 +29180,94 @@ The \SpecialChar LyX
 \begin_inset CommandInset citation
 LatexCommand cite
 key "lyxcredit"
+literal "true"
 
 \end_inset
 
 
 \end_layout
 
+\begin_layout Standard
+You can also produce author-year or author-number citations, using the \SpecialChar LaTeX
+
+ package 
+\series bold
+natbib
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! natbib
+\end_layout
+
+\end_inset
+
+.
+ In order to do so, the label needs to be given the form 
+\begin_inset Quotes eld
+\end_inset
+
+Author(Year)
+\begin_inset Quotes erd
+\end_inset
+
+ or 
+\begin_inset Quotes eld
+\end_inset
+
+Author A and Author B(Year)
+\begin_inset Quotes erd
+\end_inset
+
+\emph on
+without
+\emph default
+ a blank between the author(s) and the opening parenthesis that delimits
+ the year.
+ Then, if you select 
+\family sans
+Natbib
+\begin_inset space ~
+\end_inset
+
+(BibTeX)
+\family default
+ in the document settings
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Document ! Settings
+\end_layout
+
+\end_inset
+
+ dialog under 
+\family sans
+Bibliography\SpecialChar menuseparator
+Style
+\begin_inset space ~
+\end_inset
+
+format
+\family default
+ (see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Citation-Format"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+), you can select between different author-year or author-number styles.
+\end_layout
+
 \begin_layout Standard
 To align all entries in the bibliography environment you can set a longest
  label via the menu 
@@ -28435,8 +29290,7 @@ arg   "layout-paragraph"
 \end_layout
 
 \begin_layout Subsection
-Bibliography databases (Bib\SpecialChar TeX
-)
+Bibliography databases
 \begin_inset Index idx
 status collapsed
 
@@ -28447,17 +29301,6 @@ Bibliography ! Databases
 \end_inset
 
 
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-Bibliography ! Bib\SpecialChar TeX
-
-\end_layout
-
-\end_inset
-
-
 \begin_inset CommandInset label
 LatexCommand label
 name "subsec:Bibliography-databases"
@@ -28468,7 +29311,7 @@ name "subsec:Bibliography-databases"
 \end_layout
 
 \begin_layout Standard
-Bibliography databases are useful if you use the same bibliography in different
+Bibliography databases are useful if you use the same references in different
  documents.
 \begin_inset Foot
 status collapsed
@@ -28511,6 +29354,7 @@ The database is a text file with the file extension
 \begin_inset CommandInset citation
 LatexCommand cite
 key "BibTeX-2"
+literal "true"
 
 \end_inset
 
@@ -28519,6 +29363,7 @@ key "BibTeX-2"
 \begin_inset CommandInset citation
 LatexCommand cite
 key "Mittelbach,Kopka,Lamport"
+literal "true"
 
 \end_inset
 
@@ -28532,16 +29377,128 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/BibTeX/Programs
+https://wiki.lyx.org/BibTeX/Programs
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+\SpecialChar LyX
+ supports two different approaches to use bibliography databases in a document.
+ Bib\SpecialChar TeX
+ is the classic technique that has been the only way to use such databases
+ for a long time.
+ It is quite established and mature and there is a huge range of existing
+ styles available.
+ But it has its drawbacks, especially when it comes to more complex bibliographi
+c needs and support for specific languages and scripts.
+ Those are addressed by 
+\series bold
+biblatex
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! biblatex
 \end_layout
 
 \end_inset
 
 .
+ It reads the same database format than Bib\SpecialChar TeX
+ (although it has been significantly
+ extended beyond Bib\SpecialChar TeX
+'s scope)
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+Meaning: While 
+\noun on
+Biblatex
+\noun default
+ can handle any classic Bib\SpecialChar TeX
+ database, Bib\SpecialChar TeX
+ might conversely fail to correctly
+ handle databases that use specific 
+\noun on
+Biblatex
+\noun default
+ features.
+\end_layout
+
+\end_inset
+
+, but it uses a different framework to generate citations and references
+ from it.
 \end_layout
 
 \begin_layout Standard
-To use a database, use the menu 
+To select if Bib\SpecialChar TeX
+ or 
+\series bold
+biblatex
+\series default
+ should be used, set in the document settings (menu 
+\family sans
+Document\SpecialChar menuseparator
+Settings
+\family default
+)
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Document ! Settings
+\end_layout
+
+\end_inset
+
+ under 
+\family sans
+Bibliography
+\family default
+ the 
+\family sans
+Style
+\begin_inset space ~
+\end_inset
+
+format
+\family default
+ to a Bib\SpecialChar TeX
+ or a 
+\family sans
+Biblatex
+\family default
+ format.
+\end_layout
+
+\begin_layout Subsubsection
+Bib\SpecialChar TeX
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Bibliography ! Bib\SpecialChar TeX
+
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+To access a database via Bib\SpecialChar TeX
+, use the menu 
 \family sans
 Insert\SpecialChar menuseparator
 List
@@ -28549,17 +29506,18 @@ List
 /
 \family sans
 TOC\SpecialChar menuseparator
-BibTeX
+Bib(la)TeX
 \begin_inset space ~
 \end_inset
 
 Bibliography
 \family default
 .
- A gray box will be inserted and a window appears.
- In this window you can add one or more databases and select a 
+ A window will appear in which you can add one or more databases and select
+ a Bib\SpecialChar TeX
+
 \family sans
-style
+ style
 \family default
  file.
  The option 
@@ -28576,7 +29534,8 @@ Content
 \end_layout
 
 \begin_layout Standard
-The style file is a text file with the file extension 
+The Bib\SpecialChar TeX
+ style file is a text file with the file extension 
 \begin_inset Quotes eld
 \end_inset
 
@@ -28606,7 +29565,8 @@ For information on how this is done, have a look at
 
 \begin_inset CommandInset href
 LatexCommand href
-target "http://mirrors.ctan.org/biblio/bibtex/contrib/doc/btxhak.pdf"
+target "https://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/btxhak.pdf"
+literal "false"
 
 \end_inset
 
@@ -28615,118 +29575,381 @@ target "http://mirrors.ctan.org/biblio/bibtex/contrib/doc/btxhak.pdf"
 
 \end_inset
 
-
+ In this document we used the Bib\SpecialChar TeX
+ style 
+\family sans
+alphadin.bst
+\family default
+, which provides an alpha-numeric style in accordance with the German Standards
+ Institute (DIN).
 \end_layout
 
 \begin_layout Standard
 Inserting a citation reference works as described in the previous section.
 \end_layout
 
+\begin_layout Subsubsection
+Biblatex
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Bibliography ! Biblatex
+\end_layout
+
+\end_inset
+
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! biblatex
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
 \begin_layout Standard
-To generate the bibliography from a database, \SpecialChar LyX
- uses the program Bib\SpecialChar TeX
+Accessing a database via 
+\series bold
+biblatex
+\series default
+ is almost identical to Bib\SpecialChar TeX
+: Use the menu 
+\family sans
+Insert\SpecialChar menuseparator
+List
+\family default
+/
+\family sans
+TOC\SpecialChar menuseparator
+Bib(la)TeX
+\begin_inset space ~
+\end_inset
+
+Bibliography
+\family default
 .
You can choose which of its variants should be used by \SpecialChar LyX
- as the 
In contrary to Bib\SpecialChar TeX
+ you cannot select a 
 \family sans
-Processor
+style
 \family default
- either in 
+ file.
+ The other dialog options are the same as with Bib\SpecialChar TeX
+.
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+biblatex
+\series default
+ has two different style files: a bibliography style file (text file with
+ the file extension 
+\begin_inset Quotes eld
+\end_inset
+
+
 \family sans
-Document\SpecialChar menuseparator
-Settings\SpecialChar menuseparator
+.bbx
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+) controls how the bibliography entries will look like and a citation style
+ file (text file with the file extension 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+.cbx
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+) controls the look of the citation references in the text.
+ Usually such style files come in pairs and it makes sense to use matching
+ styles.
+ It is nevertheless possible to mix any citation style with any bibliography
+ style.
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+biblatex
+\series default
+ styles are not set in the 
+\family sans
+Bib(la)TeX
+\begin_inset space ~
+\end_inset
+
 Bibliography
 \family default
- or in 
+ dialog, but in the document settings.
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Document ! Settings
+\end_layout
+
+\end_inset
+
+ However, in the dialog in the 
+\family sans
+Options
+\family default
+ field, which is only visible if you use 
+\series bold
+biblatex
+\series default
+, you can enter options that determine how the bibliography is printed (for
+ example how its heading will appear).
+ These options are deescribed in detail in the 
+\series bold
+biblatex
+\series default
+ manual, 
+\begin_inset CommandInset citation
+LatexCommand cite
+key "Biblatex"
+literal "true"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+Inserting a citation reference works as described in section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:The-Bibliography-Environment"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsubsection
+Bibliography Processors
+\end_layout
+
+\begin_layout Standard
+To generate the bibliography from a database, \SpecialChar LyX
+ uses a bibliography processor,
+ that is an external program that reads the database, sorts the citations
+ and processes the data in a way it can be included in the document.
+ The classic program is called Bib\SpecialChar TeX
+.
+ It has the advantage that it is very mature and widespread, but the disadvantag
+e that it has severe limitations, due to its age.
+\end_layout
+
+\begin_layout Standard
+Meanwhile, some alternatives have been developed that address some of these
+ limitations.
+ LyX natively supports some of them and lets you select a custom processor.
+ You can do this on a general level in 
 \family sans
 Tools\SpecialChar menuseparator
 Preferences\SpecialChar menuseparator
 Output\SpecialChar menuseparator
 LaTeX
+\family default
+ or for individual documents in 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
 \family default
 .
- The following variants are possible:
+ The following variants are available by default:
 \end_layout
 
 \begin_layout Description
-biber provides full Unicode support, unlimited memory, but does not work
- with other bibliography packages (e.
-\begin_inset space \thinspace{}
-\end_inset
+biber a specific, modern processor
+\begin_inset Index idx
+status collapsed
 
-g.
-\begin_inset space \space{}
-\end_inset
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! biber
+\end_layout
 
+\end_inset
 
+ developed exclusively for 
 \series bold
-natbib
+biblatex
 \series default
-), only with the package 
+ (it does not work with Bib\SpecialChar TeX
+!).
+\series bold
+biber
+\series default
+ provides full Unicode support, unlimited memory and many specific features
+\series bold
+biblatex
+\series default
+ makes use of; if you use the 
 \series bold
 biblatex
 \series default
-; recommended for multilingual texts and for languages that don't use Latin
- letters
+ approach, it is strongly recommended to use 
+\series bold
+biber
+\series default
+.
 \end_layout
 
 \begin_layout Description
 bibtex the standard; does not allow special characters in bibliography entries
  that are not possible to encode in a 7-bit encoding, limited memory, works
- with all bibliography packages, except 
+ with all bibliography packages, although it will probably fail with 
 \series bold
 biblatex
+\series default
+ bibliographies due to the limited memory.
 \end_layout
 
 \begin_layout Description
-bibtex8 allows all characters that are possible to encode in an 8-bit encoding,
- larger memory than 
+bibtex8 allows all characters that are possible to encode in an 8-bit encoding
(but no Unicode support), larger memory than 
 \family sans
 bibtex
 \family default
-, works with all bibliography packages
+, works with all bibliography packages, although more complex 
+\series bold
+biblatex
+\series default
+ bibliographies will exceed its limits, and not all 
+\series bold
+biblatex
+\series default
+ features are supported.
 \end_layout
 
 \begin_layout Standard
-Bib\SpecialChar TeX
- can be controlled with options that you can add below the specification
- of the variants.
- Before adding options, it is strongly recommended that you read the manual
- of 
+By default (with the 
 \family sans
-Bib\SpecialChar TeX
-
+Processor
+\family default
+ set in 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
 \family default
+ and with 
+\family sans
+Automatic
+\family default
+ as setting for the 
+\family sans
+Processor
+\family default
+ in 
+\family sans
+Tools\SpecialChar menuseparator
+Preferences\SpecialChar menuseparator
+Output\SpecialChar menuseparator
+LaTeX
+\family default
+), \SpecialChar LyX
+ selects an appropriate (available) processor for the current bibliography
+ approach (
+\series bold
+biber
+\series default
+ for 
+\series bold
+biblatex
+\series default
+, 
+\family sans
+bibtex
+\family default
+ for Bib\SpecialChar TeX
+-based bibliography styles).
+ This should suit most needs.
+\end_layout
+
+\begin_layout Standard
+In Japanese documents, a specific processor is used.
+ By default this is pBib\SpecialChar TeX
+ (in \SpecialChar LyX
  
+\family sans
+pbibtex
+\family default
+), a Bib\SpecialChar TeX
+ variant specifically aimed at Japanese.
+ You can adjust it in 
+\family sans
+Tools\SpecialChar menuseparator
+Preferences\SpecialChar menuseparator
+Output\SpecialChar menuseparator
+LaTeX
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+Selected bibliography processors can be controlled with options that you
+ can add below the selection.
+ Before adding options, it is strongly recommended that you read the manual
+ of Bib\SpecialChar TeX
+ or 
+\series bold
+biber
+\series default
+, 
 \begin_inset CommandInset citation
 LatexCommand cite
-key "BibTeX"
+key "BibTeX,biber"
+literal "true"
 
 \end_inset
 
 .
 \end_layout
 
+\begin_layout Subsubsection
+Customizing
+\end_layout
+
 \begin_layout Standard
-When you select the option 
-\family sans
-Sectioned bibliography
-\family default
- in the 
-\family sans
-Document\SpecialChar menuseparator
-Settings\SpecialChar menuseparator
-Bibliography
-\family default
- dialog, it is possible to have multiple and sectioned bibliographies.
- This and other options are explained in detail in section 
+\SpecialChar LyX
+ supports some specific tasks such as sectioned bibliographies and multiple
+ bibliographies.
+ These are explained in detail in section 
 \emph on
 Customizing Bibliographies
 \emph default
  
 \emph on
 with Bib\SpecialChar TeX
-
+ or Biblatex
 \emph default
  of the 
 \emph on
@@ -28735,18 +29958,6 @@ Additional Features
  manual.
 \end_layout
 
-\begin_layout Standard
-We use two bibliographies in this document to show the difference between
- the two methods of creating them.
- As you can see, the bibliography that is created from a database lists
- only the database entries that are referenced in the document.
- We used the style file 
-\family sans
-alphadin.bst
-\family default
- to get the complicated German reference key scheme in the bibliography.
-\end_layout
-
 \begin_layout Subsection
 Citation Format
 \begin_inset Index idx
@@ -28759,18 +29970,61 @@ Bibliography ! Citation format
 \end_inset
 
 
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Citation-Format"
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Standard
-In the citation reference dialog you can set a special citation format.
- For this feature you need to enable the option 
-\family sans
-Natbib
-\family default
- in the 
+Many different citation formats are common, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+numerical citation (as 
+\begin_inset Quotes eld
+\end_inset
+
+1
+\begin_inset Quotes erd
+\end_inset
+
+ like in this document), alpha-numerical citations (as 
+\begin_inset Quotes eld
+\end_inset
+
+Mil08
+\begin_inset Quotes erd
+\end_inset
+
+) or author-year citations (as 
+\begin_inset Quotes eld
+\end_inset
+
+Miller (2008a)
+\begin_inset Quotes erd
+\end_inset
+
+).
+ \SpecialChar LyX
+ supports these formats via specific citation packages and their style
+ files.
+\end_layout
+
+\begin_layout Standard
+By default a simple numeric citation style is used.
+ In 
 \family sans
 Document\SpecialChar menuseparator
-Settings
+Settings\SpecialChar menuseparator
+Bibliography
 \family default
 
 \begin_inset Index idx
@@ -28782,21 +30036,325 @@ Document ! Settings
 
 \end_inset
 
- dialog under 
+ you have a range of other options, depending on your preferred bibliography
+ approach.
+ With the 
 \family sans
 Bibliography
+\family default
+ environment your only choice besides manual formatting of the bibliography
+ labels, is there to use 
+\family sans
+Natbib
+\begin_inset space ~
+\end_inset
+
+(BibTeX)
+\family default
+\series bold
+\series default
+as 
+\family sans
+Style
+\begin_inset space ~
+\end_inset
+
+format
+\family default
+ which gives you author-year and author-numerical citations (see above 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:The-Bibliography-Environment"
+
+\end_inset
+
+ for details).
+\end_layout
+
+\begin_layout Standard
+With a bibliography database (see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Bibliography-databases"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+) one has in contrary to the 
+\family sans
+Bibliography
+\family default
+ environment full access to the formatting styles.
+ These style formats are available:
+\end_layout
+
+\begin_layout Description
+Basic
+\begin_inset space ~
+\end_inset
+
+(BibTeX) the default Bib\SpecialChar TeX
+-based approached without any additional packages
+ (simple numeric citations).
+\end_layout
+
+\begin_layout Description
+Biblatex loads the package 
+\series bold
+biblatex
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! biblatex
+\end_layout
+
+\end_inset
+
+ and lets you select a style in the dropdown boxes 
+\family sans
+Biblatex citation style
+\family default
+ and 
+\family sans
+Biblatex bibliography style
+\family default
+ below.
+ Options to the package 
+\series bold
+biblatex
+\series default
+ can be entered in the 
+\family sans
+Options
+\family default
+ field.
+\end_layout
+
+\begin_layout Description
+Biblatex
+\begin_inset space ~
+\end_inset
+
+(natbib
+\begin_inset space ~
+\end_inset
+
+mode) loads the package 
+\series bold
+biblatex
+\series default
+ with the natbib compatibility mode.
+ This is a specific variant for users who switch an existing document that
+ uses 
+\series bold
+natbib
+\series default
+ or want to emulate 
+\family sans
+the 
+\family default
+\series bold
+natbib
+\series default
+ behavior very closely.
+ Compared to normal 
+\family sans
+Biblatex
+\family default
+ this option has some additional styles.
+ All 
+\series bold
+biblatex
+\series default
+ styles are also supported by this variant.
+\end_layout
+
+\begin_layout Description
+Jurabib
+\begin_inset space ~
+\end_inset
+
+(BibTeX) loads the package 
+\series bold
+jurabib
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! jurabib
+\end_layout
+
+\end_inset
+
+ which provides author-year styles particularly suited for law studies.
+\end_layout
+
+\begin_layout Description
+Natbib
+\begin_inset space ~
+\end_inset
+
+(BibTeX) loads the package 
+\series bold
+natbib
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! natbib
+\end_layout
+
+\end_inset
+
+ which provides citation styles particularly suited for the humanities.
+\end_layout
+
+\begin_layout Standard
+The 
+\family sans
+Biblatex
+\family default
+ and 
+\family sans
+Natbib
+\family default
+ style formats provide the choice between author-year and author-numerical
+ citation styles.
+ You have to select one style in the dropdown box 
+\family sans
+Variant
 \family default
 .
- Setting a citation style for a reference will overwrite the default.
- For the global citation format use the Bib\SpecialChar TeX
- style files as explained in
- the previous section.
+ Note that for the 
+\family sans
+Biblatex
+\family default
+ formats, this only affects the appearance in the \SpecialChar LyX
+ workarea.
+ Whether the output uses numerical, author-year or another format such as
+ alpha-numerical depends only on the selected 
+\family sans
+Biblatex citation style
+\family default
+.
+ However, when switching between Author-year and Author-number, a suitable
+ style is proposed.
+ With 
+\family sans
+Natbib
+\family default
+, on the other hand, the dialog selection will ultimately determine the
+ style.
+\end_layout
+
+\begin_layout Standard
+For any author-year and author-numerical selection, multiple style variants
+ are available in the 
+\family sans
+Citation
+\family default
+ dialog.
+ Some selections also provide further options like the option to uppercase
+ a name prefix such as 
+\begin_inset Quotes eld
+\end_inset
+
+van Beethoven
+\begin_inset Quotes erd
+\end_inset
+
+ (to 
+\begin_inset Quotes eld
+\end_inset
+
+Van Beethoven
+\begin_inset Quotes erd
+\end_inset
+
+) or to expand or reduce the number of displayed others (i.
+\begin_inset space \thinspace{}
+\end_inset
+
+e.
+\begin_inset space \space{}
+\end_inset
+
+use or don't use 
+\begin_inset Quotes eld
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+).
 \end_layout
 
 \begin_layout Standard
-You can also set text to appear before or after a citation reference, in
- the citation reference window.
- Here is an example where the text 
+In the citation dialog you can also set text to appear after a citation
+ reference, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+page numbers, which will then be formatted according to the style's needs
+ (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+with or without 
+\begin_inset Quotes eld
+\end_inset
+
+pp.
+\begin_inset Quotes erd
+\end_inset
+
+).
+ The option 
+\family sans
+Literal
+\family default
+ in the citation dialog allows to input \SpecialChar TeX
+ code to the fields 
+\family sans
+Text
+\begin_inset space ~
+\end_inset
+
+before
+\family default
+ and 
+\family sans
+Text
+\begin_inset space ~
+\end_inset
+
+after
+\family default
+.
+ Here is a simple example where the text 
 \begin_inset Quotes eld
 \end_inset
 
@@ -28811,16 +30369,118 @@ Chapter
  appears after the reference:
 \end_layout
 
-\begin_layout Standard
+\begin_layout Quote
 Have a look at 
 \begin_inset CommandInset citation
 LatexCommand cite
 after "Chapter 3"
 key "latexcompanion"
+literal "false"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+All styles except for 
+\family sans
+Basic (BibTeX)
+\family default
+ also provide the feature to add text that precedes the reference (such
+ as 
+\begin_inset Quotes eld
+\end_inset
+
+cf.
+\begin_inset Quotes erd
+\end_inset
+
+).
+ This text is then also included in the parentheses, if the style requires
+ this.
+\end_layout
+
+\begin_layout Standard
+Note that these pre- and postnotes apply to the whole citation.
+ So if you refer to multiple references at once, the prenote will precede
+ the first citation in the list, the postnote will follow the last.
+ Some 
+\family sans
+Biblatex
+\family default
+ styles allow to add pre- and postnotes to any individual reference in a
+ multi-citation (so-called 
+\begin_inset Quotes eld
+\end_inset
+
+qualified citation lists
+\begin_inset Quotes erd
+\end_inset
+
+).
+ \SpecialChar LyX
+ supports this.
+ If you use such a style and if the current reference includes multiple
+ items the 
+\family sans
+Citation
+\family default
+ dialog will display three columns in the field 
+\family sans
+Selected Citations
+\family default
+: 
+\family sans
+Text
+\begin_inset space ~
+\end_inset
 
+before
+\family default
+, 
+\family sans
+Cite
+\begin_inset space ~
 \end_inset
 
+key
+\family default
+ and 
+\family sans
+Text
+\begin_inset space ~
+\end_inset
+
+after
+\family default
 .
+ If you double-click on an item's 
+\family sans
+Text
+\begin_inset space ~
+\end_inset
+
+before
+\family default
+ or 
+\family sans
+Text
+\begin_inset space ~
+\end_inset
+
+after
+\family default
+ field, you can add such individual pre- and postnotes.
+ In the 
+\family sans
+General text before
+\family default
+ and 
+\family sans
+General text after
+\family default
+ fields you can add pre- and postnotes that apply to the whole list.
 \end_layout
 
 \begin_layout Section
@@ -28905,6 +30565,7 @@ We give a short overview of the index commands in the next subsections.
 \begin_inset CommandInset citation
 LatexCommand cite
 key "latexcompanion,latexguide,latexbook"
+literal "true"
 
 \end_inset
 
@@ -29324,95 +30985,6 @@ The previous entry need not be a real existing entry.
  See the next subsection for an example.
 \end_layout
 
-\begin_layout Standard
-\begin_inset VSpace bigskip
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-In some cases the index entry order is not correct when you are using the
- program 
-\family sans
-makeindex 
-\family default
-to generate the index (see section
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Index-Program"
-
-\end_inset
-
-).
-\family sans
-makeindex
-\family default
- would for example print the index entry for the \SpecialChar LaTeX
--package aeguill in section
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Document-Font"
-
-\end_inset
-
- after the index entries of the other \SpecialChar LaTeX
--packages although all these index
- commands start with 
-\begin_inset Quotes eld
-\end_inset
-
-
-\series bold
-\SpecialChar LaTeX
--packages !
-\series default
-\begin_inset Quotes erd
-\end_inset
-
-.
- The reason is that the index entry for aeguill is in a footnote.
- To fix this 
-\family sans
-makeindex
-\family default
- bug, add these commands to the preamble of your document:
-\end_layout
-
-\begin_layout Standard
-
-\series bold
-
-\backslash
-let
-\backslash
-OrgIndex
-\backslash
-index
-\end_layout
-
-\begin_layout Standard
-
-\series bold
-
-\backslash
-renewcommand*{
-\backslash
-index}[1]{
-\backslash
-OrgIndex{#1}}
-\end_layout
-
 \begin_layout Subsection
 Index Entry Layout
 \begin_inset Index idx
@@ -29549,6 +31121,7 @@ xindy
 LatexCommand cite
 after "p. 678 ff."
 key "latexcompanion"
+literal "true"
 
 \end_inset
 
@@ -29627,6 +31200,7 @@ xindy
 \begin_inset CommandInset citation
 LatexCommand cite
 key "makeindex,xindy"
+literal "true"
 
 \end_inset
 
@@ -29706,6 +31280,7 @@ reference "subsec:LaTeX-settings"
 \begin_inset CommandInset citation
 LatexCommand cite
 key "makeindex-man,xindy"
+literal "true"
 
 \end_inset
 
@@ -29757,7 +31332,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! splitidx
+ packages ! splitidx
 \end_layout
 
 \end_inset
@@ -29774,6 +31349,7 @@ If yours does not ship it, consult the \SpecialChar TeX
 \begin_inset CommandInset citation
 LatexCommand cite
 key "TeXCatalogue"
+literal "true"
 
 \end_inset
 
@@ -29854,19 +31430,25 @@ If you want to change the attribution of a specific index entry, right-clicking
 \begin_layout Itemize
 By right-clicking on an index, you can change its type.
  Furthermore, you can specify an index to be a 
-\begin_inset Quotes eld
-\end_inset
-
-Subindex.
-\begin_inset Quotes erd
-\end_inset
-
+\family sans
+Subindex
+\family default
+.
  If you do that, the heading of that list will be decreased by one level.
  For example, if you use a book class, where the standard index heading
  is defined as a chapter, subindexes will be defined as sections and can
  thus be nested to the non-subindexes.
 \end_layout
 
+\begin_layout Itemize
+The option 
+\family sans
+Literal
+\family default
+ allows to use \SpecialChar TeX
+ code in the name of the index.
+\end_layout
+
 \begin_layout Section
 Nomenclature/Glossary 
 \begin_inset Index idx
@@ -29939,7 +31521,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! nomencl
+ packages ! nomencl
 \end_layout
 
 \end_inset
@@ -29950,6 +31532,7 @@ status collapsed
 \begin_inset CommandInset citation
 LatexCommand cite
 key "TeXCatalogue"
+literal "true"
 
 \end_inset
 
@@ -30017,8 +31600,12 @@ status open
 \series bold
 Note:
 \series default
- You have to enter valid \SpecialChar LaTeX
--code for all fields of the nomenclature dialog.
+ To use \SpecialChar TeX
+ code for nomenclature entries the option 
+\family sans
+Literal
+\family default
+ in the nomenclature dialog has to be used.
 \end_layout
 
 \end_inset
@@ -30046,7 +31633,7 @@ If you have symbols in formulas, you have to define them in the
 Symbol
 \family default
  field as \SpecialChar LaTeX
--formulas.
+ formulas.
  For example to get 
 \begin_inset Quotes eld
 \end_inset
@@ -30107,7 +31694,7 @@ Sigma
 
 \begin_layout Standard
 (A short introduction to the \SpecialChar LaTeX
--syntax is given in section
+ syntax is given in section
 \begin_inset space ~
 \end_inset
 
@@ -30272,12 +31859,14 @@ If the characters |
 \begin_inset space \space{}
 \end_inset
 
-should appear in nomenclature entries they need to be escaped by adding
- a quote character in front of them.
+should appear in nomenclature entries containing \SpecialChar TeX
+ code they need to be escaped
+ by adding a quote character in front of them.
 \begin_inset CommandInset nomenclature
 LatexCommand nomenclature
 symbol "\"@, \"|, \"!, \"\""
-description "The quote sign is output by writing ‘ \"\"\"\" '"
+description "The quote sign in TeX code is output by writing ' \"\" '."
+literal "true"
 
 \end_inset
 
 LatexCommand nomenclature
 symbol "a"
 description "dummy entry for the character \"a\""
+literal "false"
 
 \end_inset
 
@@ -30326,6 +31916,7 @@ LatexCommand nomenclature
 prefix "sigma"
 symbol "$\\sigma$"
 description "dummy entry for the character \\textsf{sigma}"
+literal "true"
 
 \end_inset
 
@@ -30415,6 +32006,7 @@ nomencl
 \begin_inset CommandInset citation
 LatexCommand cite
 key "nomencl"
+literal "true"
 
 \end_inset
 
@@ -30433,6 +32025,13 @@ Nomenclature ! Options
 \end_inset
 
 
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Nomenclature-Options"
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Standard
@@ -30591,9 +32190,9 @@ page
 \begin_inset Quotes erd
 \end_inset
 
- are automatically translated for some document languages.
- If not, add these lines to your \SpecialChar LaTeX
preamble:
+ are automatically translated for most document languages.
+ If not, add these lines in front of the nomenclature list as \SpecialChar TeX
code:
 \end_layout
 
 \begin_layout Standard
@@ -30602,9 +32201,32 @@ page
 \series bold
 
 \backslash
-renewcommand{
+renewcommand*{
+\backslash
+eqdeclaration}[1]{
+\begin_inset Newline newline
+\end_inset
+
+
+\size small
+
+\begin_inset Phantom HPhantom
+status open
+
+\begin_layout Plain Layout
+\begin_inset space ~
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\size default
+
 \backslash
-eqdeclaration}[1]{, see equation
+unskip, see equation
 \backslash
 nobreakspace(#1)}
 \begin_inset Newline newline
@@ -30612,33 +32234,118 @@ nobreakspace(#1)}
 
 
 \backslash
-renewcommand{
+renewcommand*{
 \backslash
-pagedeclaration}[1]{, page
+pagedeclaration}[1]{
+\begin_inset Newline newline
+\end_inset
+
+
+\size small
+
+\begin_inset Phantom HPhantom
+status open
+
+\begin_layout Plain Layout
+\begin_inset space ~
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\size default
+
+\backslash
+unskip, page
 \backslash
 nobreakspace{}#1}
-\series default
+\end_layout
+
+\begin_layout Standard
+If the numbers should be hyperlinks, assure that you use 
+\family sans
+Hyperref
+\begin_inset space ~
+\end_inset
+
+Support
+\family default
+ in the document settings under 
+\family sans
+PDF
+\begin_inset space ~
+\end_inset
+
+Properties
+\family default
+ and use instead:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
 
+\backslash
+renewcommand*{
+\backslash
+eqdeclaration}[1]{
 \begin_inset Newline newline
 \end_inset
 
-and replace 
-\begin_inset Quotes eld
+
+\begin_inset Phantom HPhantom
+status open
+
+\begin_layout Plain Layout
+\begin_inset space ~
 \end_inset
 
-see equation
-\begin_inset Quotes erd
+
+\end_layout
+
 \end_inset
 
- and 
-\begin_inset Quotes eld
+
+\backslash
+unskip, see 
+\backslash
+hyperlink{equation.#1}{equation
+\backslash
+nobreakspace{}(#1)}}
+\begin_inset Newline newline
 \end_inset
 
-page
-\begin_inset Quotes erd
+
+\backslash
+renewcommand*{
+\backslash
+pagedeclaration}[1]{
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Phantom HPhantom
+status open
+
+\begin_layout Plain Layout
+\begin_inset space ~
+\end_inset
+
+
+\end_layout
+
 \end_inset
 
- by their translation.
+
+\backslash
+unskip, 
+\backslash
+hyperlink{page.#1}{page
+\backslash
+nobreakspace{}#1}}
 \end_layout
 
 \begin_layout Subsection
@@ -30791,6 +32498,7 @@ reference "subsec:LaTeX-settings"
 \begin_inset CommandInset citation
 LatexCommand cite
 key "nomencl,makeindex"
+literal "true"
 
 \end_inset
 
@@ -30904,7 +32612,11 @@ inverted 0
 status open
 
 \begin_layout Standard
-Question: Who was the first physics Nobel prize winner?
+
+\series bold
+Question:
+\series default
+ Who was the first physics Nobel prize winner?
 \end_layout
 
 \end_inset
@@ -30918,7 +32630,11 @@ inverted 0
 status collapsed
 
 \begin_layout Standard
-Answer: Wilhelm Conrad Röntgen
+
+\series bold
+Answer:
+\series default
+ Wilhelm Conrad Röntgen
 \end_layout
 
 \end_inset
@@ -31021,69 +32737,56 @@ Exam-Question-Answer.pdf
 
  if both branches were active.
  This helps you to export different versions of your document easily.
-\change_inserted 424524441 1468296009
+\begin_inset VSpace bigskip
+\end_inset
+
 
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted 424524441 1468297080
-As of LyX 2.3.0, there are also 
-\begin_inset Quotes eld
-\end_inset
-
-inverted
-\begin_inset Quotes erd
-\end_inset
-
- branch insets, whose content is output just in case the branch is 
+There are also inverted branch insets, whose content is output just in case
+ the branch is 
 \emph on
 not
 \emph default
  activated.
-\begin_inset Branch Question
+ This make it easy to add alternative text for different versions of a document.
+ To control whether a particular inset is inverted, right-click on the inset
+ button and choose 
+\family sans
+Invert
+\begin_inset space ~
+\end_inset
+
+Inset
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Branch Answer
 inverted 1
 status open
 
 \begin_layout Standard
 
-\change_inserted 424524441 1468296217
-For example, this material will only appear when the Question branch is
- deactivated.
-\change_unchanged
-
-\end_layout
-
-\end_inset
-
- This make it easy to add alternative text for different versions of a document.
- To control whether a particular inset is 
+\series bold
+No answer:
+\series default
+ Because the 
 \begin_inset Quotes eld
 \end_inset
 
-inverted
+Answer
 \begin_inset Quotes erd
 \end_inset
 
-, right-click on the inset button and choose 
-\begin_inset Quotes eld
-\end_inset
-
-
-\change_unchanged
-Invert Inset
-\change_inserted 424524441 1468297080
+ branch is deactivated.
+\end_layout
 
-\begin_inset Quotes erd
 \end_inset
 
-.
-\change_deleted 424524441 1468296150
-
-\end_layout
 
-\begin_layout Standard
 \begin_inset VSpace bigskip
 \end_inset
 
@@ -31207,7 +32910,7 @@ status collapsed
 
 \begin_layout Standard
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -31343,7 +33046,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! hyperref
+ packages ! hyperref
 \end_layout
 
 \end_inset
@@ -31551,6 +33254,7 @@ hyperref
 \begin_inset CommandInset citation
 LatexCommand cite
 key "hyperref"
+literal "true"
 
 \end_inset
 
@@ -31651,8 +33355,17 @@ You can insert complete or incomplete commands as \SpecialChar TeX
  Code.
  Incomplete means that the command argument can be Standard \SpecialChar LyX
  text.
- For example, if you want to draw a frame around a word and are therefore
- using the \SpecialChar LaTeX
+ For example, if you want to draw a frame around a word
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+The LyX way would be to use a framed box.
+\end_layout
+
+\end_inset
+
+ and are therefore using the \SpecialChar LaTeX
 -command 
 \series bold
 
@@ -31680,7 +33393,7 @@ fbox{
 \begin_layout Standard
 \begin_inset Graphics
        filename clipart/ERT.png
-       scale 89
+       scale 95
 
 \end_inset
 
@@ -31811,6 +33524,7 @@ Now \SpecialChar LaTeX
 \begin_inset CommandInset citation
 LatexCommand cite
 key "Catalogue"
+literal "true"
 
 \end_inset
 
@@ -31828,7 +33542,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! caption
+ packages ! caption
 \end_layout
 
 \end_inset
@@ -31903,6 +33617,7 @@ caption
 \begin_inset CommandInset citation
 LatexCommand cite
 key "caption"
+literal "true"
 
 \end_inset
 
@@ -31969,6 +33684,7 @@ If you want to learn more about \SpecialChar LaTeX
 \begin_inset CommandInset citation
 LatexCommand cite
 key "latexcompanion,latexguide"
+literal "true"
 
 \end_inset
 
@@ -31976,7 +33692,7 @@ key "latexcompanion,latexguide"
 \end_layout
 
 \begin_layout Standard
-\begin_inset Newpage cleardoublepage
+\begin_inset Newpage clearpage
 \end_inset
 
 
@@ -32714,6 +34430,7 @@ The lines can also be colored, but this requires more knowledge of \SpecialChar
 \begin_inset CommandInset citation
 LatexCommand cite
 key "Mittelbach"
+literal "true"
 
 \end_inset
 
@@ -32813,7 +34530,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! fancyhdr
+ packages ! fancyhdr
 \end_layout
 
 \end_inset
@@ -32951,6 +34668,7 @@ fancyhdr
 \begin_inset CommandInset citation
 LatexCommand cite
 key "fancyhdr"
+literal "true"
 
 \end_inset
 
@@ -33044,7 +34762,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! preview-latex
+ packages ! preview-latex
 \end_layout
 
 \end_inset
@@ -33059,6 +34777,7 @@ preview
 \begin_inset CommandInset citation
 LatexCommand cite
 key "TeXCatalogue"
+literal "true"
 
 \end_inset
 
@@ -33942,7 +35661,8 @@ A good explanation of regular expressions is given in this Wikipedia entry:
  
 \begin_inset CommandInset href
 LatexCommand href
-target "http://en.wikipedia.org/wiki/Regular_expression"
+target "https://en.wikipedia.org/wiki/Regular_expression"
+literal "false"
 
 \end_inset
 
@@ -34204,7 +35924,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://sourceforge.net/projects/lyxwininstaller/files/hunspell/
+https://sourceforge.net/projects/lyxwininstaller/files/hunspell/
 \end_layout
 
 \end_inset
@@ -34285,10 +36005,6 @@ engine Select the library \SpecialChar LyX
  should use for spell checking.
  Depending on your platform, 
 \family typewriter
-aspell
-\family default
-, 
-\family typewriter
 hunspell
 \family default
  or 
@@ -34435,7 +36151,8 @@ status collapsed
 \begin_layout Plain Layout
 \begin_inset CommandInset href
 LatexCommand href
-target "http://lingucomponent.openoffice.org/thesaurus.html"
+target "https://lingucomponent.openoffice.org/thesaurus.html"
+literal "false"
 
 \end_inset
 
@@ -34587,15 +36304,16 @@ user
 If you want to install new\SpecialChar breakableslash
 further thesaurus dictionaries, you can downloaded
  them from here:
-\end_layout
+\begin_inset Newline newline
+\end_inset
+
 
-\begin_layout Itemize
 \begin_inset Flex URL
-status open
+status collapsed
 
 \begin_layout Plain Layout
 
-http://www.lyx.org/trac/browser/lyxsvn/dictionaries/trunk/thes/
+https://sourceforge.net/projects/lyxwininstaller/files/thesaurus/
 \end_layout
 
 \end_inset
@@ -35391,7 +37109,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! dvipost
+ packages ! dvipost
 \end_layout
 
 \end_inset
@@ -35402,6 +37120,7 @@ status collapsed
 \begin_inset CommandInset citation
 LatexCommand cite
 key "TeXCatalogue"
+literal "true"
 
 \end_inset
 
@@ -35530,7 +37249,8 @@ This section describes how to use \SpecialChar LyX
  to use them: 
 \begin_inset CommandInset citation
 LatexCommand cite
-key "Arabic,Armenian,Farsi,Hebrew,Latvian,Lithuanian,Mongolian,Vietnamese"
+key "Arabic,Armenian,Cyrillic,Farsi,Hebrew,Japanese"
+literal "true"
 
 \end_inset
 
@@ -36863,11 +38583,15 @@ reference "subsec:Numbering-depth"
 
 \begin_layout Subsection
 
+\change_deleted -712698321 1514652312
+
 \family sans
 Start New Environment/Start New Parent Environment
 \end_layout
 
 \begin_layout Standard
+
+\change_deleted -712698321 1514652312
 These menus are only visible if it is possible to have two consecutive environme
 nts of the same type.
  See section
@@ -36882,6 +38606,8 @@ reference "subsec:Separate-Nestings"
 \end_inset
 
  for an explanation.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -37014,7 +38740,8 @@ Toolbar
 \end_layout
 
 \begin_layout Standard
-In this menu entry you can set the appearance of the different toolbars.
+In this menu entry you can set the icon size and the appearance of the different
+ toolbars.
  All toolbars and the 
 \family sans
 Command
@@ -37452,7 +39179,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! tipa
+ packages ! tipa
 \end_layout
 
 \end_inset
@@ -37731,6 +39458,34 @@ reference "subsec:Ligatures"
 .
 \end_layout
 
+\begin_layout Description
+Optional
+\begin_inset space ~
+\end_inset
+
+Line
+\begin_inset space ~
+\end_inset
+
+Break Inserts a line break point (zero-width space character) that is invisible
+ in the output.
+ See section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Dashes-and-line-breaks"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+ for a usage example.
+\end_layout
+
 \begin_layout Description
 Ragged
 \begin_inset space ~
@@ -38398,6 +40153,37 @@ reference "sec:Marginal-Notes"
 \end_inset
 
 .
+\change_inserted -712698321 1514652349
+
+\end_layout
+
+\begin_layout Subsection
+
+\change_inserted -712698321 1514652384
+
+\family sans
+Separate <Name> Environment (Above/Below)
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1514652391
+These menu items are only visible if it is possible to have two consecutive
+ environments of the same type.
+ See section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Separate-Nestings"
+
+\end_inset
+
+ for an explanation.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Subsection
@@ -38482,21 +40268,6 @@ Inserts the actual date.
  The format depends on the date format of the language that is used for
  \SpecialChar LyX
 's menus.
- \SpecialChar LyX
- offers various ways to insert a date which are explained and also compared
- in the section 
-\emph on
-External Material
-\emph default
- of the 
-\emph on
-Embedded
-\begin_inset space ~
-\end_inset
-
-Objects
-\emph default
- manual.
 \end_layout
 
 \begin_layout Subsection
@@ -41817,7 +43588,8 @@ Driver support
  in 
 \begin_inset CommandInset href
 LatexCommand href
-target "http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/required/graphics/grfguide.pdf"
+literal "false"
 
 \end_inset
 
@@ -41871,7 +43643,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! prettyref
+ packages ! prettyref
 \end_layout
 
 \end_inset
@@ -41882,7 +43654,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! refstyle
+ packages ! refstyle
 \end_layout
 
 \end_inset
@@ -42257,7 +44029,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! babel
+ packages ! babel
 \end_layout
 
 \end_inset
@@ -42273,7 +44045,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! polyglossia
+ packages ! polyglossia
 \end_layout
 
 \end_inset
@@ -42359,7 +44131,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! inputenc
+ packages ! inputenc
 \end_layout
 
 \end_inset
@@ -42655,7 +44427,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! CJK
+ packages ! CJK
 \end_layout
 
 \end_inset
@@ -42708,7 +44480,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! japanese
+ packages ! japanese
 \end_layout
 
 \end_inset
@@ -42843,7 +44615,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! CJK
+ packages ! CJK
 \end_layout
 
 \end_inset
@@ -42907,7 +44679,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! ucs
+ packages ! ucs
 \end_layout
 
 \end_inset
@@ -42931,7 +44703,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! inputenc
+ packages ! inputenc
 \end_layout
 
 \end_inset
@@ -43358,9 +45130,24 @@ Bibliography
 \end_layout
 
 \begin_layout Standard
-Here you can specify if a citation style using the \SpecialChar LaTeX
+Here you can specify if a specific citation style using the \SpecialChar LaTeX
  packages 
 \series bold
+biblatex
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! biblatex
+\end_layout
+
+\end_inset
+
+, 
+\series bold
 natbib
 \series default
 
@@ -43369,7 +45156,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! natbib
+ packages ! natbib
 \end_layout
 
 \end_inset
@@ -43384,13 +45171,14 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! jurabib
+ packages ! jurabib
 \end_layout
 
 \end_inset
 
  should be used.
- You can enable a 
+ If you use Bib\SpecialChar TeX
+, you can enable a 
 \family sans
 Sectioned bibliography
 \family default
@@ -43405,17 +45193,23 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! bibtopic
+ packages ! bibtopic
 \end_layout
 
 \end_inset
 
- and you can select a 
+.
+ If you use 
+\noun on
+Biblatex
+\noun default
+, you can select the style files and specify further options.
+ Finally, you can select a document-specific 
 \family sans
 Processor
 \family default
  for the generation of the bibliography.
- For a further description see section
+ For a further description of these possibilities see section
 \begin_inset space ~
 \end_inset
 
@@ -43489,7 +45283,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! amsmath
+ packages ! amsmath
 \end_layout
 
 \end_inset
@@ -43504,7 +45298,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! amssymb
+ packages ! amssymb
 \end_layout
 
 \end_inset
@@ -43519,7 +45313,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! cancel
+ packages ! cancel
 \end_layout
 
 \end_inset
@@ -43534,7 +45328,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! esint
+ packages ! esint
 \end_layout
 
 \end_inset
@@ -43549,7 +45343,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! mathdots
+ packages ! mathdots
 \end_layout
 
 \end_inset
@@ -43564,7 +45358,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! mathtools
+ packages ! mathtools
 \end_layout
 
 \end_inset
@@ -43579,7 +45373,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! mhchem
+ packages ! mhchem
 \end_layout
 
 \end_inset
@@ -43594,7 +45388,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! stackrel
+ packages ! stackrel
 \end_layout
 
 \end_inset
@@ -43609,7 +45403,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! stmaryrd
+ packages ! stmaryrd
 \end_layout
 
 \end_inset
@@ -43624,7 +45418,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! undertilde
+ packages ! undertilde
 \end_layout
 
 \end_inset
@@ -44505,7 +46299,8 @@ Set
 \begin_inset CommandInset href
 LatexCommand href
 name "this image"
-target "http://wiki.lyx.org/uploads/LyX/NewInLyX20/themes.png"
+target "https://wiki.lyx.org/uploads/LyX/NewInLyX20/themes.png"
+literal "false"
 
 \end_inset
 
@@ -44761,12 +46556,8 @@ arg   "closetab"
 \family default
 ) at the right side of the tab bar to close tabs.
  Otherwise every document tab has its own close button.
-
-\change_inserted 274215730 1469338548
- Regardless of this option, one may always close a tab by middle-clicking
+ Regardless of this option, one can always close a tab by middle-clicking
  it in the tab bar.
-\change_unchanged
-
 \end_layout
 
 \begin_layout Standard
@@ -45336,7 +47127,7 @@ Key Bindings ! Editing
 \end_layout
 
 \begin_layout Standard
-To add new or modify existing keybindings to your own taste you can use
+To add new or modify existing key bindings to your own taste you can use
  the table in the dialog that lists all \SpecialChar LyX
  functions and the bound shortcuts.
  To find functions easily, they are grouped by categories and the dialog
@@ -45443,6 +47234,56 @@ key combination
 
 \end_layout
 
+\begin_layout Standard
+Note, though, that the key combination definition uses a specific syntax.
+ This applies to the designators of specific modifier keys (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., 
+\family typewriter
+M
+\family default
+, 
+\family typewriter
+S
+\family default
+, 
+\family typewriter
+C
+\family default
+ for 
+\family sans
+Meta/Alt
+\family default
+, 
+\family sans
+Shift
+\family default
+, 
+\family sans
+Ctrl
+\family default
+, respectively) as well as to the other keys.
+ Note particularly that you cannot use non-alphanumeric characters directly
+ in the definition of the key combination, but must use commands following
+ the Xlib standard instead (please refer to the existing bind files for
+ a model).
+ So if you wanted to bind a command to the key combination 
+\family sans
+Alt+Shift+:
+\family default
+, you needed to specify it as 
+\family typewriter
+M-S-colon
+\family default
+.
+ If you use the dialog to edit key bindings, you don't have to care for
+ these specifics.
+ \SpecialChar LyX
+ transforms your input to the correct syntax.
+\end_layout
+
 \begin_layout Subsection
 Keyboard/Mouse
 \begin_inset CommandInset label
@@ -46042,7 +47883,8 @@ language Here you can select the language for \SpecialChar LyX
  You can find its actual translation status here: 
 \begin_inset CommandInset href
 LatexCommand href
-target "http://www.lyx.org/I18n"
+target "https://www.lyx.org/I18n"
+literal "false"
 
 \end_inset
 
@@ -46084,7 +47926,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! babel
+ packages ! babel
 \end_layout
 
 \end_inset
@@ -46104,7 +47946,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! polyglossia
+ packages ! polyglossia
 \end_layout
 
 \end_inset
@@ -46153,6 +47995,7 @@ Arab\SpecialChar TeX
 \begin_inset CommandInset citation
 LatexCommand cite
 key "Arabic"
+literal "true"
 
 \end_inset
 
@@ -47120,10 +48963,10 @@ Units
 \begin_layout Plain Layout
 \align center
 \begin_inset Tabular
-<lyxtabular version="3" rows="20" columns="3">
+<lyxtabular version="3" rows="21" columns="3">
 <features tabularvalignment="middle">
 <column alignment="center" valignment="top">
-<column alignment="center" valignment="top">
+<column alignment="center" valignment="middle" width="50col%">
 <column alignment="center" valignment="top">
 <row>
 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
@@ -47160,7 +49003,7 @@ name/description
 \begin_inset Text
 
 \begin_layout Plain Layout
-mm
+bp
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-millimeter
+big point (72
+\begin_inset space \thinspace{}
+\end_inset
+
+bp = 1
+\begin_inset space \thinspace{}
+\end_inset
+
+in)
 \end_layout
 
 \end_inset
@@ -47189,7 +49040,7 @@ millimeter
 \begin_inset Text
 
 \begin_layout Plain Layout
-cm
+cc
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-centimeter
+cicero (1
+\begin_inset space \thinspace{}
+\end_inset
+
+cc = 12
+\begin_inset space \thinspace{}
+\end_inset
+
+dd)
 \end_layout
 
 \end_inset
@@ -47218,7 +49077,7 @@ centimeter
 \begin_inset Text
 
 \begin_layout Plain Layout
-in
+cm
 \end_layout
 
 \end_inset
@@ -47227,7 +49086,7 @@ in
 \begin_inset Text
 
 \begin_layout Plain Layout
-inch
+centimeter
 \end_layout
 
 \end_inset
@@ -47247,7 +49106,7 @@ inch
 \begin_inset Text
 
 \begin_layout Plain Layout
-pt
+dd
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-point (72.27
+didot (1
 \begin_inset space \thinspace{}
 \end_inset
 
-pt = 1
+dd 
+\begin_inset Formula $\approx$
+\end_inset
+
+ 0.376
 \begin_inset space \thinspace{}
 \end_inset
 
-in)
+mm)
 \end_layout
 
 \end_inset
@@ -47284,7 +49147,7 @@ in)
 \begin_inset Text
 
 \begin_layout Plain Layout
-pc
+em
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-pica (1
-\begin_inset space \thinspace{}
+width of letter 
+\emph on
+M
+\emph default
+ in current font
+\end_layout
+
 \end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+-
+\end_layout
 
-pc = 12
-\begin_inset space \thinspace{}
 \end_inset
+</cell>
+</row>
+<row>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
 
-pt)
+\begin_layout Plain Layout
+ex
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+height of letter 
+\emph on
+x
+\emph default
+ in current font
 \end_layout
 
 \end_inset
@@ -47321,7 +49213,7 @@ pt)
 \begin_inset Text
 
 \begin_layout Plain Layout
-sp
+in
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-scaled point (65536
+inch
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+-
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+mm
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+millimeter
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+-
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+mu
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+math unit (1
 \begin_inset space \thinspace{}
 \end_inset
 
-sp = 1
+mu = 1/18
 \begin_inset space \thinspace{}
 \end_inset
 
-pt)
+em)
 \end_layout
 
 \end_inset
@@ -47358,7 +49308,7 @@ pt)
 \begin_inset Text
 
 \begin_layout Plain Layout
-bp
+pt
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-big point (72
+point (72.27
 \begin_inset space \thinspace{}
 \end_inset
 
-bp = 1
+pt = 1
 \begin_inset space \thinspace{}
 \end_inset
 
@@ -47395,7 +49345,7 @@ in)
 \begin_inset Text
 
 \begin_layout Plain Layout
-dd
+pc
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-didot (1
+pica (1
 \begin_inset space \thinspace{}
 \end_inset
 
-dd 
-\begin_inset Formula $\approx$
-\end_inset
-
- 0.376
+pc = 12
 \begin_inset space \thinspace{}
 \end_inset
 
-mm)
+pt)
 \end_layout
 
 \end_inset
@@ -47436,7 +49382,7 @@ mm)
 \begin_inset Text
 
 \begin_layout Plain Layout
-cc
+sp
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-cicero (1
+scaled point (65536
 \begin_inset space \thinspace{}
 \end_inset
 
-cc = 12
+sp = 1
 \begin_inset space \thinspace{}
 \end_inset
 
-dd)
+pt)
 \end_layout
 
 \end_inset
@@ -47472,66 +49418,6 @@ dd)
 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 \begin_inset Text
 
-\begin_layout Plain Layout
-Scale Graphics %
-\end_layout
-
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-
-\begin_layout Plain Layout
-% of original image width
-\end_layout
-
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-
-\begin_layout Plain Layout
-
-\end_layout
-
-\end_inset
-</cell>
-</row>
-<row>
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-
-\begin_layout Plain Layout
-Text Width %
-\end_layout
-
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-
-\begin_layout Plain Layout
-% of text width
-\end_layout
-
-\end_inset
-</cell>
-<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
-\begin_inset Text
-
-\begin_layout Plain Layout
-
-\backslash
-textwidth
-\end_layout
-
-\end_inset
-</cell>
-</row>
-<row>
-<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
-\begin_inset Text
-
 \begin_layout Plain Layout
 Column Width %
 \end_layout
@@ -47564,7 +49450,7 @@ columnwidth
 \begin_inset Text
 
 \begin_layout Plain Layout
-Page Width %
+Line Distance %
 \end_layout
 
 \end_inset
@@ -47573,7 +49459,7 @@ Page Width %
 \begin_inset Text
 
 \begin_layout Plain Layout
-% of paper width
+% of height between baselines of two subsequent text lines
 \end_layout
 
 \end_inset
@@ -47584,7 +49470,7 @@ Page Width %
 \begin_layout Plain Layout
 
 \backslash
-paperwidth
+baselineskip
 \end_layout
 
 \end_inset
@@ -47626,7 +49512,7 @@ linewidth
 \begin_inset Text
 
 \begin_layout Plain Layout
-Text Height %
+Page Height %
 \end_layout
 
 \end_inset
@@ -47635,7 +49521,7 @@ Text Height %
 \begin_inset Text
 
 \begin_layout Plain Layout
-% of text height
+% of paper height
 \end_layout
 
 \end_inset
@@ -47646,7 +49532,7 @@ Text Height %
 \begin_layout Plain Layout
 
 \backslash
-textheight
+paperheight
 \end_layout
 
 \end_inset
@@ -47657,7 +49543,7 @@ textheight
 \begin_inset Text
 
 \begin_layout Plain Layout
-Page Height %
+Page Width %
 \end_layout
 
 \end_inset
@@ -47666,7 +49552,7 @@ Page Height %
 \begin_inset Text
 
 \begin_layout Plain Layout
-% of paper height
+% of paper width
 \end_layout
 
 \end_inset
@@ -47677,7 +49563,7 @@ Page Height %
 \begin_layout Plain Layout
 
 \backslash
-paperheight
+paperwidth
 \end_layout
 
 \end_inset
@@ -47688,7 +49574,7 @@ paperheight
 \begin_inset Text
 
 \begin_layout Plain Layout
-ex
+Scale Graphics %
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-height of letter 
-\emph on
-x
-\emph default
- in current font
+% of original image width
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
--
+
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-em
+Text Height %
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-width of letter 
-\emph on
-M
-\emph default
- in current font
+% of text height
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
--
+
+\backslash
+textheight
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-mu
+Text Width %
 \end_layout
 
 \end_inset
 \begin_inset Text
 
 \begin_layout Plain Layout
-math unit (1
-\begin_inset space \thinspace{}
-\end_inset
-
-mu = 1/18
-\begin_inset space \thinspace{}
-\end_inset
-
-em)
+% of text width
 \end_layout
 
 \end_inset
@@ -47780,7 +49652,9 @@ em)
 \begin_inset Text
 
 \begin_layout Plain Layout
--
+
+\backslash
+textwidth
 \end_layout
 
 \end_inset
@@ -47796,136 +49670,6 @@ em)
 \end_inset
 
 
-\end_layout
-
-\begin_layout Chapter
-Credits
-\begin_inset CommandInset label
-LatexCommand label
-name "chap:Credits"
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-The documentation is a collaborative effort between many different people
- (and we would encourage people to contribute!).
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Alejandro Aguilar Sierra
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Amir Karger
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-David Johnson
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Hartmut Haase
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Ignacio García
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Ivan Schreter
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-John Raithel
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-John Weiss
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Lars Gullik Bjønnes
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Matthias Ettrich
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Matthias Zenker
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Rich Fields
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Pascal André
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Paul Evans
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Paul Russel
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Robin Socha
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Uwe Stöhr
-\end_layout
-
-\begin_layout Itemize
-The \SpecialChar LyX
- Team: 
-\begin_inset CommandInset citation
-LatexCommand cite
-key "lyxcredit"
-
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -47944,6 +49688,7 @@ Bibliography
 LatexCommand bibitem
 label "Credits"
 key "lyxcredit"
+literal "true"
 
 \end_inset
 
@@ -47952,7 +49697,8 @@ The \SpecialChar LyX
 \begin_inset CommandInset href
 LatexCommand href
 name "Credits"
-target "http://www.lyx.org/Credits"
+target "https://www.lyx.org/Credits"
+literal "false"
 
 \end_inset
 
@@ -47966,7 +49712,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.lyx.org/Credits
+https://www.lyx.org/Credits
 \end_layout
 
 \end_inset
@@ -47978,6 +49724,7 @@ http://www.lyx.org/Credits
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "latexcompanion"
+literal "true"
 
 \end_inset
 
@@ -47994,6 +49741,7 @@ The \SpecialChar LaTeX
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "latexguide"
+literal "true"
 
 \end_inset
 
@@ -48011,6 +49759,7 @@ A Guide to \SpecialChar LaTeX
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "latexbook"
+literal "true"
 
 \end_inset
 
@@ -48027,6 +49776,7 @@ Leslie Lamport:
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "texbook"
+literal "true"
 
 \end_inset
 
@@ -48045,6 +49795,7 @@ book.
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "TeXCatalogue"
+literal "true"
 
 \end_inset
 
@@ -48059,7 +49810,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/help/Catalogue/bytopic.html
+http://texcatalogue.ctan.org/bytopic.html
 \end_layout
 
 \end_inset
@@ -48071,6 +49822,7 @@ http://mirrors.ctan.org/help/Catalogue/bytopic.html
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "LaTeXFAQ"
+literal "true"
 
 \end_inset
 
@@ -48097,6 +49849,7 @@ http://www.tex.ac.uk/faq/
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "BibTeX"
+literal "true"
 
 \end_inset
 
@@ -48104,7 +49857,8 @@ key "BibTeX"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/biblio/bibtex/contrib/doc/btxdoc.pdf"
+target "https://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/btxdoc.pdf"
+literal "false"
 
 \end_inset
 
@@ -48123,7 +49877,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/biblio/bibtex/contrib/doc/btxdoc.pdf
+https://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/btxdoc.pdf
 \end_layout
 
 \end_inset
@@ -48135,6 +49889,7 @@ http://mirrors.ctan.org/biblio/bibtex/contrib/doc/btxdoc.pdf
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "BibTeX-2"
+literal "true"
 
 \end_inset
 
@@ -48142,7 +49897,8 @@ key "BibTeX-2"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf"
+target "https://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf"
+literal "false"
 
 \end_inset
 
@@ -48161,7 +49917,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf
+https://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf
 \end_layout
 
 \end_inset
@@ -48172,7 +49928,8 @@ http://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "makeindex"
+key "Biblatex"
+literal "true"
 
 \end_inset
 
@@ -48180,14 +49937,27 @@ key "makeindex"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/indexing/makeindex/doc/makeindex.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/doc/biblatex.pdf"
+literal "false"
+
+\end_inset
+
+ of the \SpecialChar LaTeX
+ package 
+\series bold
+biblatex
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! biblatex
+\end_layout
 
 \end_inset
 
- of the program 
-\family sans
-makeindex
-\family default
 :
 \begin_inset Newline newline
 \end_inset
@@ -48198,7 +49968,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/indexing/makeindex/doc/makeindex.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/doc/biblatex.pdf
 \end_layout
 
 \end_inset
@@ -48209,22 +49979,36 @@ http://mirrors.ctan.org/indexing/makeindex/doc/makeindex.pdf
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "makeindex-man"
+key "biber"
+literal "true"
 
 \end_inset
 
 
 \begin_inset CommandInset href
 LatexCommand href
-name "Options"
-target "http://mirrors.ctan.org/indexing/makeindex/doc/manpages.dvi"
+name "Documentation"
+target "https://www.ctan.org/tex-archive/biblio/biber/documentation/biber.pdf"
+literal "false"
+
+\end_inset
+
+ of the \SpecialChar LaTeX
+ package 
+\series bold
+biber
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! biber
+\end_layout
 
 \end_inset
 
- for the program 
-\family sans
-makeindex
-\family default
 :
 \begin_inset Newline newline
 \end_inset
@@ -48235,7 +50019,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/indexing/makeindex/doc/manpages.dvi
+https://www.ctan.org/tex-archive/biblio/biber/documentation/biber.pdf
 \end_layout
 
 \end_inset
@@ -48246,7 +50030,8 @@ http://mirrors.ctan.org/indexing/makeindex/doc/manpages.dvi
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "xindy"
+key "makeindex"
+literal "true"
 
 \end_inset
 
@@ -48254,13 +50039,14 @@ key "xindy"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.xindy.org/documentation.html"
+target "https://www.ctan.org/tex-archive/indexing/makeindex/doc/makeindex.pdf"
+literal "false"
 
 \end_inset
 
  of the program 
 \family sans
-xindy
+makeindex
 \family default
 :
 \begin_inset Newline newline
@@ -48272,7 +50058,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.xindy.org/documentation.html
+https://www.ctan.org/tex-archive/indexing/makeindex/doc/makeindex.pdf
 \end_layout
 
 \end_inset
@@ -48283,20 +50069,25 @@ http://www.xindy.org/documentation.html
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "AMS"
+key "makeindex-man"
+literal "true"
 
 \end_inset
 
 
 \begin_inset CommandInset href
 LatexCommand href
-name "Documentation"
-target "http://www.ams.org/publications/authors/tex/amslatex"
+name "Options"
+target "https://www.ctan.org/tex-archive/indexing/makeindex/doc/manpages.dvi"
+literal "false"
 
 \end_inset
 
- of the AMS \SpecialChar LaTeX
--packages:
+ for the program 
+\family sans
+makeindex
+\family default
+:
 \begin_inset Newline newline
 \end_inset
 
@@ -48306,7 +50097,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ams.org/publications/authors/tex/amslatex
+https://www.ctan.org/tex-archive/indexing/makeindex/doc/manpages.dvi
 \end_layout
 
 \end_inset
@@ -48317,7 +50108,8 @@ http://www.ams.org/publications/authors/tex/amslatex
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "caption"
+key "xindy"
+literal "true"
 
 \end_inset
 
@@ -48325,26 +50117,15 @@ key "caption"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/caption/caption-eng.pdf"
-
-\end_inset
-
- of the \SpecialChar LaTeX
--package 
-\series bold
-caption
-\series default
-
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-\SpecialChar LaTeX
--packages ! caption
-\end_layout
+target "http://www.xindy.org/documentation.html"
+literal "false"
 
 \end_inset
 
+ of the program 
+\family sans
+xindy
+\family default
 :
 \begin_inset Newline newline
 \end_inset
@@ -48355,7 +50136,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/caption/caption-eng.pdf
+http://www.xindy.org/documentation.html
 \end_layout
 
 \end_inset
@@ -48366,7 +50147,8 @@ http://mirrors.ctan.org/macros/latex/contrib/caption/caption-eng.pdf
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "enumitem"
+key "AMS"
+literal "true"
 
 \end_inset
 
@@ -48374,27 +50156,13 @@ key "enumitem"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/enumitem/enumitem.pdf"
+target "https://www.ams.org/publications/authors/tex/amslatex"
+literal "false"
 
 \end_inset
 
- of the \SpecialChar LaTeX
--package 
-\series bold
-enumitem
-\series default
-
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-\SpecialChar LaTeX
--packages ! enumitem
-\end_layout
-
-\end_inset
-
-:
+ of the AMS \SpecialChar LaTeX
+-packages:
 \begin_inset Newline newline
 \end_inset
 
@@ -48404,7 +50172,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/enumitem/enumitem.pdf
+https://www.ams.org/publications/authors/tex/amslatex
 \end_layout
 
 \end_inset
@@ -48415,7 +50183,8 @@ http://mirrors.ctan.org/macros/latex/contrib/enumitem/enumitem.pdf
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "fancyhdr"
+key "caption"
+literal "true"
 
 \end_inset
 
@@ -48423,14 +50192,15 @@ key "fancyhdr"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/fancyhdr/fancyhdr.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/caption/caption-eng.pdf"
+literal "false"
 
 \end_inset
 
  of the \SpecialChar LaTeX
--package 
+ package 
 \series bold
-fancyhdr
+caption
 \series default
 
 \begin_inset Index idx
@@ -48438,7 +50208,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! fancyhdr
+ packages ! caption
 \end_layout
 
 \end_inset
@@ -48453,7 +50223,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/fancyhdr/fancyhdr.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/caption/caption-eng.pdf
 \end_layout
 
 \end_inset
@@ -48464,7 +50234,8 @@ http://mirrors.ctan.org/macros/latex/contrib/fancyhdr/fancyhdr.pdf
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "hyperref"
+key "enumitem"
+literal "true"
 
 \end_inset
 
@@ -48472,14 +50243,15 @@ key "hyperref"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/pkg/hyperref"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/enumitem/enumitem.pdf"
+literal "false"
 
 \end_inset
 
  of the \SpecialChar LaTeX
--package 
+ package 
 \series bold
-hyperref
+enumitem
 \series default
 
 \begin_inset Index idx
@@ -48487,7 +50259,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! hyperref
+ packages ! enumitem
 \end_layout
 
 \end_inset
@@ -48502,7 +50274,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ctan.org/pkg/hyperref
+https://www.ctan.org/tex-archive/macros/latex/contrib/enumitem/enumitem.pdf
 \end_layout
 
 \end_inset
@@ -48513,7 +50285,8 @@ http://www.ctan.org/pkg/hyperref
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "nomencl"
+key "fancyhdr"
+literal "true"
 
 \end_inset
 
@@ -48521,14 +50294,15 @@ key "nomencl"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/nomencl/nomencl.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/fancyhdr/fancyhdr.pdf"
+literal "false"
 
 \end_inset
 
  of the \SpecialChar LaTeX
--package 
+ package 
 \series bold
-nomencl
+fancyhdr
 \series default
 
 \begin_inset Index idx
@@ -48536,7 +50310,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! nomencl
+ packages ! fancyhdr
 \end_layout
 
 \end_inset
@@ -48551,7 +50325,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/nomencl/nomencl.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/fancyhdr/fancyhdr.pdf
 \end_layout
 
 \end_inset
@@ -48562,7 +50336,8 @@ http://mirrors.ctan.org/macros/latex/contrib/nomencl/nomencl.pdf
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "prettyref"
+key "hyperref"
+literal "true"
 
 \end_inset
 
@@ -48570,14 +50345,15 @@ key "prettyref"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/doc/manual.pdf"
+literal "false"
 
 \end_inset
 
  of the \SpecialChar LaTeX
--package 
+ package 
 \series bold
-prettyref
+hyperref
 \series default
 
 \begin_inset Index idx
@@ -48585,7 +50361,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! prettyref
+ packages ! hyperref
 \end_layout
 
 \end_inset
@@ -48600,7 +50376,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/doc/manual.pdf
 \end_layout
 
 \end_inset
@@ -48611,7 +50387,8 @@ http://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "refstyle"
+key "microtype"
+literal "true"
 
 \end_inset
 
@@ -48619,14 +50396,15 @@ key "refstyle"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/microtype/microtype.pdf"
+literal "false"
 
 \end_inset
 
  of the \SpecialChar LaTeX
--package 
+ package 
 \series bold
-refstyle
+microtpye
 \series default
 
 \begin_inset Index idx
@@ -48634,7 +50412,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \SpecialChar LaTeX
--packages ! refstyle
+ packages ! microtpye
 \end_layout
 
 \end_inset
@@ -48649,7 +50427,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/microtype/microtype.pdf
 \end_layout
 
 \end_inset
@@ -48660,54 +50438,37 @@ http://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "Arabic"
+key "nomencl"
+literal "true"
 
 \end_inset
 
 
 \begin_inset CommandInset href
 LatexCommand href
-name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Arabic"
-
-\end_inset
+name "Documentation"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/nomencl/nomencl.pdf"
+literal "false"
 
- how to set up \SpecialChar LyX
- for Arabic:
-\begin_inset Newline newline
 \end_inset
 
+ of the \SpecialChar LaTeX
+ package 
+\series bold
+nomencl
+\series default
 
-\begin_inset Flex URL
+\begin_inset Index idx
 status collapsed
 
 \begin_layout Plain Layout
-
-http://wiki.lyx.org/Windows/Arabic
+\SpecialChar LaTeX
+ packages ! nomencl
 \end_layout
 
 \end_inset
 
-
-\end_layout
-
-\begin_layout Bibliography
-\begin_inset CommandInset bibitem
-LatexCommand bibitem
-key "Armenian"
-
-\end_inset
-
-
-\begin_inset CommandInset href
-LatexCommand href
-name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Armenian"
-
-\end_inset
-
- how to set up \SpecialChar LyX
- for Armenian:
+:
 \begin_inset Newline newline
 \end_inset
 
@@ -48717,7 +50478,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Armenian
+https://www.ctan.org/tex-archive/macros/latex/contrib/nomencl/nomencl.pdf
 \end_layout
 
 \end_inset
@@ -48728,54 +50489,37 @@ http://wiki.lyx.org/Windows/Armenian
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "Cyrillic"
+key "prettyref"
+literal "true"
 
 \end_inset
 
 
 \begin_inset CommandInset href
 LatexCommand href
-name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Cyrillic"
-
-\end_inset
+name "Documentation"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf"
+literal "false"
 
- how to set up \SpecialChar LyX
- for Cyrillic languages:
-\begin_inset Newline newline
 \end_inset
 
+ of the \SpecialChar LaTeX
+ package 
+\series bold
+prettyref
+\series default
 
-\begin_inset Flex URL
+\begin_inset Index idx
 status collapsed
 
 \begin_layout Plain Layout
-
-http://wiki.lyx.org/Windows/Cyrillic
-\end_layout
-
-\end_inset
-
-
+\SpecialChar LaTeX
+ packages ! prettyref
 \end_layout
 
-\begin_layout Bibliography
-\begin_inset CommandInset bibitem
-LatexCommand bibitem
-key "Farsi"
-
 \end_inset
 
-
-\begin_inset CommandInset href
-LatexCommand href
-name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Farsi"
-
-\end_inset
-
- how to set up \SpecialChar LyX
- for Farsi:
+:
 \begin_inset Newline newline
 \end_inset
 
@@ -48785,7 +50529,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Farsi
+https://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf
 \end_layout
 
 \end_inset
@@ -48796,20 +50540,37 @@ http://wiki.lyx.org/Windows/Farsi
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "Hebrew"
+key "refstyle"
+literal "true"
 
 \end_inset
 
 
 \begin_inset CommandInset href
 LatexCommand href
-name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Hebrew"
+name "Documentation"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf"
+literal "false"
 
 \end_inset
 
- how to set up \SpecialChar LyX
- for Hebrew:
+ of the \SpecialChar LaTeX
+ package 
+\series bold
+refstyle
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+\SpecialChar LaTeX
+ packages ! refstyle
+\end_layout
+
+\end_inset
+
+:
 \begin_inset Newline newline
 \end_inset
 
@@ -48819,7 +50580,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Hebrew
+https://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf
 \end_layout
 
 \end_inset
@@ -48830,7 +50591,8 @@ http://wiki.lyx.org/Windows/Hebrew
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "Japanese"
+key "Arabic"
+literal "true"
 
 \end_inset
 
@@ -48838,12 +50600,13 @@ key "Japanese"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Japanese"
+target "https://wiki.lyx.org/Windows/Arabic"
+literal "false"
 
 \end_inset
 
  how to set up \SpecialChar LyX
- for Japanese:
+ for Arabic:
 \begin_inset Newline newline
 \end_inset
 
@@ -48853,7 +50616,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Japanese
+https://wiki.lyx.org/Windows/Arabic
 \end_layout
 
 \end_inset
@@ -48864,7 +50627,8 @@ http://wiki.lyx.org/Windows/Japanese
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "Latvian"
+key "Armenian"
+literal "true"
 
 \end_inset
 
@@ -48872,12 +50636,13 @@ key "Latvian"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Latvian"
+target "https://wiki.lyx.org/Windows/Armenian"
+literal "false"
 
 \end_inset
 
  how to set up \SpecialChar LyX
- for Latvian:
+ for Armenian:
 \begin_inset Newline newline
 \end_inset
 
@@ -48887,7 +50652,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Latvian
+https://wiki.lyx.org/Windows/Armenian
 \end_layout
 
 \end_inset
@@ -48898,7 +50663,8 @@ http://wiki.lyx.org/Windows/Latvian
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "Lithuanian"
+key "Cyrillic"
+literal "true"
 
 \end_inset
 
@@ -48906,12 +50672,13 @@ key "Lithuanian"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Lithuanian"
+target "https://wiki.lyx.org/Windows/Cyrillic"
+literal "false"
 
 \end_inset
 
  how to set up \SpecialChar LyX
- for Lithuanian:
+ for Cyrillic languages:
 \begin_inset Newline newline
 \end_inset
 
@@ -48921,7 +50688,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Lithuanian
+https://wiki.lyx.org/Windows/Cyrillic
 \end_layout
 
 \end_inset
@@ -48932,7 +50699,8 @@ http://wiki.lyx.org/Windows/Lithuanian
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "Mongolian"
+key "Farsi"
+literal "true"
 
 \end_inset
 
@@ -48940,12 +50708,13 @@ key "Mongolian"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Mongolian"
+target "https://wiki.lyx.org/Windows/Farsi"
+literal "false"
 
 \end_inset
 
  how to set up \SpecialChar LyX
- for Mongolian:
+ for Farsi:
 \begin_inset Newline newline
 \end_inset
 
@@ -48955,7 +50724,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Mongolian
+https://wiki.lyx.org/Windows/Farsi
 \end_layout
 
 \end_inset
@@ -48966,7 +50735,8 @@ http://wiki.lyx.org/Windows/Mongolian
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "Vietnamese"
+key "Hebrew"
+literal "true"
 
 \end_inset
 
@@ -48974,12 +50744,13 @@ key "Vietnamese"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Vietnamese"
+target "https://wiki.lyx.org/Windows/Hebrew"
+literal "false"
 
 \end_inset
 
  how to set up \SpecialChar LyX
- for Vietnamese:
+ for Hebrew:
 \begin_inset Newline newline
 \end_inset
 
@@ -48989,7 +50760,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Vietnamese
+https://wiki.lyx.org/Windows/Hebrew
 \end_layout
 
 \end_inset
@@ -49000,7 +50771,8 @@ http://wiki.lyx.org/Windows/Vietnamese
 \begin_layout Bibliography
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
-key "NewInLyX20"
+key "Japanese"
+literal "true"
 
 \end_inset
 
@@ -49008,16 +50780,13 @@ key "NewInLyX20"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/LyX/NewInLyX20"
+target "https://wiki.lyx.org/Windows/Japanese"
+literal "false"
 
 \end_inset
 
- about new features in 
-\family sans
-\SpecialChar LyX
- 2.0
-\family default
-:
+ how to set up \SpecialChar LyX
+ for Japanese:
 \begin_inset Newline newline
 \end_inset
 
@@ -49027,7 +50796,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/LyX/NewInLyX20
+https://wiki.lyx.org/Windows/Japanese
 \end_layout
 
 \end_inset
@@ -49106,6 +50875,56 @@ The above bibliography is created from a Bib\SpecialChar TeX
  database.
 \end_layout
 
+\begin_layout Standard
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+renewcommand*{
+\backslash
+pagedeclaration}[1]{
+\end_layout
+
+\begin_layout Plain Layout
+
+\backslash
+unskip, 
+\backslash
+hyperlink{page.#1}{page
+\backslash
+nobreakspace{}#1}}
+\end_layout
+
+\end_inset
+
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+This command makes the page number a clickable hyperlink, see sec.
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Nomenclature-Options"
+
+\end_inset
+
+ for more info.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
 \begin_layout Standard
 \begin_inset CommandInset nomencl_print
 LatexCommand printnomenclature
@@ -49117,6 +50936,8 @@ set_width "auto"
 \begin_inset CommandInset index_print
 LatexCommand printindex
 type "idx"
+name "Index"
+literal "false"
 
 \end_inset