]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
UserGuide.lyx: describe the new preview inset and revise the section about previewing...
[lyx.git] / lib / doc / UserGuide.lyx
index 660ab4c8e14273066fed1f0ea28d0cccabcf732e..8752000947c088baac2e2c39b5e3831628ecba5a 100644 (file)
@@ -12028,10 +12028,9 @@ reference "sub:LaTeX-font-support"
 \end_inset
 
 ).
- You will then not have access to TeX's own fonts (the selection described
- below).
- Note that LyX lists all available fonts in either of the three lists (roman,
- sans
+ You will then not have access to TeX's own fonts.
+ Note that LyX then lists all available fonts in each of the three lists
+ (roman, sans
 \begin_inset space ~
 \end_inset
 
@@ -12039,7 +12038,7 @@ serif, and typewriter), since LyX cannot determine the family.
  Also note that the output might fail with some of the listed fonts, due
  to the encoding of the fonts and\SpecialChar \slash{}
 or font failures.
Again, LyX cannot determine this in advance, so you might need to experiment.
+ LyX cannot determine this in advance, so you might need to experiment.
 \end_layout
 
 \begin_layout Standard
@@ -12585,10 +12584,20 @@ status collapsed
 X font encoding
 \family default
  selection is an expert setting which lets you change the value passed to
- the LaTeX-package
-\emph on
- fontenc
-\emph default
+ the LaTeX-package 
+\series bold
+fontenc
+\series default
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LaTeX-packages ! fontenc
+\end_layout
+
+\end_inset
+
  (see also sec.
 \begin_inset space ~
 \end_inset
@@ -12624,16 +12633,18 @@ Use True Small Caps
 \family sans
 Use Old Style Figures
 \family default
- is checked, the font uses old style (also known as medieval or text) figures,
- i.
+ is checked, old style figures (also known as medieval or text figures)
+ are used.
+ Old style figures are the numerals (0
 \begin_inset space \thinspace{}
 \end_inset
 
-e.
-\begin_inset space ~
+-
+\begin_inset space \thinspace{}
 \end_inset
 
-figures with varying height that fit nicely with lower letters.
+9) with ascenders and descenders, which makes them fit nicely with lower
+ letters.
  
 \family sans
 Use True Small Caps
@@ -12660,11 +12671,20 @@ The font will be the argument for the commands of the LaTeX-package
 CJK
 \series default
 .
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LaTeX-packages ! CJK
+\end_layout
+
+\end_inset
+
  So this has no effect for the document language 
 \family sans
 Japanese
 \family default
- that doesn't use 
+ that does not use 
 \series bold
 CJK
 \series default
@@ -30253,7 +30273,7 @@ header styles.
 
 \begin_layout Standard
 For the definition, you will need some LaTeX-commands that are inserted
- as TeX-code (menu 
+ as TeX code (menu 
 \family sans
 Insert\SpecialChar \menuseparator
 Te
@@ -30712,17 +30732,15 @@ Document ! Preview
 \begin_layout Standard
 LyX allows you to generate previews of sections of your document on the
  fly so you can see how they will look in the final document without having
- to break your train of thought with 
-\family sans
-View\SpecialChar \menuseparator
-DVI
-\family default
-.
+ to break your train of thought with viewing the output.
+\end_layout
+
+\begin_layout Subsection
+Prerequisites
 \end_layout
 
 \begin_layout Standard
-If you would for example like to see in LyX your math formulas typeset by
- LaTeX, install the LaTeX-package 
+To get previews working, you need the LaTeX package 
 \series bold
 preview-latex
 \series default
@@ -30736,20 +30754,54 @@ LaTeX-packages ! preview-latex
 
 \end_inset
 
- as explained below, and turn on 
+ (on some systems named simply 
+\series bold
+preview
+\series default
+) installed.
+ If it is not already installed, you will find it in the TeX-catalogue,
+\begin_inset CommandInset citation
+LatexCommand cite
+key "TeXCatalogue"
+
+\end_inset
+
+ or in the package manager of your LaTeX-system.
+ You obtain prettier results if you install the program 
+\family typewriter
+pnmcrop
+\family default
+ from the 
+\family typewriter
+netpbm
+\family default
+ package; for LyX on Windows this program and also the LaTeX-package is
+ automatically installed together with LyX.
+\end_layout
+
+\begin_layout Subsection
+Enabling previews
+\end_layout
+
+\begin_layout Standard
+If you would for example like to see in LyX your math formulas typeset by
+ LaTeX, activate the option 
 \family sans
-Instant
+Display
 \begin_inset space ~
 \end_inset
 
-preview
+Graphics
 \family default
  in the 
 \family sans
 Tools\SpecialChar \menuseparator
 Preferences 
 \family default
-dialog under Look
+dialog under 
+\family sans
+Look
 \begin_inset space ~
 \end_inset
 
@@ -30758,7 +30810,22 @@ and
 \end_inset
 
 feel\SpecialChar \menuseparator
-Display.
+Display
+\family default
+.
+ Then set 
+\family sans
+Instant
+\begin_inset space ~
+\end_inset
+
+Preview
+\family default
+ to 
+\family sans
+On
+\family default
+.
  The 
 \family sans
 Preview
@@ -30773,77 +30840,296 @@ Size
 \begin_layout Standard
 Previews are generated when you load a document into LyX and when you finish
  editing an inset.
- Previews of an already loaded document are 
-\emph on
-not
-\emph default
- generated just by selecting the 
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ Previews of an already loaded document are not in every case immediately
+ generated by activating the option 
 \family sans
-Instant
+Display
 \begin_inset space ~
 \end_inset
 
-preview
+Graphics
 \family default
- check box, you have to reopen the documents to activate the previews.
+.
+ Reopening the documents assures to get previews.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
+Selected document parts
 \end_layout
 
 \begin_layout Standard
-LyX will generate previews of math insets.
- It will also generate previews of included insets if you select the 
+Besides math there are other cases where you might like to see a preview,
+ fox example things that LyX cannot render like rotated parts or things
+ which are not yet supported by LyX.
+ To do this, insert a preview inset via the menu 
 \family sans
-Show
+Insert\SpecialChar \menuseparator
+Preview
+\family default
+.
+ Insert or paste the stuff that you want to preview into this inset.
+ The preview will be generated when the cursor is outside the preview inset.
+ If you click on the preview, you can edit the previewed stuff.
+\end_layout
+
+\begin_layout Standard
+An example: To create rotated boxes, you use the LaTeX command 
+\series bold
+
+\backslash
+rotatebox
+\series default
+ which is not yet supported by LyX.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+
+\series bold
+
+\backslash
+rotatebox
+\series default
+ is explained in section 
+\emph on
+Rotated and Scaled Boxes
+\emph default
+ of the 
+\emph on
+Embedded
 \begin_inset space ~
 \end_inset
 
-preview
-\family default
- check box in the insert dialog.
- This is useful if you wish to generate a preview of a LaTeX figure, for
- example.
+Objects
+\emph default
+ manual.
+\end_layout
+
+\end_inset
+
+ Instead of the TeX Code boxes you want to see in LyX the final rotated
+ boxes, for example to adjust the rotation angle to fit with the surrounding
+ text.
+ Therefore you create a preview inset and copy the text with the rotated
+ boxes into in.
+ Here is the result:
 \end_layout
 
 \begin_layout Standard
-To get previews working, you need the LaTeX package 
+\begin_inset Preview
+
+\begin_layout Standard
+This is a line
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+rotatebox[origin=r]{-60}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Box Doublebox
+position "c"
+hor_pos "c"
+has_inner_box 0
+inner_pos "c"
+use_parbox 0
+use_makebox 0
+width "1in"
+special "width"
+height "1in"
+height_special "totalheight"
+status collapsed
+
+\begin_layout Plain Layout
+with rotated
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ framed text 
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+rotatebox[origin=lb]{60}{
+\end_layout
+
+\end_inset
+
+
+\begin_inset Formula $\int A\,\mathrm{d}x=B$
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+ and a formula.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Previewing works also for colors.
+ In this example a special framed, colored box was created using the LaTeX
+ command 
 \series bold
-preview-latex
+
+\backslash
+fcolorbox
 \series default
- (on some systems named simply 
+:
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+
 \series bold
-preview
+
+\backslash
+fcolorbox
 \series default
-) installed.
- If it is not already installed, you will find it in the TeX-catalogue,
-\begin_inset CommandInset citation
-LatexCommand cite
-key "TeXCatalogue"
+ is explained in section 
+\emph on
+Colored Boxes
+\emph default
+ of the 
+\emph on
+Embedded
+\begin_inset space ~
+\end_inset
+
+Objects
+\emph default
+ manual.
+\end_layout
 
 \end_inset
 
- or in the package manager of your LaTeX-system.
- You obtain prettier results if you install the program 
-\family typewriter
-pnmcrop
-\family default
- from the 
-\family typewriter
-netpbm
-\family default
- package; for LyX on Windows this program is automatically installed together
- with LyX.
+
 \end_layout
 
 \begin_layout Standard
-\begin_inset VSpace bigskip
+\begin_inset Preview
+
+\begin_layout Standard
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fboxrule 1mm 
+\backslash
+fboxsep 1mm
+\end_layout
+
+\end_inset
+
+
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+fcolorbox{cyan}{magenta}{
+\end_layout
+
+\end_inset
+
+This is text within a colored, framed box.
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
 \end_inset
 
 
 \end_layout
 
 \begin_layout Standard
-You can furthermore preview the LaTeX source of the whole document or parts
- of it.
+\begin_inset VSpace medskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+If LyX does not show a preview, assure that you enabled previews as described
+ above and also assure that TeX Code in the preview inset is valid and that
+ you loaded the LaTeX packages in your document preamble that are required
+ by the TeX Code.
+ If LyX cannot create a preview, you will in most cases also not be able
+ to view your document due to LaTeX errors.
+ So if you have to use some TeX Code and don't know if it is correct, the
+ preview inset is a nice method to check it without the need to view the
+ whole document.
+\end_layout
+
+\begin_layout Subsection
+LaTeX source code
+\end_layout
+
+\begin_layout Standard
+You can preview the LaTeX source of the whole document or parts of it.
  Use the menu 
 \family sans
 View\SpecialChar \menuseparator
@@ -38612,31 +38898,114 @@ Menu ! View
 \end_layout
 
 \begin_layout Standard
-The 
+At the bottom of the 
 \family sans
 View
 \family default
- menu contains a list of available formats in which you can view the actual
- document with an external program.
- The menu entries for the viewing formats are not the same on all installations
- — it depends on the LaTeX programs that are found while LyX was configured.
- All possible formats are formats listed in section
+ menu the opened documents are listed.
+\end_layout
+
+\begin_layout Subsection
+Open/Close all Insets
+\end_layout
+
+\begin_layout Standard
+Opens/closes all insets in your document.
+\end_layout
+
+\begin_layout Subsection
+Unfold/Fold Math Macros
+\end_layout
+
+\begin_layout Standard
+Unfolds/folds the current math macro.
+\end_layout
+
+\begin_layout Standard
+Math macros are described in the 
+\emph on
+Math
+\emph default
+ manual.
+\end_layout
+
+\begin_layout Subsection
+View Source
+\end_layout
+
+\begin_layout Standard
+Opens a window showing the source code of the actual document, as described
+ in section
 \begin_inset space ~
 \end_inset
 
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sub:Export"
+reference "sec:Previewing-snippets-of"
 
 \end_inset
 
 .
- You should at least see the menu entries 
-\family sans
-DVI
-\family default
- and 
+\end_layout
+
+\begin_layout Subsection
+View Messages
+\end_layout
+
+\begin_layout Standard
+Opens a window showing console messages.
+ This is useful for debugging LyX (i.
+\begin_inset space \thinspace{}
+\end_inset
+
+e., hunt for errors in the program) or to see what is going on in the background
+ while LaTeX is processing the document,
+\end_layout
+
+\begin_layout Subsection
+View
+\end_layout
+
+\begin_layout Standard
+This menu entry generates the output in the format you have specified as
+ default output format either in the preferences (see sec.
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:File-Formats"
+
+\end_inset
+
+) or in the document settings (see sec.
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:Doc-Output"
+
+\end_inset
+
+) and opens it in an appropriate viewer.
+ The viewer can be set or changed in the preferences, see section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:File-Formats"
+
+\end_inset
+
+.
+ The default viewers are set by LyX when it is first configured.
+ The default output format is 
 \family sans
 PDF
 \begin_inset space ~
@@ -38645,7 +39014,36 @@ PDF
 (pdflatex)
 \family default
 .
- If one of the two is missing, you need to update your LaTeX installation.
+\end_layout
+
+\begin_layout Subsection
+View (Other Formats)
+\end_layout
+
+\begin_layout Standard
+With this submenu you can view your document in alternative output formats.
+ The menu contains a list of available formats in which you can view the
+ actual document with an external program.
+ The menu entries are not the same on all installations — it depends on
+ the LaTeX programs that are found while LyX was configured.
+ All possible formats are listed in section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Export"
+
+\end_inset
+
+.
+ You should at least see the menu entry 
+\family sans
+DVI
+\family default
+.
+ If it is missing, you need to update or repair your LaTeX installation.
  After updating you have to reconfigure LyX, see section
 \begin_inset space ~
 \end_inset
@@ -38687,123 +39085,6 @@ reference "sec:File-Formats"
  The default viewers are set by LyX when it is first configured.
 \end_layout
 
-\begin_layout Standard
-\begin_inset VSpace bigskip
-\end_inset
-
-At the bottom of the 
-\family sans
-View
-\family default
- menu the opened documents are listed.
-\end_layout
-
-\begin_layout Subsection
-Open/Close all Insets
-\end_layout
-
-\begin_layout Standard
-Opens/closes all insets in your document.
-\end_layout
-
-\begin_layout Subsection
-Unfold/Fold Math Macros
-\end_layout
-
-\begin_layout Standard
-Unfolds/folds the current math macro.
-\end_layout
-
-\begin_layout Standard
-Math macros are described in the 
-\emph on
-Math
-\emph default
- manual.
-\end_layout
-
-\begin_layout Subsection
-View Source
-\end_layout
-
-\begin_layout Standard
-Opens a window showing the source code of the actual document, as described
- in section
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:Previewing-snippets-of"
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Subsection
-View Messages
-\end_layout
-
-\begin_layout Standard
-Opens a window showing console messages.
- This is useful for debugging LyX (i.
-\begin_inset space \thinspace{}
-\end_inset
-
-e., hunt for errors in the program) or to see what is going on in the background
- while LaTeX is processing the document,
-\end_layout
-
-\begin_layout Subsection
-View
-\end_layout
-
-\begin_layout Standard
-This menu entry generates the output in the format you have specified as
- default output format either in the preferences (see sec.
-\begin_inset space \thinspace{}
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:File-Formats"
-
-\end_inset
-
-) or in the document settings (see sec.
-\begin_inset space \thinspace{}
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:Doc-Output"
-
-\end_inset
-
-) and opens it in an appropriate viewer.
- The default output format is 
-\family sans
-PDF
-\begin_inset space ~
-\end_inset
-
-(pdflatex)
-\family default
-.
-\end_layout
-
-\begin_layout Subsection
-View (Other Formats)
-\end_layout
-
-\begin_layout Standard
-With this submenu you can view your document in alternative output formats.
-\end_layout
-
 \begin_layout Subsection
 Update
 \end_layout
@@ -40238,6 +40519,25 @@ Objects
  manual.
 \end_layout
 
+\begin_layout Subsection
+Preview
+\end_layout
+
+\begin_layout Standard
+Inserts a preview inset, see section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:Previewing-snippets-of"
+
+\end_inset
+
+ for a description.
+\end_layout
+
 \begin_layout Section
 The Navigate Menu
 \begin_inset Index idx
@@ -40888,7 +41188,7 @@ Embedded Objects
 \begin_inset Text
 
 \begin_layout Plain Layout
-pull-down box for the paragraph environments
+pull-down box for the environments
 \end_layout
 
 \end_inset
@@ -42793,19 +43093,28 @@ The document settings dialog contains submenus to set properties for the
 Settings
 \family default
 .
- You can save your document settings as default with th
+ You can save your document settings as default with the
 \family sans
-e Save as Document Defaults
+ Save as Document Defaults
 \family default
  button in the dialog.
  This will create a template named 
 \family typewriter
-default.lyx
+defaults.lyx
 \family default
  which is automatically loaded by LyX when you create a new document without
  using a template.
 \end_layout
 
+\begin_layout Standard
+The button 
+\family sans
+Use Class Defaults
+\family default
+ resets the document settings to the default of the document class.
+ This affects mostly class options, the page layout and Numbering & TOC.
+\end_layout
+
 \begin_layout Standard
 The different submenus of the dialog are explained in the following.
 \end_layout
@@ -42829,20 +43138,49 @@ reference "sec:Document-Classes"
 \end_inset
 
 .
- Some classes use some class options by default.
+\end_layout
+
+\begin_layout Standard
+With the button 
+\family sans
+Local
+\begin_inset space ~
+\end_inset
+
+Layout
+\family default
+ you can load you own layout-file, that is not in LyX's 
+\emph on
+layouts
+\emph default
+ folder and thus not recognized by LyX as layout for a document class.
+ For more about layout-files, see the chapter 
+\emph on
+Installing New Document Classes, Layouts, and Templates
+\emph default
+ of the 
+\emph on
+Customization
+\emph default
+ Handbook.
+\end_layout
+
+\begin_layout Standard
+Some classes use special class options by default.
  If this is the case, they are listed in the field 
 \family sans
 Predefined
 \family default
  and you can decide to use them or not.
- If you don't exactly know what the default class options are for, it is
- recommended not to touch them.
+ If you do not exactly know what the default class options are for, it is
+ recommended to use them untouched.
  The 
 \family sans
 Graphics driver
 \family default
  is used for LaTeX's graphics, color and page layout packages.
When using 
If using 
 \family sans
 Default
 \family default
@@ -42865,11 +43203,12 @@ dvi2ps, dvialw, dvilaser, dvitops, psprint, pubps, ln
 \begin_inset Newline newline
 \end_inset
 
-you first have to activate them in your LaTeX distribution, see sec.
-\begin_inset space \thinspace{}
-\end_inset
-
-2 in 
+you first have to activate them in your LaTeX distribution, see section
+\emph on
+Driver support
+\emph default
+ in 
 \begin_inset CommandInset href
 LatexCommand href
 target "http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf"
@@ -42887,8 +43226,8 @@ target "http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf"
 \begin_layout Standard
 Specifying a master document is necessary if the current document is a child
  or subdocument.
- This master document will be used by LyX if the child document is opened
- without its master.
+ The master document will be used by LyX in the background if the child
document is opened without its master.
  This way child documents are always compilable.
  More about master and child documents is explained in the section 
 \emph on
@@ -43038,13 +43377,13 @@ Text Layout
 \begin_layout Standard
 You can specify if paragraphs should be separated by indentations or vertical
  skips.
- The line spacing and the number of text columns can here also be specified.
+ The line spacing and the number of text columns can also be specified here.
 \end_layout
 
 \begin_layout Standard
 Note that LyX will not show two columns or the set up line spacing on screen.
- That is impractical, often unreadable, and not part of the WYSIWYM concept.
+ That would be impractical, often unreadable and is not part of the WYSIWYM
+ concept.
  However, it will be as you specified it in the output.
 \end_layout
 
@@ -43261,7 +43600,30 @@ Part
 \end_layout
 
 \begin_layout Description
-Default is the package 
+Default uses the language package that is selected in
+\family sans
+ Tools\SpecialChar \menuseparator
+Preferences\SpecialChar \menuseparator
+Language Settings
+\family default
+ (see section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Prefs-Language"
+
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Description
+Automatic selects the most suitable language package for the view/export
+ format you will use.
+ In many cases this will be 
 \series bold
 babel
 \series default
@@ -43276,12 +43638,7 @@ LaTeX-packages ! babel
 \end_inset
 
 .
-\end_layout
-
-\begin_layout Description
-Automatic selects the most suitable language package for the view/export
- format you will use.
- For example for the XeTeX formats the package 
+ If the newer package 
 \series bold
 polyglossia
 \series default
@@ -43295,7 +43652,8 @@ LaTeX-packages ! polyglossia
 
 \end_inset
 
- will be used instead of 
+ is more appropriate (is the case when using XeTeX and/or non-TeX fonts),
+ this package will be used instead of 
 \series bold
 babel
 \series default
@@ -43307,11 +43665,15 @@ Always
 \begin_inset space ~
 \end_inset
 
-Babel uses in every case 
+Babel uses 
 \series bold
 babel
 \series default
-.
+ even if 
+\series bold
+polyglossia
+\series default
+ would be more appropriate.
 \end_layout
 
 \begin_layout Description
@@ -44865,24 +45227,6 @@ Customization ! of menus
 \end_inset
 
 
-\end_layout
-
-\begin_layout Standard
-\begin_inset Note Greyedout
-status open
-
-\begin_layout Plain Layout
-
-\series bold
-Note:
-\series default
- You have to restart LyX before the change of the user interface file take
- effect.
-\end_layout
-
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -44920,7 +45264,7 @@ Menu
 \family sans
 Toolbar
 \family default
- entries must be ended with an explicit 
+ entries must be finished with an explicit 
 \family sans
 End
 \family default
@@ -45057,6 +45401,23 @@ bookmark-save 6
 to the navigate menu section in the .inc-file to have the sixth bookmark.
 \end_layout
 
+\begin_layout Subsubsection
+Icon Set
+\end_layout
+
+\begin_layout Standard
+Here you can change the appearance of LyX's toolbar buttons.
+ The currently available icon sets are compared in 
+\begin_inset CommandInset href
+LatexCommand href
+name "this image"
+target "http://wiki.lyx.org/uploads/LyX/NewInLyX20/themes.png"
+
+\end_inset
+
+.
+\end_layout
+
 \begin_layout Subsubsection
 Automatic help
 \end_layout
@@ -45077,15 +45438,7 @@ Session
 \begin_layout Standard
 With the option 
 \family sans
-Allow saving
-\begin_inset space \thinspace{}
-\end_inset
-
-/
-\begin_inset space \thinspace{}
-\end_inset
-
-restoring of window layout and geometries
+Restore window layouts and geometries
 \family default
  LyX's main window will be opened with the size and layout that was used
  in the last LyX session.
@@ -45108,6 +45461,15 @@ Load opened files from last session
  opens all files that were opened in the last LyX session.
 \end_layout
 
+\begin_layout Standard
+The button 
+\family sans
+Clear all session information
+\family default
+ deletes all information from previous LyX sessions (cursor positions, names
+ of last opened documents, etc.).
+\end_layout
+
 \begin_layout Subsubsection
 Documents
 \begin_inset CommandInset label
@@ -45130,11 +45492,57 @@ Backup ! Documents
 \end_layout
 
 \begin_layout Standard
-If the option 
+
+\family sans
+Backup original documents when saving
+\family default
+ creates a backup copy of the file in the state when it was opened or when
+ it was saved the last time.
+ It is stored in the same folder as your document or in the 
+\family sans
+Backup
+\begin_inset space ~
+\end_inset
+
+directory
+\family default
+, see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:Paths"
+
+\end_inset
+
+.
+ The backup file has the file extension 
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+.lyx~
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+With the option 
+\family sans
+Backup documents, every
+\family default
+, you can specify the time between backup saves.
+\end_layout
+
+\begin_layout Standard
+
 \family sans
-Backup documents
+Save documents compressed by default
 \family default
is set, you can specify the time between backup saves.
saves the files always in a compressed format.
 \end_layout
 
 \begin_layout Standard
@@ -45164,6 +45572,43 @@ Open documents in tabs
  LyX.
 \end_layout
 
+\begin_layout Standard
+With the option 
+\family sans
+Single close-tab button
+\family default
+ there will only be one button (
+\family sans
+
+\begin_inset Graphics
+       filename ../images/closetab.png
+       scale 75
+
+\end_inset
+
+
+\family default
+) at the right side of the tab bar to close tabs.
+ Otherwise every document tab has its own close button.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ For the last option you have to restart LyX before the chang takes effect.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
 \begin_layout Subsection
 Screen Fonts
 \begin_inset Index idx
@@ -45367,6 +45812,27 @@ Alter
  button.
 \end_layout
 
+\begin_layout Standard
+By using the option 
+\family sans
+Use system colors
+\family default
+ the color scheme of your OS or window manager is used.
+ The colors 
+\family sans
+cursor, selection, table line, text, URL
+\begin_inset space ~
+\end_inset
+
+label and URL
+\begin_inset space ~
+\end_inset
+
+text
+\family default
+ are then not customizable and thus not listed.
+\end_layout
+
 \begin_layout Subsection
 Display
 \begin_inset Index idx
@@ -45457,15 +45923,33 @@ Cursor follows scrollbar
 \end_layout
 
 \begin_layout Standard
-You can adjust the thickness of the cursor with the 
-\family sans
-Cursor width
-\family default
- setting.
+You can adjust the width of the cursor.
  If you set the value to zero the thickness of the cursor scales relative
  to the zoom value you choose for the screen fonts.
 \end_layout
 
+\begin_layout Standard
+
+\family sans
+Scroll below end of document
+\family default
+ is self-explanatory.
+\end_layout
+
+\begin_layout Standard
+In LyX one can jump from word to word by pressing 
+\family sans
+Ctrl+arrow key
+\family default
+.
+ With the option
+\family sans
+ Use Mac-style for cursor moving between words
+\family default
+ the cursor jumps from the end of a word to the end of the next word.
+ Normally it jumps from the beginning to the beginning.
+\end_layout
+
 \begin_layout Standard
 The option 
 \family sans
@@ -45807,7 +46291,7 @@ Note:
 \end_layout
 
 \begin_layout Standard
-Besides this, you can specify here the 
+You can furthermore specify here the 
 \family sans
 Wheel scrolling speed
 \family default
@@ -45816,6 +46300,15 @@ Wheel scrolling speed
  slow it down.
 \end_layout
 
+\begin_layout Standard
+In the section 
+\family sans
+Scroll wheel zoom
+\family default
+ you can select a key for zooming.
+ When this key is pressed and the mouse wheel is rotated, the text is zoomed.
+\end_layout
+
 \begin_layout Subsection
 Input Completion
 \begin_inset CommandInset label
@@ -46008,7 +46501,7 @@ Working directory
 \begin_inset Newline newline
 \end_inset
 
-The backup files have the ending 
+Backup files have the ending 
 \begin_inset Quotes eld
 \end_inset
 
@@ -46031,7 +46524,7 @@ status collapsed
 
 \end_inset
 
-XServer-Pipe Here you can enter the name of a Unix-pipe.
+XServer-Pipe Here you can enter the name of a UNIX-pipe.
  This pipe is used to send data from external programs to LyX.
 \begin_inset Newline newline
 \end_inset
@@ -46100,6 +46593,41 @@ Temporary
 directory Temporary files will be saved in this directory.
 \end_layout
 
+\begin_layout Description
+Thesaurus
+\begin_inset space ~
+\end_inset
+
+directory Directory where the thesaurus dictionaries are located.
+ You only need to specify it if the thesaurus does otherwise not work or
+ if you want to use custom/alternative dictionaries.
+\end_layout
+
+\begin_layout Description
+Hunspell
+\begin_inset space ~
+\end_inset
+
+directory Directory where the dictionaries of the spell checker program
+\family typewriter
+Hunspell
+\family default
+ are located.
+ You only need to specify it if you are using 
+\family typewriter
+Hunspell
+\family default
+ and spell checking does otherwise not work or if you want to use custom/alterna
+tive dictionaries.
+ For LyX on Windows 
+\family typewriter
+Hunspell
+\family default
+ is the only available spell checker and should work without specifying
+ a directory.
+\end_layout
+
 \begin_layout Description
 PATH
 \begin_inset space ~
@@ -46120,7 +46648,25 @@ prefix This field contains a list of paths to external programs.
 
 Linux systems, the path list will need to be set only if there are external
  programs you wish to use that are not in your normal system path ($PATH).
+\end_layout
+
+\begin_layout Description
+TEXINPUTS
+\begin_inset space ~
+\end_inset
+
+prefix The TEXINPUTS environment variable allows to use external files which
+ are included to a LyX document via commands in TeX code.
+ This prefix includes by default the document directory (represented by
+ a single '.').
+ The prefix can be set to any list of paths separated by the default separator
+ of the OS (':' on UNIX like systems and ';' on windows).
+ If files are included by LaTeX, the paths listed in the TEXINPUTS prefix
+ will be scanned for the input files.
+ Note that any non-absolute path listed in the TEXINPUTS prefix is considered
+ to be relative to the directory of your LyX file.
+ It is recommended to include always the '.' as one of the paths, otherwise
+ compilation may fail for some documents.
 \end_layout
 
 \begin_layout Section
@@ -46189,12 +46735,9 @@ Interface
 \end_inset
 
 language Here you can select the language of LyX's menus.
- Unfortunately this doesn't work on Mac and Windows.
- It works on Linux for the languages into LyX's menus and dialogs are translated.
  You find the actual translation status here: 
 \begin_inset CommandInset href
 LatexCommand href
-name "http://www.lyx.org/I18n"
 target "http://www.lyx.org/I18n"
 
 \end_inset
@@ -46202,14 +46745,6 @@ target "http://www.lyx.org/I18n"
 
 \end_layout
 
-\begin_layout Description
-Default
-\begin_inset space ~
-\end_inset
-
-language is the language used in new documents
-\end_layout
-
 \begin_layout Description
 Language
 \begin_inset space ~
@@ -46282,19 +46817,6 @@ reference "sec:Language-encodings"
 .
 \end_layout
 
-\begin_layout Description
-Default
-\begin_inset space ~
-\end_inset
-
-Decimal
-\begin_inset space ~
-\end_inset
-
-Point Define the default decimal point for the use in tables (decimal point
- alignment)
-\end_layout
-
 \begin_layout Description
 Command
 \begin_inset space ~
@@ -46347,6 +46869,19 @@ Command start
  command toggles the package on and off.
 \end_layout
 
+\begin_layout Description
+Default
+\begin_inset space ~
+\end_inset
+
+Decimal
+\begin_inset space ~
+\end_inset
+
+Point Define the default decimal point for the use in tables (decimal point
+ alignment).
+\end_layout
+
 \begin_layout Description
 Set
 \begin_inset space ~
@@ -46479,142 +47014,40 @@ Outputs
 \end_layout
 
 \begin_layout Subsection
-Printer
-\begin_inset CommandInset label
-LatexCommand label
-name "sub:Printer"
-
-\end_inset
-
-
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-Printer
-\end_layout
-
-\end_inset
-
-
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-Settings ! Printer
-\end_layout
-
-\end_inset
-
-
+General
 \end_layout
 
 \begin_layout Description
-Default
+Output
 \begin_inset space ~
 \end_inset
 
-printer Here you can specify the name of your default printer.
- The name will be used when the 
-\family sans
-Printer command
-\family default
- is executed.
-\begin_inset Newline newline
-\end_inset
-
-
-\begin_inset Note Greyedout
-status open
-
-\begin_layout Plain Layout
-
-\series bold
-Note:
-\series default
- You can leave this field empty on Windows systems because it has no effect.
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Description
-Printer
+line
 \begin_inset space ~
 \end_inset
 
-command is the command LyX
-\begin_inset space \thinspace{}
-\end_inset
-
-/
-\begin_inset space \thinspace{}
-\end_inset
-
-LaTeX uses for printing.
- The default is on most systems 
+length sets the maximum number of characters printed in one line when using
+ the menu 
 \family sans
-dvips
-\family default
-.
-\end_layout
-
-\begin_layout Description
-Printer
-\begin_inset space ~
-\end_inset
-
-Command
+File\SpecialChar \menuseparator
+Export\SpecialChar \menuseparator
+Plain
 \begin_inset space ~
 \end_inset
 
-Options Here you can specify printer options.
- A list of printer options with explanations can be found in the documentation
- of the program that provides the 
-\family sans
-Printer command
+text
 \family default
- you are using.
+.
+ Setting the line line length to 0 means all text is printed in one endless
+ line.
 \end_layout
 
 \begin_layout Description
-Adapt
-\begin_inset space ~
-\end_inset
-
-output
-\begin_inset space ~
-\end_inset
-
-to
+Date
 \begin_inset space ~
 \end_inset
 
-printer This option works only for the 
-\family sans
-Printer command
-\family default
-\begin_inset Quotes eld
-\end_inset
-
-
-\family sans
-dvips
-\family default
-
-\begin_inset Quotes erd
-\end_inset
-
-.
- It activates a configuration file for dvips.
- This is an option only for dvips experts.
-\end_layout
-
-\begin_layout Subsection
-Date Format
+format
 \begin_inset Index idx
 status collapsed
 
@@ -46634,11 +47067,7 @@ Settings ! Date format
 
 \end_inset
 
-
-\end_layout
-
-\begin_layout Standard
-The date format can be one or a mixture of the formats listed here:
+ The date format can be one or a mixture of the formats listed here:
 \begin_inset Newline newline
 \end_inset
 
@@ -46668,47 +47097,181 @@ For example the format
 prints the date as day/month/year.
 \end_layout
 
-\begin_layout Subsection
-Plain Text
+\begin_layout Description
+Overwrite
+\begin_inset space ~
+\end_inset
+
+on
+\begin_inset space ~
+\end_inset
+
+export Setting what LyX is allowed to overwrite on export.
 \end_layout
 
 \begin_layout Description
-Output
+Forward
 \begin_inset space ~
 \end_inset
 
-line
+search Commands that will be used for the menu 
+\family sans
+Navigate\SpecialChar \menuseparator
+Forward
 \begin_inset space ~
 \end_inset
 
-length sets the maximum number of characters printed in one line when using
- the menu 
+search
+\family default
+.
+ For a detailed description see section 
+\emph on
+Reverse DVI/PDF search
+\emph default
+ of the 
+\emph on
+Additional
+\begin_inset space ~
+\end_inset
+
+Features
+\emph default
+ manual.
+\end_layout
+
+\begin_layout Subsection
+Printer
+\begin_inset CommandInset label
+LatexCommand label
+name "sub:Printer"
+
+\end_inset
+
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Printer
+\end_layout
+
+\end_inset
+
+
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+Settings ! Printer
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+Default
+\begin_inset space ~
+\end_inset
+
+printer Here you can specify the name of your default printer.
+ The name will be used when the 
 \family sans
-File\SpecialChar \menuseparator
-Export\SpecialChar \menuseparator
-Plain
+Printer command
+\family default
+ is executed.
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ You can leave this field empty on Windows systems because it has no effect.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+Printer
 \begin_inset space ~
 \end_inset
 
-text
+command is the command LyX
+\begin_inset space \thinspace{}
+\end_inset
+
+/
+\begin_inset space \thinspace{}
+\end_inset
+
+LaTeX uses for printing.
+ The default is on most systems 
+\family sans
+dvips
 \family default
 .
- Setting the line line length to 0 means all text is printed in one endless
- line.
 \end_layout
 
 \begin_layout Description
-roff
+Printer
 \begin_inset space ~
 \end_inset
 
-command defines an additional command used to produce better ASCII tables
- with the 
-\family typewriter
-groff/troff/nroff
+Command
+\begin_inset space ~
+\end_inset
+
+Options Here you can specify printer options.
+ A list of printer options with explanations can be found in the documentation
+ of the program that provides the 
+\family sans
+Printer command
 \family default
- UNIX-commands (refer to their manuals for more information about them).
- Setting this as empty tells LyX to use the internal formatter.
+ you are using.
+\end_layout
+
+\begin_layout Description
+Adapt
+\begin_inset space ~
+\end_inset
+
+output
+\begin_inset space ~
+\end_inset
+
+to
+\begin_inset space ~
+\end_inset
+
+printer This option works only for the 
+\family sans
+Printer command
+\family default
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+dvips
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ It activates a configuration file for dvips.
+ This is an option only for dvips experts.
 \end_layout
 
 \begin_layout Subsection
@@ -46829,65 +47392,42 @@ Default
  value depends on your LaTeX-system setup.
 \end_layout
 
-\begin_layout Standard
-You can also specify here commands with parameters for the listed applications.
- But before you change something, it is strongly recommended to read the
- manuals of the applications.
- Currently the following commands can be set:
-\end_layout
-
 \begin_layout Description
-CheckTe
-\begin_inset ERT
-status collapsed
-
-\begin_layout Plain Layout
+DVI
+\begin_inset space ~
+\end_inset
 
-{}
-\end_layout
+viewer
+\begin_inset space ~
+\end_inset
 
+paper
+\begin_inset space ~
 \end_inset
 
-X
+size
 \begin_inset space ~
 \end_inset
 
-command Command for the program 
+options They only have an effect when the program 
 \family sans
-CheckTeX
+xdvi
 \family default
- that is described in the section 
-\emph on
-Checking TeX
-\emph default
- of the 
-\emph on
-Additional Features
-\emph default
- manual.
+ is used as DVI-viewer, read its manual to find out more.
 \end_layout
 
-\begin_layout Description
-BibTe
-\begin_inset ERT
-status collapsed
-
-\begin_layout Plain Layout
-
-{}
+\begin_layout Standard
+You can also specify here options and commands with parameters for processors.
+ But before you change something, it is strongly recommended to read the
+ manuals of the applications.
 \end_layout
 
-\end_inset
-
-X
+\begin_layout Description
+Bibliography
 \begin_inset space ~
 \end_inset
 
-command Command for the program 
-\family sans
-BibTeX
-\family default
- that generates the bibliography, see section
+generation Settings for the generation of the bibliography, see section
 \begin_inset space ~
 \end_inset
 
@@ -46906,7 +47446,7 @@ Index
 \begin_inset space ~
 \end_inset
 
-command Command for the program that generates the index, see section
+generation Settings for the generation of the index, see section
 \begin_inset space ~
 \end_inset
 
@@ -46940,27 +47480,34 @@ reference "sub:Nomenclature-Program"
 \end_layout
 
 \begin_layout Description
-DVI
-\begin_inset space ~
-\end_inset
+CheckTe
+\begin_inset ERT
+status collapsed
 
-viewer
-\begin_inset space ~
-\end_inset
+\begin_layout Plain Layout
+
+{}
+\end_layout
 
-paper
-\begin_inset space ~
 \end_inset
 
-size
+X
 \begin_inset space ~
 \end_inset
 
-options They only have an effect when the program 
+command Command for the program 
 \family sans
-xdvi
+CheckTeX
 \family default
- is used as DVI-viewer.
+ that is described in the section 
+\emph on
+Checking TeX
+\emph default
+ of the 
+\emph on
+Additional Features
+\emph default
+ manual.
 \end_layout
 
 \begin_layout Standard
@@ -47210,51 +47757,26 @@ Here you find the list of defined file formats that LyX can handle.
 
 \begin_layout Standard
 Furthermore, you can define the 
-\begin_inset Quotes eld
-\end_inset
-
+\family sans
 Default output format
-\begin_inset Quotes erd
-\end_inset
-
- that is used when you hit 
-\begin_inset Quotes eld
-\end_inset
-
-View
-\begin_inset Quotes erd
-\end_inset
-
-, 
-\begin_inset Quotes eld
-\end_inset
-
-Update
-\begin_inset Quotes erd
-\end_inset
-
-, 
-\begin_inset Quotes eld
-\end_inset
-
-View Master Document
-\begin_inset Quotes erd
-\end_inset
-
- and 
-\begin_inset Quotes eld
-\end_inset
-
+\family default
+ that is used when you use 
+\family sans
+View, Update, View Master Document
+\family default
+ or 
+\family sans
 Update Master Document
-\begin_inset Quotes erd
-\end_inset
-
- in the Edit menu or the toolbar.
+\family default
+ in the 
+\family sans
+View
+\family default
+ menu or the toolbar.
 \end_layout
 
 \begin_layout Standard
-More about formats, like the options that can be used in the format definition,
- is described in the section 
+More about formats and their options is described in the section 
 \emph on
 Formats
 \emph default