]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
backport cs.po
[lyx.git] / lib / doc / UserGuide.lyx
index 310a0e2b395ad030493809c060b6105796d1bb13..188a16dc6ff6cb8cf71488cce15c7dba207c05f4 100644 (file)
@@ -69,7 +69,7 @@ enumitem
 \font_sf_scale 100 100
 \font_tt_scale 100 100
 \use_microtype false
-\use_dash_ligatures true
+\use_dash_ligatures false
 \graphics default
 \default_output_format pdf2
 \output_sync 0
@@ -140,12 +140,11 @@ enumitem
 \papercolumns 1
 \papersides 2
 \paperpagestyle default
-\tracking_changes true
+\tracking_changes false
 \output_changes false
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict true
-\author -712698321 "Jürgen Spitzmüller"
 \end_header
 
 \begin_body
@@ -187,7 +186,7 @@ literal "false"
 \begin_inset Newline newline
 \end_inset
 
-Version 2.2.x
+Version 2.3.x
 \begin_inset Note Note
 status collapsed
 
@@ -8337,14 +8336,12 @@ Verbatim
 \end_layout
 
 \begin_layout Verbatim
-
 This is Verbatim.
 \end_layout
 
 \begin_layout Verbatim
 \noindent
 \align block
-
 The following 2 lines are empty:
 \end_layout
 
@@ -8357,7 +8354,6 @@ The following 2 lines are empty:
 \end_layout
 
 \begin_layout Verbatim
-
 Almost everything is allowed in Verbatim:"%&$§#~'`
 \backslash
 }][{|
@@ -8381,7 +8377,6 @@ Verbatim
 \end_layout
 
 \begin_layout Verbatim*
-
 This is Verbatim*.
 \end_layout
 
@@ -12696,8 +12691,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
@@ -12849,8 +12844,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
 
@@ -12870,7 +12866,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
 
@@ -12886,25 +12894,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 ~
@@ -12981,159 +12986,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
@@ -16238,7 +16090,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
@@ -16250,7 +16102,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
 
@@ -16258,14 +16114,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
@@ -16294,7 +16169,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
@@ -16334,7 +16209,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
@@ -16356,7 +16231,49 @@ 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
+\family sans
+/ AltGr 
+\family default
+key).
+ Alternatively, dashes can be inserted with 
 \family sans
 Insert\SpecialChar menuseparator
 Special
@@ -16365,13 +16282,38 @@ 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).
+\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
@@ -16393,22 +16335,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
@@ -16455,63 +16397,43 @@ minus sign
 \end_inset
 
 
-\begin_inset VSpace defskip
-\end_inset
-
-
 \end_layout
 
-\begin_layout Standard
-You can alternatively generate the en and em dash by inserting the 
-\begin_inset Quotes eld
 \end_inset
 
 
-\family typewriter
--
-\family default
-
-\begin_inset Quotes erd
+\begin_inset VSpace defskip
 \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
+\end_layout
 
--
-\begin_inset Quotes erd
+\begin_layout Standard
+Dashes can also be inserted with 
+\family sans
+Insert\SpecialChar menuseparator
+Special
+\begin_inset space ~
 \end_inset
 
- gives a en dash, 
+Character\SpecialChar menuseparator
+Symbols
+\family default
+ or the 
 \begin_inset Quotes eld
 \end_inset
 
--
-\begin_inset space \thinspace{}
-\end_inset
-
--
-\begin_inset space \thinspace{}
-\end_inset
-
--
+unicode-insert
 \begin_inset Quotes erd
 \end_inset
 
- a em dash.
+ \SpecialChar LyX
+ function.
 \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
 
@@ -16528,7 +16450,11 @@ hyphen
 \end_layout
 
 \begin_layout Enumerate
-From A–Z
+From A–Z; pages
+\begin_inset space ~
+\end_inset
+
+369–378
 \begin_inset space \hfill{}
 \end_inset
 
@@ -16540,7 +16466,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
 
@@ -16566,6 +16492,408 @@ minus sign
 )
 \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:Dashes-and-line-breaks"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Whether line breaks around dashes are allowed depends on the use case and
+ locale:
+\end_layout
+
+\begin_layout Itemize
+No line breaks are allowed in ranges of values like A–Z or 1975–1982.
+\end_layout
+
+\begin_layout Itemize
+In English, dashes used to set off parenthetical statements should not start
+ a new line.
+\end_layout
+
+\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
+When using spaced en dashes
+\begin_inset space ~
+\end_inset
+
+- common in British English
+\begin_inset space ~
+\end_inset
+
+- line breaks before the dash can be prevented with protected spaces.
+\end_layout
+
+\begin_layout Standard
+When using em dashes without spaces—\SpecialChar allowbreak
+common in American English—\SpecialChar allowbreak
+one can insert
+ optional line breaks with the menu 
+\family sans
+Insert\SpecialChar menuseparator
+Formatting\SpecialChar menuseparator
+Optional line break
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+For documents containing many em dashes, you may consider to select the
+ option 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Fonts\SpecialChar menuseparator
+Output en- and em-dashes as ligatures.
+\family default
+This forces the output of dashes as 
+\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
+
+ when exporting to \SpecialChar LaTeX
+.
+ The \SpecialChar TeX
+ font ligature mechanism converts them to dash characters followed
+ by an optional line break.
+\end_layout
+
+\begin_layout Standard
+Caution:
+\end_layout
+
+\begin_layout Enumerate
+This results in optional line breaks after 
+\series bold
+all
+\series default
+ en and em dashes.
+ Incorrect line breaks must be prevented by wrapping in a makebox
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+See section 
+\emph on
+Prevent Hyphenation
+\emph default
+ of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+\end_layout
+
+\end_inset
+
+ or preceding with 
+\series bold
+
+\backslash
+nobreakdash
+\series 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
+369–378
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Itemize
+
+\lang french
+Les incises 
+\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
+
+\lang french
+–
+\begin_inset space ~
+\end_inset
+
+même
+\end_layout
+
+\end_inset
+
+ si tout le monde ne les aime pas
+\begin_inset space ~
+\end_inset
+
+– sont très utiles.
+\end_layout
+
+\begin_layout Itemize
+
+\lang spanish
+En una frase 
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+nobreakdash
+\end_layout
+
+\end_inset
+
+—un inciso con rayas— se escribe así.
+\end_layout
+
+\begin_layout Standard
+An incorrect line break is easily overlooked because
+\begin_inset space ~
+\end_inset
+
+– in contrast to an overfull line
+\begin_inset space ~
+\end_inset
+
+– it does not trigger a warning in the \SpecialChar LaTeX
+ log.
+\end_layout
+
+\end_deeper
+\begin_layout Enumerate
+The setting is ignored for documents using non-\SpecialChar TeX
+ fonts.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+Xe\SpecialChar TeX
+ provides the 
+\series bold
+
+\backslash
+XeTeXdashbreakstate
+\series default
+ setting.
+ The default causes dashes to behave like ligature dashes.
+ The usual behaviour of literal dashes can be achieved by inserting 
+\family typewriter
+\series bold
+
+\backslash
+XeTeXdashbreakstate=0
+\family default
+\series default
+ into the \SpecialChar LaTeX
+ preamble.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
+Em dashes in 
+\family typewriter
+typewriter
+\family default
+ fonts become 
+\family typewriter
+–-
+\family default
+ or 
+\family typewriter
+---
+\family default
+ in the output.
+\end_layout
+
+\begin_layout Enumerate
+Hyphenation is suppressed in words adjacent to hyphens and ligature dashes.
+\end_layout
+
+\begin_layout Standard
+Since \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.2, -- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation
+ to dashes.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+Up to \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.1, -- and --- was output unchanged which led to different look in \SpecialChar LyX
+, text
+ export, HTML export and the PDF export.
+\end_layout
+
+\end_inset
+
+ Occurrences in older documents are converted to literal Unicode dashes.
+ This led to different line breaks in some documents.
+ \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.3 provides the option 
+\family sans
+Output en- and em-dashes as ligatures
+\family default
+ in the menu 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Fonts.
+
+\family default
+ It is on by default but unselected when opening documents edited with \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.2.
+\begin_inset Newline newline
+\end_inset
+
+Note the following side-effects of the changes in \SpecialChar LyX
+'s dash handling:
+\end_layout
+
+\begin_layout Itemize
+If you used literal em- and en dashes in pre-\SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.2 documents, you must manually unselect 
+\family sans
+Output en- and em-dashes as ligatures
+\family default
+ to ensure unchanged behavior.
+\end_layout
+
+\begin_layout Itemize
+If you used both, literal and ligature dashes in pre-\SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.2 documents, you may need to enable or prevent individual line breaks as
+ shown above to restore the correct line breaking behaviour.
+\end_layout
+
+\begin_layout Itemize
+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
+
+\begin_inset space ~
+\end_inset
+
+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.
+\end_layout
+
 \begin_layout Subsection
 Hyphenation
 \begin_inset Index idx
@@ -16666,8 +16994,14 @@ A-b c
 
  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 
+ To prevent the shortcut from being hyphenated, 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
@@ -28849,31 +29183,25 @@ biblatex
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1484331301
-By default (with 
-\begin_inset Quotes eld
-\end_inset
-
-Default
-\begin_inset Quotes erd
-\end_inset
-
- bibliography processor set in 
+By default (with the 
+\family sans
+Processor
+\family default
+ set in 
 \family sans
 Document\SpecialChar menuseparator
 Settings\SpecialChar menuseparator
 Bibliography
 \family default
- and 
-\begin_inset Quotes eld
-\end_inset
-
+ and with 
+\family sans
 Automatic
-\begin_inset Quotes erd
-\end_inset
-
- bibliography processor in 
+\family default
+ as setting for the 
+\family sans
+Processor
+\family default
+ in 
 \family sans
 Tools\SpecialChar menuseparator
 Preferences\SpecialChar menuseparator
@@ -28881,22 +29209,14 @@ Output\SpecialChar menuseparator
 LaTeX
 \family default
 ), \SpecialChar LyX
- selects the most appropriate (available) processor for the current bibliogra
-phy approach (
-\change_unchanged
-
+ selects an appropriate (available) processor for the current bibliography
+ approach (
 \series bold
 biber
-\change_inserted -712698321 1484331301
-
 \series default
  for 
-\change_unchanged
-
 \series bold
 biblatex
-\change_inserted -712698321 1484331301
-
 \series default
 , 
 \family sans
@@ -28905,22 +29225,17 @@ bibtex
  for Bib\SpecialChar TeX
 -based bibliography styles).
  This should suit most needs.
-\change_unchanged
-
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1484331395
 In Japanese documents, a specific processor is used.
- By default, this is 
+ By default this is pBib\SpecialChar TeX
+ (in \SpecialChar LyX
 \family sans
 pbibtex
 \family default
-, a 
-\family sans
-bibtex
-\family default
+), a Bib\SpecialChar TeX
  variant specifically aimed at Japanese.
  You can adjust it in 
 \family sans
@@ -28930,8 +29245,6 @@ Output\SpecialChar menuseparator
 LaTeX
 \family default
 .
-\change_unchanged
-
 \end_layout
 
 \begin_layout Standard
@@ -29000,15 +29313,23 @@ name "subsec:Citation-Format"
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1483888028
 Many different citation formats are common, e.
 \begin_inset space \thinspace{}
 \end_inset
 
 g.
- numerical citation (as used in this document), alpha-numerical citations
- (as 
+\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
 
@@ -29031,49 +29352,50 @@ Miller (2008a)
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1483888432
-By default, a simple numeric citation style (as in this document) is used.
+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
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted -712698321 1483888079
 Document ! Settings
 \end_layout
 
 \end_inset
 
-
-\family sans
-\SpecialChar menuseparator
-Bibliography
-\family default
-, however, you have a range of other options, depending on your preferred
- bibliography approach.
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted -712698321 1483888408
-With the 
+ 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 
+ 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
-, which gives you author-year and author-numerical citations (see above
+\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"
@@ -29084,14 +29406,7 @@ reference "subsec:The-Bibliography-Environment"
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1483888505
-All other choices require a database approach, either Bib\SpecialChar TeX
- or 
-\noun on
-Biblatex
-\noun default
- (see 
+With a bibliography database (see 
 \begin_inset CommandInset ref
 LatexCommand ref
 reference "subsec:Bibliography-databases"
@@ -29101,8 +29416,12 @@ noprefix "false"
 
 \end_inset
 
-).
- Currently, the following options are available:
+) 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
@@ -29110,19 +29429,28 @@ Basic
 \begin_inset space ~
 \end_inset
 
-(BibTeX) 
-\change_inserted -712698321 1483888574
-the default 
-\family sans
-BibTeX-based approached without any additional packages (simple numeric
- citations)
+(BibTeX) the default Bib\SpecialChar TeX
+-based approached without any additional packages
+ (simple numeric citations).
 \end_layout
 
 \begin_layout Description
-Biblatex 
-\change_inserted -712698321 1483889266
-loads the Biblatex package and lets you select a style in the combo boxes
+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
@@ -29131,12 +29459,11 @@ Biblatex citation style
 Biblatex bibliography style
 \family default
  below.
- Many different style variants are supported.
- Options to the 
-\family sans
-Biblatex
-\family default
- package can be entered in the 
+ Options to the package 
+\series bold
+biblatex
+\series default
+ can be entered in the 
 \family sans
 Options
 \family default
@@ -29152,41 +29479,33 @@ Biblatex
 \begin_inset space ~
 \end_inset
 
-mode) 
-\change_inserted -712698321 1483889302
-loads the 
-\family sans
-Biblatex
-\family default
- package with 
-\begin_inset Quotes eld
-\end_inset
-
-natbib compatibility mode
-\begin_inset Quotes erd
-\end_inset
-
- enabled.
- This is a specific variant that is aimed at users who switch an existing
- document that used 
-\family sans
-Natbib
-\family default
- (see below) or want to emulate 
+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
-Natbib
+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.
- Style selection and option handling are identical.
+ this option has some additional styles.
  All 
-\noun on
-Biblatex
-\noun default
+\series bold
+biblatex
+\series default
  styles are also supported by this variant.
 \end_layout
 
@@ -29195,13 +29514,22 @@ Jurabib
 \begin_inset space ~
 \end_inset
 
-(BibTeX) 
-\change_inserted -712698321 1483889321
-loads the 
-\family sans
-Jurabib
-\family default
- package which provides author-year styles particularly suited for law studies.
+(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
@@ -29209,56 +29537,54 @@ Natbib
 \begin_inset space ~
 \end_inset
 
-(BibTeX) 
-\change_inserted -712698321 1483891582
-loads the 
-\family sans
-Natbib
-\family default
- package which provides citation styles particularly suited for the Humanities.
-\change_unchanged
+(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
 
-\begin_layout Standard
+\end_inset
+
+ which provides citation styles particularly suited for the humanities.
+\end_layout
 
-\change_inserted -712698321 1483891665
+\begin_layout Standard
 The 
 \family sans
 Biblatex
 \family default
variants and 
+ and 
 \family sans
 Natbib
 \family default
furthermore provide the choice between author-year and author-numerical
style formats provide the choice between author-year and author-numerical
  citation styles.
- You have to select either of it in the dialog.
- Note that in the 
+ You have to select one style in the dropdown box 
+\family sans
+Variant
+\family default
+.
+ Note that for the 
 \family sans
 Biblatex
 \family default
case, this only affects the appearance in the \SpecialChar LyX
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 style (however, when switching
- between 
-\begin_inset Quotes eld
-\end_inset
-
-author-year
-\begin_inset Quotes erd
-\end_inset
-
- and 
-\begin_inset Quotes eld
-\end_inset
-
-author-numerical
-\begin_inset Quotes erd
-\end_inset
-
-, a suitable style is proposed).
+ 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
@@ -29268,23 +29594,13 @@ Natbib
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1483890338
 For any author-year and author-numerical selection, multiple style variants
- are available 
-\change_deleted -712698321 1483890143
-I
-\change_inserted -712698321 1483890144
-i
-\change_unchanged
-n the citation reference dialog
-\change_deleted -712698321 1483890163
- you can set a special citation format
-\change_unchanged
-.
-
-\change_inserted -712698321 1483891709
- Some selections also provide further options, such as the option to uppercase
+ 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
@@ -29305,7 +29621,11 @@ Van Beethoven
 \begin_inset space \thinspace{}
 \end_inset
 
-e., use or don't use 
+e.
+\begin_inset space \space{}
+\end_inset
+
+use or don't use 
 \begin_inset Quotes eld
 \end_inset
 
@@ -29315,57 +29635,11 @@ et al.
 
 ).
  
-\change_deleted -712698321 1483890219
- For this feature you need to enable the option 
-\family sans
-Natbib
-\family default
- in 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 under 
-\family sans
-Bibliography
-\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.
-\change_unchanged
-
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1483890476
-In the citation dialog, 
-\change_deleted -712698321 1483890481
-Y
-\change_inserted -712698321 1483890482
-y
-\change_unchanged
-ou can also set text to appear 
-\change_deleted -712698321 1483890531
-before or 
-\change_unchanged
-after a citation reference, 
-\change_deleted -712698321 1483890545
-in the citation reference window
-\change_inserted -712698321 1483890583
-e.
+In the citation dialog you can also set text to appear after a citation
+ reference, e.
 \begin_inset space \thinspace{}
 \end_inset
 
@@ -29384,16 +29658,8 @@ pp.
 \begin_inset Quotes erd
 \end_inset
 
-)
-\change_unchanged
-.
- Here is a
-\change_deleted -712698321 1483890682
-n
-\change_inserted -712698321 1483890683
- simple
-\change_unchanged
- example where the text 
+).
+ Here is a simple example where the text 
 \begin_inset Quotes eld
 \end_inset
 
@@ -29419,18 +29685,15 @@ literal "true"
 \end_inset
 
 .
-\change_inserted -712698321 1483890690
-
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1501054733
 All styles except for 
 \family sans
 Basic (BibTeX)
 \family default
- also provide a means to add text that precedes the reference (such as 
+ also provide the feature to add text that precedes the reference (such
+ as 
 \begin_inset Quotes eld
 \end_inset
 
@@ -29444,18 +29707,15 @@ cf.
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted -712698321 1484998495
 Note that these pre- and postnotes apply to the whole citation.
- That is to say, if you refer to multiple references at one, the prenote
- will precede the first citation in the list, the postnote will follow the
- last.
+ 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 for adding pre- and postnotes to any individual reference
in a multi-citation (so-called 
+ styles allow to add pre- and postnotes to any individual reference in a
+ multi-citation (so-called 
 \begin_inset Quotes eld
 \end_inset
 
@@ -29466,76 +29726,66 @@ qualified citation lists
 ).
  \SpecialChar LyX
  supports this.
- If you use such a style, and if the current reference includes multiple
- items, the 
-\begin_inset Quotes eld
-\end_inset
-
+ 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
-\begin_inset Quotes erd
-\end_inset
-
- window will display three columns: 
-\begin_inset Quotes eld
-\end_inset
-
-Text before
-\begin_inset Quotes erd
+\family default
+: 
+\family sans
+Text
+\begin_inset space ~
 \end_inset
 
+before
+\family default
 , 
-\begin_inset Quotes eld
-\end_inset
-
-Cite key
-\begin_inset Quotes erd
-\end_inset
-
-, and 
-\begin_inset Quotes eld
+\family sans
+Cite
+\begin_inset space ~
 \end_inset
 
-Text after
-\begin_inset Quotes erd
+key
+\family default
+ and 
+\family sans
+Text
+\begin_inset space ~
 \end_inset
 
+after
+\family default
 .
  If you double-click on an item's 
-\begin_inset Quotes eld
-\end_inset
-
-Text before
-\begin_inset Quotes erd
+\family sans
+Text
+\begin_inset space ~
 \end_inset
 
+before
+\family default
  or 
-\begin_inset Quotes eld
-\end_inset
-
-Text after
-\begin_inset Quotes erd
+\family sans
+Text
+\begin_inset space ~
 \end_inset
 
+after
+\family default
  field, you can add such individual pre- and postnotes.
  In the 
-\begin_inset Quotes eld
-\end_inset
-
+\family sans
 General text before
-\begin_inset Quotes erd
-\end_inset
-
+\family default
  and 
-\begin_inset Quotes eld
-\end_inset
-
+\family sans
 General text after
-\begin_inset Quotes erd
-\end_inset
-
- input widgets, you can add pre- and postnotes that apply to the whole list.
-\change_unchanged
-
+\family default
+ fields you can add pre- and postnotes that apply to the whole list.
 \end_layout
 
 \begin_layout Section
@@ -38472,6 +38722,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 ~
@@ -46082,7 +46360,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
@@ -46189,6 +46467,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