- UserGuide.lyx: fine-grain description of BibTeX variants; correct description of...

[lyx.git] / lib / doc / UserGuide.lyx

diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx
index 25de08286dc509871d8350fbfb95300297a23470..79de18dcfdbc83f8f632d6c468a17e64f8d51684 100644 (file)
--- a/lib/doc/UserGuide.lyx
+++ b/lib/doc/UserGuide.lyx
@@ -14904,8 +14904,25 @@ This file type has the extension
  It does not itself contain images and the like but only links them, and
  when LyX produces XHTML, it also generates corresponding images in formats
  suitable for the purpose.
- Math is output as MathML, which renders nicely in browsers that support
- it, but not all do.
+ For the math output you can choose in the menu 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Output
+\family default
+ between different formats, that are described in section 
+\emph on
+Math Output in XHTML
+\emph default
+ of the 
+\emph on
+Additional
+\begin_inset space ~
+\end_inset
+
+Features
+\emph default
+ manual.
 \end_layout
 
 \begin_layout Standard
@@ -14919,13 +14936,9 @@ under development
 
 , and not all LyX features are supported yet.
  See the chapter 
-\begin_inset Quotes eld
-\end_inset
-
+\emph on
 LyX and the World Wide Web
-\begin_inset Quotes erd
-\end_inset
-
+\emph default
 , in the 
 \emph on
 Additional Features
@@ -26617,10 +26630,14 @@ Inserting a citation reference works as described in the previous section.
 
 \begin_layout Standard
 To generate the bibliography from a database, LyX uses the program BibTeX.
- This program can be controlled with options that you can add in LyX's preferenc
-es dialog under 
+ You can choose which of its variants should be used by LyX as processor;
+ either in the document settings under 
 \family sans
-Outputs\SpecialChar \menuseparator
+Bibliography
+\family default
+ or in LyX's preferences under 
+\family sans
+Output\SpecialChar \menuseparator
 LaT
 \begin_inset ERT
 status collapsed
@@ -26634,26 +26651,52 @@ status collapsed
 
 eX
 \family default
- in the 
-\family sans
-BibT
-\begin_inset ERT
-status collapsed
-
-\begin_layout Plain Layout
-
-{}
+.
+ The following variants are possible:
 \end_layout
 
+\begin_layout Description
+biber provides full Unicode support, unlimited memory, does not work with
+ other bibliography packages (like e.
+\begin_inset space \thinspace{}
 \end_inset
 
-eX
+g.
 \begin_inset space ~
 \end_inset
 
-command
+
+\series bold
+natbib
+\series default
+), only with the package 
+\series bold
+biblatex
+\series default
+; recommended for multilingual texts and for languages that don't use Latin
+ letters
+\end_layout
+
+\begin_layout Description
+bibtex the standard; does not allow special characters in bibliography entries
+ that are not possible to encode in a 7-bit encoding, limited memory, works
+ with all bibliography packages, except of 
+\series bold
+biblatex
+\end_layout
+
+\begin_layout Description
+bibtex8 allows all characters that are possible to encode in a 8-bit encoding,
+ larger memory than 
+\family sans
+bibtex
 \family default
- field.
+, works with all.bibliography packages
+\end_layout
+
+\begin_layout Standard
+BibTeX can be controlled with options that you can add below the specification
+ of the variants.
  Before adding options, it is strongly recommended to read the manual of
  
 \family sans
@@ -37640,7 +37683,23 @@ eX) DVI-format using the program
 \family typewriter
 LuaTeX
 \family default
-; supports Unicode and the usage of non-TeX fonts
+; supports Unicode and the usage of non-TeX fonts; 
+\series bold
+
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Note:
+\series default
+ not all DVI-viewers are currently able to display this output format properly.
+\end_layout
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Description
@@ -43148,17 +43207,27 @@ LaTeX-packages ! babel
 \end_layout
 
 \begin_layout Description
-Automatic 
-\begin_inset Note Note
-status open
+Automatic selects the most suitable language package for the view/export
+ format you will use.
+ For example for the XeTeX formats the package 
+\series bold
+polyglossia
+\series default
+
+\begin_inset Index idx
+status collapsed
 
 \begin_layout Plain Layout
-TODO
+LaTeX-packages ! polyglossia
 \end_layout
 
 \end_inset
 
-??
+ will be used instead of 
+\series bold
+babel
+\series default
+.
 \end_layout
 
 \begin_layout Description
@@ -43175,26 +43244,11 @@ babel
 
 \begin_layout Description
 Custom allows you to specify a language package command of your choice.
- For example, if you want to use XeTeX and therefore want to the package
- 
-\series bold
-polyglossia
-\series default
-
-\begin_inset Index idx
-status collapsed
-
-\begin_layout Plain Layout
-LaTeX-packages ! polyglossia
-\end_layout
-
-\end_inset
-
- instead of 
+ For example if you want to use a language-specific package like 
 \series bold
-babel
+ngerman
 \series default
-, type in
+ (for German texts), type in
 \series bold
 
 \begin_inset Newline newline
@@ -43202,7 +43256,7 @@ babel
 
 
 \backslash
-usepackage{polyglossia}
+usepackage{ngerman}
 \end_layout
 
 \begin_layout Description