]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
UserGuide.lyx: fix 2 Typos (thanks Ignacio)
[lyx.git] / lib / doc / UserGuide.lyx
index 363acf5917c97ec4d73a9242d4b3b12f8899be93..f780d3aa7c579d79a6f7872e60b820655055d170 100644 (file)
 % change header rule width
 \renewcommand{\headrulewidth}{2pt}
 
+% used to have extra space in table cells
+\@ifundefined{extrarowheight}
+ {\usepackage{array}}{}
+\setlength{\extrarowheight}{2pt}
+
 % workaround for a makeindex bug,
 % see sec. "Index Entry Order"
 % only uncomment this when you are using makindex
@@ -2047,7 +2052,9 @@ indicator
 \family default
 .
  With the general options you can define the delay time for the inline and
- popup completion and choose if long completions should be abbreviated.
+ popup completion, you can set the minimal number of characters a word must
+ have that it will be taken into account for a completion and you can choose
+ if long completions should be abbreviated.
 \end_layout
 
 \begin_layout Standard
@@ -3734,8 +3741,6 @@ Document ! Layout
 \end_inset
 
 
-\family sans
-
 \begin_inset Index idx
 status collapsed
 
@@ -3930,8 +3935,6 @@ Document\SpecialChar \menuseparator
 Settings
 \family default
  dialog:
-\family sans
-
 \begin_inset Index idx
 status collapsed
 
@@ -5181,7 +5184,7 @@ You can use labels and cross-references to refer to their numbers.
 \end_layout
 
 \begin_layout Subsection
-Quotes and Poetry line spacing
+Quotes and Poetry
 \end_layout
 
 \begin_layout Standard
@@ -5239,15 +5242,7 @@ Standard
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
-Quote
-\family default
- and 
-\family sans
-Quotation
-\family default
-
+Quote and Quotation
 \begin_inset CommandInset label
 LatexCommand label
 name "sec:Quote"
@@ -5371,11 +5366,7 @@ Quotation
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
 Verse
-\family default
-
 \begin_inset Index idx
 status collapsed
 
@@ -5386,8 +5377,6 @@ Paragraph ! Verse
 \end_inset
 
 
-\family sans
-
 \begin_inset Index idx
 status collapsed
 
@@ -5459,11 +5448,7 @@ Verse
 \family default
  does not indent both margins.
  Each stanza of the verse or poem is in its own paragraph.
- To separate the individual lines of a stanza, use the 
-\family typewriter
-break-line
-\family default
- function 
+ To separate the individual lines of a stanza, use the shortcut 
 \begin_inset Info
 type  "shortcut"
 arg   "newline-insert newline"
@@ -5544,7 +5529,7 @@ Standard
  depth, you can use 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 .
@@ -5575,11 +5560,7 @@ reference "sec:Nesting"
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
 Itemize
-\family default
-
 \begin_inset Index idx
 status collapsed
 
@@ -5771,11 +5752,7 @@ reference "sec:Nesting"
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
 Enumerate
-\family default
-
 \begin_inset Index idx
 status collapsed
 
@@ -5958,11 +5935,7 @@ reference "sec:Nesting"
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
 Description
-\family default
-
 \begin_inset Index idx
 status collapsed
 
@@ -6029,7 +6002,7 @@ Protected Space
  (Use either 
 \begin_inset Info
 type  "shortcut"
-arg   "command-alternatives space-insert protected ; math-space"
+arg   "command-alternatives math-space ; space-insert protected"
 \end_inset
 
  or the menu 
@@ -7220,19 +7193,11 @@ Letters
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
-Address
-\family default
- and 
-\family sans
-Right
+Address and Right
 \begin_inset space ~
 \end_inset
 
-Address
-\family default
-: An Overview
+Address: An Overview
 \end_layout
 
 \begin_layout Standard
@@ -7403,7 +7368,7 @@ Return
 \family default
  is the 
 \family typewriter
-break-paragraph
+paragraph-break
 \family default
  function, and the individual lines of an address are not paragraphs.
  Thus, you have to use 
@@ -7456,8 +7421,6 @@ Most academic writing begins with an abstract and ends with a bibliography
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
 Abstract
 \begin_inset Index idx
 status collapsed
@@ -7626,11 +7589,7 @@ abstract
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
 Bibliography
-\family default
-
 \begin_inset Index idx
 status collapsed
 
@@ -7728,6 +7687,15 @@ reference "sec:Bibliography"
 \end_layout
 
 \begin_layout Subsection
+Special Environments
+\end_layout
+
+\begin_layout Standard
+LyX provides two environments that can be used to emulate the behavior of
+ a computer console/terminal and a typewriter.
+\end_layout
+
+\begin_layout Subsubsection
 LyX
 \family sans
 -Code
@@ -7735,7 +7703,7 @@ LyX
 status collapsed
 
 \begin_layout Plain Layout
-Paragraph ! LyX code
+LyX-Code
 \end_layout
 
 \end_inset
@@ -7755,13 +7723,13 @@ The
 \family sans
 LyX-Code
 \family default
- environment is another LyX extension.
+ environment is a LyX extension.
  It type-sets text in a typewriter-style font.
  It also treats the 
 \family sans
 Space
 \family default
- key as a fixed whitespace;
+ key as a fixed whitespace.
 \begin_inset Foot
 status collapsed
 
@@ -7787,7 +7755,16 @@ Blank
 
 \end_inset
 
- this is the only case in which you can type multiple whitespaces in LyX.
+\family sans
+LyX-Code
+\family default
+ and 
+\family sans
+Verbatim
+\family default
+ are the only environments in which you can type multiple whitespaces in
+ LyX.
  If you need to insert blank lines, you will still need to use 
 \begin_inset Info
 type  "shortcut"
@@ -7854,7 +7831,7 @@ arg   "newline-insert newline"
 \end_layout
 
 \begin_layout Itemize
-You can't follow a 
+You cannot follow a 
 \begin_inset Info
 type  "shortcut"
 arg   "newline-insert newline"
@@ -7864,35 +7841,17 @@ arg   "newline-insert newline"
 \family sans
 Space
 \family default
-.
-\end_layout
-
-\begin_deeper
-\begin_layout Itemize
-Use a 
-\family sans
-Return
-\family default
- to begin a new paragraph, then you can use a 
-\family sans
-Space
-\family default
-.
-\end_layout
-
-\begin_layout Itemize
-Or: use 
+ but with a 
 \begin_inset Info
 type  "shortcut"
-arg   "command-alternatives space-insert protected ; math-space"
+arg   "command-alternatives math-space ; space-insert protected"
 \end_inset
 
- instead.
+.
 \end_layout
 
-\end_deeper
 \begin_layout Itemize
-You can't have an empty paragraph or an empty line.
+You cannot have an empty paragraph or an empty line.
  You must put at least one 
 \family sans
 Space
@@ -7972,8 +7931,8 @@ Hello world!
 \family sans
 LyX-Code
 \family default
- has one purpose: to typeset code, such as program source, shell scripts,
rc-files, and so on.
+ has one purpose: to typeset code, such as program source, shell scripts
+ and so on.
  Use it only in those very special cases where you need to generate text
  as if you used a typewriter.
 \begin_inset Index idx
@@ -8001,6 +7960,106 @@ Objects
  manual.
 \end_layout
 
+\begin_layout Subsubsection
+Verbatim
+\family sans
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Verbatim
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The 
+\family sans
+Verbatim
+\family default
+ environment is similar to the 
+\family sans
+LyX-Code
+\family default
+ environment with the difference that its content will be treated like a
+ computer console text.
+\family sans
+Verbatim
+\family default
+ does therefore not have paragraphs so that 
+\family sans
+Return
+\family default
+ breaks lines.
+ Compared to 
+\family sans
+LyX-Code
+\family default
+ the 
+\family sans
+Space
+\family default
+ key is treated like a normal space in text (not as a protected space) and
+ you can have empty lines.
+ In contrary to 
+\family sans
+LyX-Code,
+\family default
+\family sans
+Verbatim
+\family default
+ cannot
+\end_layout
+
+\begin_layout Itemize
+have a certain language and a text style
+\end_layout
+
+\begin_layout Itemize
+contain hyperlinks, boxes, foot- and margin notes, notes, math, citations,
+ index- and nomenclature entries, labels, tables, graphics, listings, floats
+ and TeX-Code
+\end_layout
+
+\begin_layout Standard
+Because of these properties 
+\family sans
+Verbatim
+\family default
+ works like a typewriter.
+ Here is an example:
+\end_layout
+
+\begin_layout Verbatim
+This is verbatim.
+\end_layout
+
+\begin_layout Verbatim
+\noindent
+\align block
+The following 2 lines are empty:
+\end_layout
+
+\begin_layout Verbatim
+
+\end_layout
+
+\begin_layout Verbatim
+
+\end_layout
+
+\begin_layout Verbatim
+Almost everything is allowed in verbatim:"%&$ยง#~'`
+\backslash
+}][{|
+\end_layout
+
 \begin_layout Section
 Nesting Environments
 \begin_inset Index idx
@@ -8277,6 +8336,12 @@ List
 LyX-Code
 \end_layout
 
+\begin_layout Itemize
+
+\family sans
+Verbatim
+\end_layout
+
 \end_deeper
 \begin_layout Description
 Nestable-Inside You can nest them inside other things.
@@ -9041,7 +9106,7 @@ List
  We created it by using 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  followed by 
@@ -9072,7 +9137,7 @@ arg   "depth-increment"
  by entering 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  followed by 
@@ -9103,7 +9168,7 @@ Standard
  We did this by entering 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 , then 
@@ -9141,7 +9206,7 @@ Standard
  paragraph, also at level #4, made with just a 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 .
@@ -9153,7 +9218,7 @@ arg   "break-paragraph inverse"
  We enter 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  and changed the paragraph environment back to 
@@ -9203,7 +9268,7 @@ and this is level #6.
  Just enter 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  followed by a 
@@ -9221,7 +9286,7 @@ arg   "depth-decrement"
 #4-b After another 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  followed by a 
@@ -9396,7 +9461,7 @@ This is level #2.
  We used 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  followed by 
@@ -9430,7 +9495,7 @@ Itemize
  (We got here by using 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 , then 
@@ -9451,7 +9516,7 @@ Itemize
 Here's level #4, produced using 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 , then 
@@ -9514,7 +9579,7 @@ don't
 Oh, as if you couldn't guess by now, we're just using 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  to keep the current environment and depth but create a new item.
@@ -9530,7 +9595,7 @@ arg   "depth-decrement"
  to decrease the depth after the next 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 .
@@ -9571,7 +9636,7 @@ did
 Another 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  
@@ -9594,7 +9659,7 @@ Enumerate
 The same thing happens if we do another 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  
@@ -9725,7 +9790,7 @@ Bippitey boppitey boo!
 (
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 
@@ -9840,7 +9905,7 @@ blue-fish
 (
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 
@@ -9856,12 +9921,16 @@ arg   "depth-increment"
  3 times, 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
 
 \family sans
-, Verse, 
+, Verse,
+\begin_inset Newline newline
+\end_inset
+
+
 \family default
 
 \begin_inset Info
@@ -9932,7 +10001,7 @@ Quotation
  We will use 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph inverse"
+arg   "paragraph-break inverse"
 \end_inset
 
  to preserve the depth.
@@ -10042,6 +10111,105 @@ Itemize
  You have a huge variety of options at your disposal.
 \end_layout
 
+\begin_layout Subsection
+Separate Nestings
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Nesting ! Separation
+\end_layout
+
+\end_inset
+
+
+\begin_inset CommandInset label
+LatexCommand label
+name "sub:Separate-Nestings"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+It is sometimes necessary to have two consecutive environments of the same
+ type.
+ For example you need two different enumerations:
+\end_layout
+
+\begin_layout Enumerate
+Hello
+\end_layout
+
+\begin_deeper
+\begin_layout Enumerate
+this is an
+\end_layout
+
+\begin_deeper
+\begin_layout Enumerate
+enumeration
+\end_layout
+
+\begin_layout --Separator--
+
+\end_layout
+
+\begin_layout Itemize
+itemize list
+\end_layout
+
+\end_deeper
+\end_deeper
+\begin_layout --Separator--
+
+\end_layout
+
+\begin_layout Enumerate
+Hi
+\end_layout
+
+\begin_layout Enumerate
+this is another
+\end_layout
+
+\begin_layout Enumerate
+enumeration
+\end_layout
+
+\begin_layout Standard
+To tell LyX that there are two lists and not one, set the cursor at the
+ end of the last item and use the menu 
+\family sans
+Edit\SpecialChar \menuseparator
+Start New Parent Environment
+\family default
+.
+ This adds an environment separator and a new list behind it.
+ If you use instead the menu 
+\family sans
+Edit\SpecialChar \menuseparator
+Start New Environment
+\family default
+ a new list will also be created, but in the same nesting level.
+\end_layout
+
+\begin_layout Standard
+To split an existing list into two lists, set the cursor at the end of a
+ list item, press 
+\begin_inset Info
+type  "shortcut"
+arg   "paragraph-break"
+\end_inset
+
+ and select 
+\family sans
+--Separator--
+\family default
+ in the pull-down box for environments in LyX's main toolbar.
+\end_layout
+
 \begin_layout Section
 Spacing, pagination and line breaks
 \begin_inset Index idx
@@ -10146,7 +10314,7 @@ Space
  (shortcut 
 \begin_inset Info
 type  "shortcut"
-arg   "command-alternatives space-insert protected ; math-space"
+arg   "command-alternatives math-space ; space-insert protected"
 \end_inset
 
 ).
@@ -10375,6 +10543,54 @@ space A line with a
  negative thin space between the arrows.
 \end_layout
 
+\begin_layout Description
+Negative
+\begin_inset space ~
+\end_inset
+
+medium
+\begin_inset space ~
+\end_inset
+
+space A line with a 
+\begin_inset Formula $\to$
+\end_inset
+
+
+\begin_inset space \negmedspace{}
+\end_inset
+
+
+\begin_inset Formula $\gets$
+\end_inset
+
+ negative medium space between the arrows.
+\end_layout
+
+\begin_layout Description
+Negative
+\begin_inset space ~
+\end_inset
+
+thick
+\begin_inset space ~
+\end_inset
+
+space A line with a 
+\begin_inset Formula $\to$
+\end_inset
+
+
+\begin_inset space \negthickspace{}
+\end_inset
+
+
+\begin_inset Formula $\gets$
+\end_inset
+
+ negative thick space between the arrows.
+\end_layout
+
 \begin_layout Description
 Enspace
 \begin_inset space ~
@@ -10476,7 +10692,7 @@ Custom
 \begin_inset space ~
 \end_inset
 
-space A line with
+space A line with 
 \begin_inset Formula $\to$
 \end_inset
 
@@ -10518,8 +10734,7 @@ sideways false
 status open
 
 \begin_layout Plain Layout
-\align center
-\begin_inset Caption
+\begin_inset Caption Standard
 
 \begin_layout Plain Layout
 \begin_inset CommandInset label
@@ -10539,7 +10754,7 @@ Width of the different horizontal spaces.
 \begin_layout Plain Layout
 \align center
 \begin_inset Tabular
-<lyxtabular version="3" rows="8" columns="2">
+<lyxtabular version="3" rows="10" columns="2">
 <features rotate="0" tabularvalignment="middle">
 <column alignment="center" valignment="top">
 <column alignment="center" valignment="top">
@@ -10640,7 +10855,7 @@ em
 </cell>
 </row>
 <row>
-<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -10649,7 +10864,7 @@ Negative thin
 
 \end_inset
 </cell>
-<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -10658,13 +10873,69 @@ Negative thin
 \end_inset
 
 em
+\begin_inset Formula $\thinspace=\thinspace$
+\end_inset
+
+-3
+\begin_inset space \thinspace{}
+\end_inset
+
+mu
 \end_layout
 
 \end_inset
 </cell>
 </row>
 <row>
-<cell alignment="center" valignment="top" bottomline="true" leftline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+Negative medium
+\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
+-4
+\begin_inset space \thinspace{}
+\end_inset
+
+mu
+\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
+Negative thick
+\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
+-5
+\begin_inset space \thinspace{}
+\end_inset
+
+mu
+\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
@@ -10677,7 +10948,7 @@ em)
 
 \end_inset
 </cell>
-<cell alignment="center" valignment="top" bottomline="true" leftline="true" rightline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -10692,7 +10963,7 @@ em
 </cell>
 </row>
 <row>
-<cell alignment="center" valignment="top" bottomline="true" leftline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -10705,7 +10976,7 @@ em)
 
 \end_inset
 </cell>
-<cell alignment="center" valignment="top" bottomline="true" leftline="true" rightline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -10720,7 +10991,7 @@ em
 </cell>
 </row>
 <row>
-<cell alignment="center" valignment="top" bottomline="true" leftline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
@@ -10733,7 +11004,7 @@ em)
 
 \end_inset
 </cell>
-<cell alignment="center" valignment="top" bottomline="true" leftline="true" rightline="true" usebox="none">
+<cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
 \begin_inset Text
 
 \begin_layout Plain Layout
 \end_layout
 
 \begin_layout Subsubsection
-
-\family sans
 Horizontal Fills
-\family default
-
 \begin_inset Index idx
 status collapsed
 
@@ -12005,7 +12272,7 @@ Traditionally, LaTeX used its own fonts.
  Also, the range of fonts supported by traditional LaTeX has increased a
  lot in the meantime; so you can find packages for many free and commercial
  fonts.
In LyX, only a subset of these are directly selectable via the user interface
LyX supports the fonts that are under a free license via the user interface
  (see section
 \begin_inset space ~
 \end_inset
@@ -12018,9 +12285,8 @@ reference "sub:Document-Font"
 \end_inset
 
  for details).
- However, all the others are available if you enter the relevant LaTeX code
- in the document preamble (please refer to the documentation of your desired
- font).
+ Other fonts are available if you enter the relevant LaTeX code in the document
+ preamble (please refer to the documentation of your desired font).
 \end_layout
 
 \begin_layout Standard
@@ -12135,8 +12401,11 @@ serif
 typewriter
 \family default
  (monospaced) โ€” and you can specify the base font size and scaling factors
- for (some) sans serif and typewriter fonts if this is necessary to fit
- with the roman font.
+ for (some) sans
+\begin_inset space ~
+\end_inset
+
+serif and typewriter fonts if this is necessary to fit with the roman font.
 \end_layout
 
 \begin_layout Standard
@@ -12300,7 +12569,7 @@ ec
 status collapsed
 
 \begin_layout Plain Layout
-This problem doesn't appear if you read PDFs in 
+This problem does not appear if you read PDFs in 
 \family typewriter
 Adobe
 \begin_inset space ~
@@ -12933,6 +13202,139 @@ reference "sub:Screen-Fonts"
 
 \end_layout
 
+\begin_layout Subsection
+Math Fonts
+\end_layout
+
+\begin_layout Standard
+In LaTeX the font used for characters in equations is different from the
+ document font.
+ For the case that you use TeX fonts for your document, you can explicitly
+ choose a math font in the dialog 
+\family sans
+Document\SpecialChar \menuseparator
+Settings
+\family default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Document ! Settings
+\end_layout
+
+\end_inset
+
+.
+ The default setting is that LyX automatically selects a math font.
+ For most cases this will be LaTeX's default -- the math variant of LaTeX's
+ default font family 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+Computer
+\begin_inset space ~
+\end_inset
+
+Modern
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ LyX will automatically only load another math font if a math variant of
+ the document font is available.
+\end_layout
+
+\begin_layout Standard
+Note that the math font will not be used for 
+\emph on
+mathematical text
+\emph default
+ (which is inserted with the shortcut 
+\begin_inset Info
+type  "shortcut"
+arg   "font-default"
+\end_inset
+
+ or by the insertion of the command 
+\series bold
+
+\backslash
+text
+\series default
+ into a formula).
+ Also note that some math fonts are sans
+\begin_inset space ~
+\end_inset
+
+serif.
+ Your document might therefore look strange when the document text has serifs
+ while the math characters do not.
+ Sans
+\begin_inset space ~
+\end_inset
+
+serif math fonts make therefore in most cases only sense if you select 
+\family sans
+Sans
+\begin_inset space ~
+\end_inset
+
+Serif
+\family default
+ for the 
+\family sans
+Default
+\begin_inset space ~
+\end_inset
+
+family
+\family default
+ in the document font settings.
+\end_layout
+
+\begin_layout Standard
+If you use non-TeX fonts for the document, you can only choose for math
+ to use either the document's class default TeX font (in most cases 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+Computer
+\begin_inset space ~
+\end_inset
+
+Modern
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+) or to use the non-TeX variant of the document's class default font (in
+ most cases 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family typewriter
+Latin
+\begin_inset space ~
+\end_inset
+
+Modern
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+).
+\end_layout
+
 \begin_layout Subsection
 Using Different Character Styles
 \begin_inset Index idx
@@ -12969,8 +13371,8 @@ Emphasized
 Noun
 \family default
 .
- You can activate both of these styles via keybindings, the menus, and the
- toolbar.
+ You can activate both of these styles via key bindings, the menus, and
+ the toolbar.
 \end_layout
 
 \begin_layout Standard
@@ -15107,6 +15509,24 @@ PDF
 \begin_inset space ~
 \end_inset
 
+(cropped) This is the same as 
+\family sans
+PDF
+\begin_inset space ~
+\end_inset
+
+(pdflatex)
+\family default
+ but the result is a PDF with cropped page margins.
+ This is for example useful if you want to use LyX to generate good-looking
+ formulas to use them in other programs like for presentations.
+\end_layout
+
+\begin_layout Description
+PDF
+\begin_inset space ~
+\end_inset
+
 (dvipdfm) This uses the program 
 \family typewriter
 dvipdfm
@@ -16689,7 +17109,7 @@ name "sub:LyX's-Proper-Names"
 
 \begin_layout Standard
 You will certainly have noticed that the word โ€œLaTeXโ€ always appears with
- characters in different sizes and heights.
+ characters in different sizes and positions.
  LaTeX is the name of the program used by LyX and is therefore recognized
  as a proper name when you type it in LyX as 
 \begin_inset Quotes eld
 status collapsed
 
 \begin_layout Plain Layout
-The braces in TeX Code are here to avoid that the 
-\begin_inset Quotes eld
-\end_inset
-
-command
-\begin_inset Quotes erd
-\end_inset
-
- appear as proper name in the output, see the last paragraph of this section.
- To create proper names omit the TeX Code.
+The braces in TeX Code are here to avoid that the Text appears as proper
+ name in the output, see the last paragraph of this section.
 \end_layout
 
 \end_inset
@@ -17028,10 +17440,9 @@ Typography ! Widows and orphans
 In the early days of word processors, page breaks went wherever the page
  happened to end.
  There was no regard for what was actually going on in the text.
- You may remember once printing out a document, only to find the heading
- for a new section printed at the very bottom of the page, the first line
- of a new paragraph all alone at the bottom of a page, or the last line
- of a paragraph at the top of a new page.
+ For example the heading for a new section was printed at the very bottom
+ of the page, the first line of a new paragraph all alone at the bottom
+ of a page, or the last line of a paragraph at the top of a new page.
  These bits of text became known as 
 \emph on
 widows
@@ -17050,13 +17461,28 @@ Clearly, LyX can avoid breaking pages after a section heading.
  of a paragraph all alone at the top or bottom of a page? There are rules
  built into LaTeX governing page breaks, and some of those rules are there
  specifically to prevent widows and orphans.
- This is the advantage LyX has in using LaTeX as its backend.
-\end_layout
+ If they appear nevertheless and you don't like them, you can add the commands
+\begin_inset Newline newline
+\end_inset
 
-\begin_layout Standard
-We cannot go into how TeX and LaTeX decide to break a page, or how you can
- tweak that behavior.
- Some LaTeX books listed in the bibliography (such as
+
+\series bold
+
+\backslash
+widowpenalty=10000
+\begin_inset Newline newline
+\end_inset
+
+
+\backslash
+clubpenalty=10000
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+to the LaTeX preamble of your document to avoid them.
+ Some LaTeX books (such as
 \begin_inset space ~
 \end_inset
 
@@ -17078,8 +17504,8 @@ key "latexguide"
 
 \end_inset
 
-) may have more information.
You will almost never need to worry about this, however.
+) have more information about the technical details of LaTeX's page break
mechanism.
 \end_layout
 
 \begin_layout Chapter
@@ -18752,11 +19178,7 @@ Embedded
 Objects
 \emph default
  manual.
- You can also rotate the current cell or the whole table 90
-\begin_inset space \thinspace{}
-\end_inset
-
-degrees counterclockwise.
+ You can also rotate the current cell or the whole table.
  These rotations are not visible in LyX but are visible in the output.
 \end_layout
 
@@ -21525,10 +21947,6 @@ You should insert floats in a separate paragraph to avoid possible LaTeX-errors
 \end_layout
 
 \begin_layout Subsection
-Examples
-\end_layout
-
-\begin_layout Subsubsection
 Figure Floats
 \begin_inset CommandInset label
 LatexCommand label
@@ -21873,7 +22291,7 @@ Two distorted images.
 
 \end_layout
 
-\begin_layout Subsubsection
+\begin_layout Subsection
 Table Floats
 \begin_inset Index idx
 status collapsed
@@ -23160,7 +23578,7 @@ You may want to create spaces that differ from the standard spacing that
  To do this, press 
 \begin_inset Info
 type  "shortcut"
-arg   "command-alternatives space-insert protected ; math-space"
+arg   "command-alternatives math-space ; space-insert protected"
 \end_inset
 
  or use the 
@@ -23172,15 +23590,11 @@ Math
 Panel
 \family default
  button 
-\family sans
-
 \begin_inset Info
 type  "icon"
 arg   "math-insert \\space"
 \end_inset
 
-
-\family default
 .
  This generates a small space, and shows a small marker on the screen.
  For example, the sequence 
@@ -23269,15 +23683,11 @@ Math
 Panel
 \family default
  contains under the button 
-\family sans
-
 \begin_inset Info
 type  "icon"
 arg   "math-insert \\functions"
 \end_inset
 
-
-\family default
  a number of function macros, such as 
 \begin_inset Formula $\sin$
 \end_inset
@@ -24193,15 +24603,11 @@ Math
 Panel
 \family default
  matrix button 
-\family sans
-
 \begin_inset Info
 type  "icon"
 arg   "dialog-show mathmatrix"
 \end_inset
 
-
-\family default
 .
  It will open a dialog for you to choose the number of rows/columns.
  Here is an example:
@@ -24734,15 +25140,11 @@ Math
 Panel
 \family default
  button 
-\family sans
-
 \begin_inset Info
 type  "icon"
 arg   "math-insert \\font"
 \end_inset
 
-
-\family default
 , or enter its command, listed in table
 \begin_inset space ~
 \end_inset
@@ -25218,22 +25620,12 @@ Math
 Panel
 \family default
  button 
-\family sans
-
 \begin_inset Info
 type  "icon"
 arg   "math-insert \\font"
 \end_inset
 
-
-\family default
- (shortcut 
-\begin_inset Info
-type  "shortcut"
-arg   "font-default"
-\end_inset
-
-).
+.
  Math text appears in LyX in black instead of blue.
  You can use spaces and accents in math text as in normal text.
  Here is an example:
@@ -25302,15 +25694,11 @@ displaystyle
  situations, all text will be set in the styles that LaTeX thinks are appropriat
 e.
  These choices can be overridden by using the math panel button 
-\family sans
-
 \begin_inset Info
 type  "icon"
 arg   "math-insert \\style"
 \end_inset
 
-
-\family default
 .
  A box for the size will be created in which you can insert the math structure.
  For example, you can set 
@@ -26251,7 +26639,7 @@ reference "sub:Numbering-depth"
 \end_layout
 
 \begin_layout Subsection
-List of Figures, Tables, and Algorithms
+List of Figures, Tables, Listings and Algorithms
 \begin_inset CommandInset label
 LatexCommand label
 name "sub:List-of-Figures"
@@ -26262,7 +26650,8 @@ name "sub:List-of-Figures"
 \end_layout
 
 \begin_layout Standard
-Table, figure, and algorithm lists are very much like the table of contents.
+Table, figure, listings and algorithm lists are very much like the table
+ of contents.
  You can insert them via the 
 \family sans
 Insert\SpecialChar \menuseparator
@@ -31784,7 +32173,7 @@ Next
  button at the bottom of the dialog (or just press the 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph"
+arg   "paragraph-break"
 \end_inset
 
  key).
@@ -31793,7 +32182,7 @@ arg   "break-paragraph"
  Pressing 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph"
+arg   "paragraph-break"
 \end_inset
 
  repeatedly keeps searching forward while pressing 
@@ -31926,7 +32315,7 @@ Replace
  button or alternatively press 
 \begin_inset Info
 type  "shortcut"
-arg   "break-paragraph"
+arg   "paragraph-break"
 \end_inset
 
  or 
@@ -34108,6 +34497,18 @@ Note:
 
 \end_layout
 
+\begin_layout Description
+EPS
+\begin_inset space ~
+\end_inset
+
+(cropped) the same as 
+\family sans
+PostScript
+\family default
+ but with cropped page margins.
+\end_layout
+
 \begin_layout Description
 Graphviz
 \begin_inset space ~
 \begin_inset space ~
 \end_inset
 
-Archive
+z.y.x LyX-Document in a format readable by the LyX versions z.y.x (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+"LyX
 \begin_inset space ~
 \end_inset
 
-(zip|tar.gz) creates a zip-archive or a tar.gz-archive file (depending upon
- your system) that contains your document and all files that are necessary
- to compile it (images, child documents, BibTeX files, etc.)
+2.1.x"; 
+\begin_inset Quotes eld
+\end_inset
+
+z
+\begin_inset Quotes erd
+\end_inset
+
+ and 
+\begin_inset Quotes eld
+\end_inset
+
+y
+\begin_inset Quotes erd
+\end_inset
+
+ represent the version number)
 \end_layout
 
 \begin_layout Description
 \begin_inset space ~
 \end_inset
 
-z.y.x LyX-Document in a format readable by the LyX versions z.y.x (
-\begin_inset Quotes eld
-\end_inset
-
-z
-\begin_inset Quotes erd
-\end_inset
-
- and 
-\begin_inset Quotes eld
-\end_inset
-
-y
-\begin_inset Quotes erd
+Archive
+\begin_inset space ~
 \end_inset
 
- represent the version number)
+(zip|tar.gz) creates a zip-archive or a tar.gz-archive file (depending upon
+ your system) that contains your document and all files that are necessary
+ to compile it (images, child documents, BibTeX files, etc.)
 \end_layout
 
 \begin_layout Description
@@ -34426,6 +34839,22 @@ LibreOffice, OpenOffice, KOffice, Abiword
  all cases)
 \end_layout
 
+\begin_layout Description
+PDF
+\begin_inset space ~
+\end_inset
+
+(cropped) the same as 
+\family sans
+PDF
+\begin_inset space ~
+\end_inset
+
+(pdflatex)
+\family default
+ but with cropped page margins.
+\end_layout
+
 \begin_layout Description
 
 \family sans
@@ -34939,8 +35368,8 @@ Increase/Decrease List Depth
 \end_layout
 
 \begin_layout Standard
-These menu entries are only active if the cursor is in an environment that
can be nested.
+These menus are only active if the cursor is in an environment that can
+ be nested.
  They increase/decrease the environment nesting level as explained in section
 \begin_inset space ~
 \end_inset
@@ -34962,6 +35391,29 @@ reference "sub:Numbering-depth"
 .
 \end_layout
 
+\begin_layout Subsection
+
+\family sans
+Start New Environment/Start New Parent Environment
+\end_layout
+
+\begin_layout Standard
+These menus are only visible if it is possible to have two consecutive environme
+nts of the same type.
+ See section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Separate-Nestings"
+
+\end_inset
+
+ for an explanation.
+\end_layout
+
 \begin_layout Section
 The View Menu
 \begin_inset Index idx
@@ -35936,11 +36388,15 @@ List of Algorithms
 \family default
 , 
 \family sans
-List of Figures
+List of Figures,
 \family default
- and 
 \family sans
 List of Tables
+\family default
+ and 
+\family sans
+List of Listings
 \family default
  are described in section
 \begin_inset space ~
@@ -40062,6 +40518,15 @@ Note that LyX will not show two columns or the specified line spacing on
  However, it will be as you specified in the output.
 \end_layout
 
+\begin_layout Standard
+With the option 
+\family sans
+Use justification in LyX work area
+\family default
+ you can decide if LyX justifies the text on screen.
+ This only affects the text inside LyX not in the output.
+\end_layout
+
 \begin_layout Section
 Page Layout
 \end_layout
@@ -40135,26 +40600,6 @@ The document language and quote styles are set here.
  All characters that cannot be encoded using the specified encoding will
  be exported as LaTeX-commands (this can fail if a LaTeX-command is not
  known for a particular character).
-\begin_inset Foot
-status collapsed
-
-\begin_layout Plain Layout
-The known commands are defined in a text file (
-\emph on
-unicodesymbols
-\emph default
-).
- You can add commands for unknown symbols to that file yourself, see the
-\emph on
-Customization
-\emph default
- manual for details.
-\end_layout
-
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -41105,24 +41550,6 @@ Change
  later more quickly.
 \end_layout
 
-\begin_layout Standard
-\begin_inset Note Greyedout
-status open
-
-\begin_layout Plain Layout
-The colors are not shown within LyX, only in the output.
- (This Greyed
-\begin_inset space ~
-\end_inset
-
-out note appears blue in the output.)
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
 \begin_layout Standard
 Note, if you change the 
 \family sans
@@ -41251,11 +41678,11 @@ yellow
 \series bold
 color name
 \series default
- unless you have defined your own color (see the 
+ unless you have defined your own color (see the section 
 \emph on
 Colored Tables
 \emph default
section of the 
+ of the 
 \emph on
 Embedded
 \begin_inset space ~
@@ -41340,15 +41767,23 @@ note_fontcolor
 \end_layout
 
 \begin_layout Standard
-To see how to define and use custom colors, see section Colored
+To see how to define and use custom colors, see section 
+\emph on
+Colored
 \begin_inset space ~
 \end_inset
 
-Cells of the Embedded
+Cells
+\emph default
+ of the 
+\emph on
+Embedded
 \begin_inset space ~
 \end_inset
 
-Objects manual.
+Objects
+\emph default
+ manual.
 \end_layout
 
 \begin_layout Section
@@ -41513,7 +41948,35 @@ LaTeX-packages ! amsmath
 
 , 
 \series bold
-esint
+amssymb
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LaTeX-packages ! amssymb
+\end_layout
+
+\end_inset
+
+,
+\series bold
+ cancel
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LaTeX-packages ! cancel
+\end_layout
+
+\end_inset
+
+,
+\series bold
+ esint
 \series default
 
 \begin_inset Index idx
@@ -41539,7 +42002,21 @@ LaTeX-packages ! mathdots
 
 \end_inset
 
- und 
+, 
+\series bold
+mathtools
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LaTeX-packages ! mathtools
+\end_layout
+
+\end_inset
+
+, 
 \series bold
 mhchem
 \series default
@@ -41553,20 +42030,76 @@ LaTeX-packages ! mhchem
 
 \end_inset
 
- or to use them automatically when they are needed.
+, 
+\series bold
+stackrel
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LaTeX-packages ! stackrel
+\end_layout
+
+\end_inset
+
+, 
+\series bold
+stmaryrd
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LaTeX-packages ! stmaryrd
+\end_layout
+
+\end_inset
+
+ and 
+\series bold
+undertilde
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LaTeX-packages ! undertilde
+\end_layout
+
+\end_inset
+
+, or to use them automatically when they are needed.
 \end_layout
 
 \begin_layout Description
 amsmath is needed for many constructs, so when you get LaTeX-errors in formulas,
- ensure that you have enabled 
-\family sans
-AMS
+ ensure that you have this enabled.
+\end_layout
+
+\begin_layout Description
+amssymb is needed for some special math symbols like bold or upright Greek
+ letters, so when you get LaTeX-errors in formulas, ensure that you have
+ this enabled.
+\end_layout
+
+\begin_layout Description
+cancel is used for canceled formulas, see section 
+\emph on
+Canceled
 \begin_inset space ~
 \end_inset
 
-math
-\family default
-.
+Formulas
+\emph default
+ of the 
+\emph on
+Math
+\emph default
+ manual.
 \end_layout
 
 \begin_layout Description
@@ -41597,6 +42130,50 @@ Math
  manual.
 \end_layout
 
+\begin_layout Description
+mathtools is used for the math commands 
+\series bold
+
+\backslash
+overbracket
+\series default
+, 
+\series bold
+
+\backslash
+underbracket
+\series default
+, 
+\series bold
+
+\backslash
+smashoperator
+\series default
+, 
+\series bold
+
+\backslash
+adjustlimits
+\series default
+, 
+\series bold
+
+\backslash
+splitfrac
+\series default
+, 
+\series bold
+
+\backslash
+shortintertext
+\series default
+ and labeled arrows, see the corresponding sections in the 
+\emph on
+Math
+\emph default
+ manual.
+\end_layout
+
 \begin_layout Description
 mhchem is used for chemical equations, see section 
 \emph on
@@ -41609,6 +42186,46 @@ Math
  manual.
 \end_layout
 
+\begin_layout Description
+stackrel is used for the math command 
+\series bold
+
+\backslash
+stackrel
+\series default
+, see section 
+\emph on
+Relations 
+\emph default
+of the 
+\emph on
+Math
+\emph default
+ manual.
+\end_layout
+
+\begin_layout Description
+stmaryrd is used for a few special math symbols.
+\end_layout
+
+\begin_layout Description
+undertilde is used for the math command 
+\series bold
+
+\backslash
+utilde
+\series default
+, see section 
+\emph on
+Accents for one Character 
+\emph default
+of the 
+\emph on
+Math
+\emph default
+ manual.
+\end_layout
+
 \begin_layout Section
 Float Placement
 \end_layout
@@ -42323,7 +42940,7 @@ target "http://wiki.lyx.org/uploads/LyX/NewInLyX20/themes.png"
 \end_layout
 
 \begin_layout Subsubsection
-Automatic help
+Context help
 \end_layout
 
 \begin_layout Standard
@@ -42336,7 +42953,33 @@ Enable tool tips in main work area
 \end_layout
 
 \begin_layout Subsubsection
-Session
+Menus
+\end_layout
+
+\begin_layout Standard
+
+\family sans
+Maximum last files
+\family default
+ is the number of last opened files that LyX should display in the menu
+\family sans
+File\SpecialChar \menuseparator
+Open
+\begin_inset space ~
+\end_inset
+
+Recent
+\family default
+.
+\end_layout
+
+\begin_layout Subsection
+Document Handling
+\end_layout
+
+\begin_layout Subsubsection
+Session handling
 \end_layout
 
 \begin_layout Standard
@@ -42375,7 +43018,7 @@ Clear all session information
 \end_layout
 
 \begin_layout Subsubsection
-Documents
+Backup & saving
 \begin_inset CommandInset label
 LatexCommand label
 name "sub:Backup documents"
@@ -42461,22 +43104,8 @@ Save documents compressed by default
  always saves files in a compressed format.
 \end_layout
 
-\begin_layout Standard
-
-\family sans
-Maximum last files
-\family default
- is the number of last opened files that LyX should display in the menu
-\family sans
-File\SpecialChar \menuseparator
-Open
-\begin_inset space ~
-\end_inset
-
-Recent
-\family default
-.
+\begin_layout Subsubsection
+Windows & work area
 \end_layout
 
 \begin_layout Standard
@@ -42548,7 +43177,7 @@ status open
 \series bold
 Note:
 \series default
- For the last option you have to restart LyX before the change takes effect.
+ For this option you have to restart LyX before the change takes effect.
 \end_layout
 
 \end_inset
@@ -42556,6 +43185,23 @@ Note:
 
 \end_layout
 
+\begin_layout Standard
+With the setting 
+\family sans
+Closing last view
+\family default
+ you one can decide if a document is closed or hidden when its tab or view
+ is closed.
+ Hidden documents are accessible via the menu 
+\family sans
+View\SpecialChar \menuseparator
+Hidden
+\family default
+.
+ Not to close documents can be useful if you open files parallel in several
+ instances of LyX and only want to close the view in once instance.
+\end_layout
+
 \begin_layout Subsection
 Screen Fonts
 \begin_inset Index idx
@@ -43903,14 +44549,26 @@ Default
 \begin_inset space ~
 \end_inset
 
-Decimal
+decimal
 \begin_inset space ~
 \end_inset
 
-Point Define the default decimal point for use in tables (decimal point
+separator Defines the default decimal point for use in tables (decimal point
  alignment).
 \end_layout
 
+\begin_layout Description
+Default
+\begin_inset space ~
+\end_inset
+
+length
+\begin_inset space ~
+\end_inset
+
+unit Defines the unit that is used as default for lengths in LyX's dialogs.
+\end_layout
+
 \begin_layout Description
 Set
 \begin_inset space ~