revert broken changeset 15036

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

diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx
index bdff7f2f6dfaf79ea7c63d90776464687748e713..31691bf381e27e35c249608f8e1d48d5c777774d 100644 (file)
--- a/lib/doc/UserGuide.lyx
+++ b/lib/doc/UserGuide.lyx
@@ -1,4 +1,4 @@
-#LyX 1.4.0cvs created this file. For more info see http://www.lyx.org/
+#LyX 1.4.2svn created this file. For more info see http://www.lyx.org/

 \lyxformat 245
 \begin_document
 \begin_header
 \lyxformat 245
 \begin_document
 \begin_header


@@ -4761,6 +4761,7 @@ If you are in one of these environments:
 status collapsed
 
 \begin_layout Standard
 status collapsed
 
 \begin_layout Standard

+

  
 \end_layout
 
  
 \end_layout
 


@@ -4775,6 +4776,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 vspace{-2ex} 
 \backslash
 \backslash
 vspace{-2ex} 
 \backslash


@@ -4803,6 +4805,7 @@ Quotation
 status collapsed
 
 \begin_layout Standard
 status collapsed
 
 \begin_layout Standard

+

 }
 \backslash
 parbox[t]{3cm}{
 }
 \backslash
 parbox[t]{3cm}{


@@ -4830,6 +4833,7 @@ Itemize
 status collapsed
 
 \begin_layout Standard
 status collapsed
 
 \begin_layout Standard

+

 }
 \backslash
 parbox[t]{3cm}{
 }
 \backslash
 parbox[t]{3cm}{


@@ -4857,6 +4861,7 @@ Description
 status collapsed
 
 \begin_layout Standard
 status collapsed
 
 \begin_layout Standard

+

 }
 \backslash
 parbox[t]{3cm}{
 }
 \backslash
 parbox[t]{3cm}{


@@ -4878,6 +4883,7 @@ List
 status collapsed
 
 \begin_layout Standard
 status collapsed
 
 \begin_layout Standard

+

 }
 \end_layout
 
 }
 \end_layout
 


@@ -6420,6 +6426,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 linebreak 
 \end_layout
 \backslash
 linebreak 
 \end_layout


@@ -8065,17 +8072,6 @@ LyX-Code
  text as if you used a typewriter.
 \end_layout
 
  text as if you used a typewriter.
 \end_layout
 

-\begin_layout Subsubsection
-Comment
-\end_layout
-
-\begin_layout Standard
-The comment paragraph environment can be used to write comments about your
- document that will not appear in the final output.
- In order to make this clear, LyX will present the comment environment in
- a different color than the rest of the text.
-\end_layout
-

 \begin_layout Section
 Nesting Environments
 \begin_inset LatexCommand \label{sec:nest}
 \begin_layout Section
 Nesting Environments
 \begin_inset LatexCommand \label{sec:nest}


@@ -10211,29 +10207,24 @@ S
 ettings
 \family default
  dialog.
 ettings
 \family default
  dialog.

- There are two options of interest here, 
+ The 

 \family sans
 \family sans

-\bar under
-F
-\bar default
-onts
+Fonts
+\family default
+ tabfolder/pane offers you a variety of possibilities to set up and adjust
+ your document fonts.
+ The most important ones are those in the 
+\family sans
+Font Families

 \family default
  and 
 \family sans
 \family default
  and 
 \family sans

-Font\InsetSpace ~
-
-\bar under
-S
-\bar default
-ize
+Font Sizes

 \family default
 \family default

-.
+ group.

  The possible options under 
 \family sans
  The possible options under 
 \family sans

-\bar under
-F
-\bar default
-onts
+Font Families

 \family default
  include 
 \begin_inset Quotes eld
 \family default
  include 
 \begin_inset Quotes eld


@@ -10241,26 +10232,52 @@ onts
 
 
 \family sans
 
 
 \family sans

-default
+Default

 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 

- and a list of fonts available on your system.
+ and a list of fonts available on your system, each for the 
+\family sans
+\bar under
+R
+\bar default
+oman
+\family default
+, 
+\family sans
+\bar under
+S
+\bar default
+ans Serif
+\family default
+ and 
+\family sans
+T
+\bar under
+y
+\bar default
+pewriter
+\family default
+ (a.\InsetSpace \thinspace{}
+k.\InsetSpace \thinspace{}
+a.
+ Monospaced) family of fonts.

  The option 
 \begin_inset Quotes eld
 \end_inset
 
 
 \family sans
  The option 
 \begin_inset Quotes eld
 \end_inset
 
 
 \family sans

-default
+Default

 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 

- uses the standard TeX fonts, known as 
+ uses the fonts that are specified by the document class you are using.
+ Often, these are the standard TeX fonts, known as 

 \begin_inset Quotes eld
 \end_inset
 
 \begin_inset Quotes eld
 \end_inset
 


@@ -10277,24 +10294,125 @@ European modern
 \end_inset
 
  (ec).
 \end_inset
 
  (ec).

- Most systems will typically have some version of a Times and Helvetica
- font, with other variants.
- You'll have to examine this for yourself.
+ Depending on the document class, however, it might as well be another font.
+ Most fonts in the list should be installed on your system.
+ For others, you might have to get and install the fonts first (LyX indicates
+ if a font is not installed).
+ Please have a look at 
+\family sans
+\bar under
+H
+\bar default
+elp\SpecialChar \menuseparator
+
+\bar under
+L
+\bar default
+aTeX Configuration 
+\family default
+about where to get the fonts.
+ Installing a new font for LaTeX is, unfortunately, not as easy as installing
+ a new font to common operation systems.
+ However, most font packages include a step-by-step instruction.
+\end_layout
+
+\begin_layout Standard
+In most cases, the default family of a document class is roman (a.\InsetSpace \thinspace{}
+k.\InsetSpace \thinspace{}
+a.
+ serif), so the roman font (e.\InsetSpace \thinspace{}
+g.
+ Times) will be used all over, unless you select 
+\begin_inset Quotes eld
+\end_inset
+
+Sans Serif
+\begin_inset Quotes erd
+\end_inset
+
+ od 
+\begin_inset Quotes eld
+\end_inset
+
+Typewriter
+\begin_inset Quotes erd
+\end_inset
+
+ from 
+\family sans
+\bar under
+E
+\bar default
+dit\SpecialChar \menuseparator
+Text St
+\bar under
+y
+\bar default
+le 
+\family default
+for specific selections of the text (see below section 
+\begin_inset LatexCommand \ref{sub:Text-Style-Dialog}
+
+\end_inset
+
+).
+
+\family sans
+ 
+\family default
+The 
+\family sans
+Default\InsetSpace ~
+Family
+\family default
+ option lets you change this.
+ So if you want your document (including footnotes etc.), say, all over in
+ Helvetica, chose 
+\begin_inset Quotes eld
+\end_inset
+
+Helvetica
+\begin_inset Quotes erd
+\end_inset
+
+ as 
+\family sans
+Sans Serif
+\family default
+ Font and 
+\begin_inset Quotes eld
+\end_inset
+
+Sans Serif
+\begin_inset Quotes erd
+\end_inset
+
+ as 
+\family sans
+Default\InsetSpace ~
+Family
+\family default
+.

 \end_layout
 
 \begin_layout Standard
 \end_layout
 
 \begin_layout Standard

-As for the 
+In the 

 \family sans
 Font\InsetSpace ~
 
 \bar under
 S
 \bar default
 \family sans
 Font\InsetSpace ~
 
 \bar under
 S
 \bar default

-ize
+izes

 \family default
 \family default

- option, there are three possible values: 
+ group, you can usually select from four possible 

 \family sans
 \family sans

-10
+Base\InsetSpace ~
+Size
+\family default
+ values: 
+\family sans
+default, 10

 \family default
 , 
 \family sans
 \family default
 , 
 \family sans


@@ -10304,7 +10422,7 @@ ize
 \family sans
 12
 \family default
 \family sans
 12
 \family default

-.
+ (some document classes provide more, some less choices).

  Remember, this is the 
 \emph on
 base
  Remember, this is the 
 \emph on
 base


@@ -10319,7 +10437,76 @@ base
 \end_layout
 
 \begin_layout Standard
 \end_layout
 
 \begin_layout Standard

-Note that once you choose a new value for 
+Some Sans Serif and Typewriter Fonts provide the possibility to be scaled.
+ This might be useful, if a Sans Serif or Typewriter Font has a different
+ height than the Roman Font.
+ Please be careful with this option, it can be easily misused.
+\end_layout
+
+\begin_layout Standard
+In the 
+\family sans
+Advanced Options
+\family default
+ group box, you'll finally find possibilities for using so-called 
+\begin_inset Quotes eld
+\end_inset
+
+expert settings
+\begin_inset Quotes erd
+\end_inset
+
+, given that they are provided by a certain font.
+ 
+\family sans
+Use true S
+\bar under
+m
+\bar default
+all Caps
+\family default
+ indicates that lots of fonts do not use real, but 
+\emph on
+faked
+\emph default
+ Small Caps.
+ True Small Caps are specifically designed characters, whereas faked Small
+ Caps are just scaled Capital letters.
+ The former looks way better, so if a font offers you the choice, you should
+ check this option.
+ 
+\family sans
+Use 
+\bar under
+O
+\bar default
+ld Style Figures
+\family default
+ finally lets you select so called Old Style Figures (a.\InsetSpace \thinspace{}
+k.\InsetSpace \thinspace{}
+a.
+ Medieval Figures, i.\InsetSpace \thinspace{}
+e.
+ figures with ascending or descending form) instead of the standard Lining
+ Figures.
+ Old Style Figures are often preferred due to better legibility in the text,
+ but it's certainly also a matter of taste.
+ Just try it out, if it is provided for your font of choice.
+ Note that math figures are 
+\emph on
+not
+\emph default
+ affected by this choice.
+\end_layout
+
+\begin_layout Standard
+Please note that even if LyX tries its best in guessing what fonts are installed
+ and which options are provided by a given font, it might fail if the fonts
+ are not set up correctly.
+\end_layout
+
+\begin_layout Standard
+Note further that once you choose a new value for 

 \family sans
 \bar under
 F
 \family sans
 \bar under
 F


@@ -10342,8 +10529,29 @@ not
  change the screen.
  You'll only see a difference once you generate the final output.
  This is part of the WYSIWYM concept.
  change the screen.
  You'll only see a difference once you generate the final output.
  This is part of the WYSIWYM concept.

- Besides, you have certainly noticed that "Roman" text on the LyX screen
- corresponds to the default font.
+ The only visible change is caused by a change of the default font family.
+ However, you certainly noticed that, for instance, the roman font on screen
+ is just a representation of 
+\begin_inset Quotes eld
+\end_inset
+
+Roman
+\begin_inset Quotes erd
+\end_inset
+
+ (as set up in the 
+\family sans
+\bar under
+T
+\bar default
+ools\SpecialChar \menuseparator
+
+\bar under
+P
+\bar default
+references
+\family default
+ dialog), not of the actual roman document font.

 \end_layout
 
 \begin_layout Subsection
 \end_layout
 
 \begin_layout Subsection


@@ -10495,6 +10703,11 @@ Fine-Tuning with the
 Character Layout
 \family default
  dialog
 Character Layout
 \family default
  dialog

+\begin_inset LatexCommand \label{sub:Text-Style-Dialog}
+
+\end_inset
+
+

 \end_layout
 
 \begin_layout Standard
 \end_layout
 
 \begin_layout Standard


@@ -12019,6 +12232,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 /
 \end_layout
 \backslash
 /
 \end_layout


@@ -12051,6 +12265,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 /
 \end_layout
 \backslash
 /
 \end_layout


@@ -12063,6 +12278,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 /
 \end_layout
 \backslash
 /
 \end_layout


@@ -19780,9 +19996,15 @@ cases
  and commutative diagrams.
  Not all of these are supported in LyX but some are, see 
 \family sans
  and commutative diagrams.
  Not all of these are supported in LyX but some are, see 
 \family sans

-Insert\SpecialChar \menuseparator
-Math
+\bar under
+I
+\bar default
+nsert\SpecialChar \menuseparator
+Mat
+\bar under
+h

 \family default
 \family default

+\bar default

 .
 \end_layout
 
 .
 \end_layout
 


@@ -24334,6 +24556,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 textcent
 \end_layout
 \backslash
 textcent
 \end_layout


@@ -24867,6 +25090,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 textcurrency
 \end_layout
 \backslash
 textcurrency
 \end_layout


@@ -25140,6 +25364,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 textyen
 \end_layout
 \backslash
 textyen
 \end_layout


@@ -25413,6 +25638,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 textbrokenbar
 \end_layout
 \backslash
 textbrokenbar
 \end_layout


@@ -27248,6 +27474,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 textendash
 \end_layout
 \backslash
 textendash
 \end_layout


@@ -28441,6 +28668,7 @@ status collapsed
 
 \begin_layout Standard
 
 
 \begin_layout Standard
 

+

 \backslash
 href{http://www.lyx.org/about/credits.php}{
 \end_layout
 \backslash
 href{http://www.lyx.org/about/credits.php}{
 \end_layout


@@ -28456,6 +28684,7 @@ CREDITS
 status collapsed
 
 \begin_layout Standard
 status collapsed
 
 \begin_layout Standard

+

 }
 \end_layout
 
 }
 \end_layout