]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
Change the LaTeXBuiltin tag to a NeedsFloatPkg tag. Discussion on the
[lyx.git] / lib / doc / UserGuide.lyx
index f5b09dca9d1f12b62ac4211f3357710c2a8ce61f..28d5a8ae06a1a04bb1228e97db3108f3b2e6e38d 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 375
+\lyxformat 378
 \begin_document
 \begin_header
 \textclass scrbook
@@ -56,6 +56,7 @@
 \end_preamble
 \options intoc,bibtotoc,idxtotoc,BCOR7mm,tablecaptionabove
 \use_default_options false
+\maintain_unincluded_children false
 \language english
 \inputencoding auto
 \fontencoding global
 \papercolumns 1
 \papersides 2
 \paperpagestyle default
-\tracking_changes true
+\tracking_changes false
 \output_changes false
 \html_use_mathml true
 \html_be_strict true
-\author 1 "Richard Heck" 
 \end_header
 
 \begin_body
@@ -307,7 +307,7 @@ Like most applications, LyX has the familiar menu bar across the top of
 \end_layout
 
 \begin_layout Standard
-Note that there is no horizontal scroll bar.
+Note that there is no horizontal scrollbar.
  This is not a bug or an oversight, but intentional.
  When you read a book, you expect the end of a line to wrap around to the
  next line.
@@ -2376,9 +2376,10 @@ Letter for US-style letters
 
 \begin_layout Standard
 There are also some non-standard classes, which LyX only uses if you have
- installed them.
- Here are some of the classes, the full list with detailed explanations
- can be found in chapter 
+ installed the corresponding LaTeX class files, though most LaTeX distributions
+ will include many of these.
+ Here are some of the classes.
+ The full list with detailed explanations can be found in chapter 
 \emph on
 Special Document Classes
 \emph default
@@ -2497,7 +2498,7 @@ Kluwer Layout for journals of the Kluwer publishing group
 \end_layout
 
 \begin_layout Description
-koma-script a replacement for the standard classes, offers many useful features
+KOMA-Script a replacement for the standard classes, offers many useful features
  like caption formatting, automatic print space calculation etc.
 \end_layout
 
@@ -2596,8 +2597,7 @@ Document ! Modules
 \begin_layout Standard
 Modules load additional features to a document that are not by default available
  in the chosen document class.
- For example you might want to use write Braille (embossed printing) in
- a document.
+ For example you might want to write Braille (embossed printing) in a document.
  This is of course not available in any document class, so you have to load
  the corresponding module in the 
 \family sans
@@ -2651,6 +2651,7 @@ status open
 Note also:
 \series default
  Some modules require other modules, and some pairs of modules are incompatible.
+ LyX will advise you about these things.
 \end_layout
 
 \end_inset
@@ -3572,8 +3573,8 @@ Document ! Settings
 \end_layout
 
 \begin_layout Standard
-If you use a koma-script document class, you can use the default settings.
- Because koma-script calculates then the printspace automatically by taking
+If you use a KOMA-Script document class, you can use the default settings.
+ Because KOMA-Script calculates then the printspace automatically by taking
  the paper format and the font size into account.
 \end_layout
 
@@ -3588,16 +3589,23 @@ everything
 \emph default
  into the new class.
  That includes the paragraph environments.
- Some paragraph environments are standard; all of the document classes have
- them; but some classes have special paragraph environments.
- If this is the case, and you change the document class, LyX sets the missing
- paragraph environments to 
-\family sans
-Standard
-\family default
- and places an error box at the beginning of the paragraph.
- Just click on them and you'll get a message dialog that tells you about
- the conversion and why it failed.
+ Some paragraph environments are standard, in so far as all of the document
+ classes have them; but some classes have special paragraph environments.
+ If this is the case, and you change the document class, LyX will mark the
+ paragraphs whose styles it no longer understands as 
+\begin_inset Quotes eld
+\end_inset
+
+unknown
+\begin_inset Quotes erd
+\end_inset
+
+.
+ The name of the style is retained, in case you should want to go back to
+ the old class.
+ But these paragraphs will be output with no special formatting, so you
+ will either need to create a new style yourself or else to convert these
+ paragraphs manually to a style present in your new document class.
 \end_layout
 
 \begin_layout Section
@@ -4139,7 +4147,7 @@ Document Title
 status collapsed
 
 \begin_layout Plain Layout
-Document !Title
+Document ! Title
 \end_layout
 
 \end_inset
@@ -10881,8 +10889,8 @@ cm
 \family typewriter
 ec
 \family default
- are bitmap fonts, they often looks pixeled in PDF output, especially when
- you read the PDF in a zoomed size.
+ are bitmap fonts, they often looks pixelated in PDF output, especially
when you read the PDF in a zoomed size.
 \begin_inset Foot
 status collapsed
 
@@ -10901,7 +10909,7 @@ Reader
 
 \end_inset
 
- To get rid of pixeled fonts, you have to use a vector font.
+ To get rid of pixelated fonts, you have to use a vector font.
  There are three ways to use one:
 \end_layout
 
@@ -12722,7 +12730,7 @@ device-independent
 \end_layout
 
 \begin_layout Standard
-DVI files doen't contain images, they only link them.
+DVI files do not contain images, they only link them.
  So don't forget to deliver the images together with your DVIs.
  Because the DVI-viewer has to convert the image in the background to make
  it visible when you scroll the DVI, this can slow down your computer when
@@ -13052,21 +13060,15 @@ pdftex
 dvipdfm
 \family default
  is no longer under development and therefore a bit outdated.
-\change_inserted 1 1262887469
-
 \end_layout
 
 \begin_layout Subsubsection
-
-\change_inserted 1 1262887469
 XHTML
 \begin_inset Index idx
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted 1 1262887469
-FileFormats! XHTML
+FileFormats ! XHTML
 \end_layout
 
 \end_inset
@@ -13076,8 +13078,6 @@ FileFormats! XHTML
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted 1 1262887469
 HTML
 \end_layout
 
@@ -13087,8 +13087,6 @@ HTML
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted 1 1262888147
 This file type has the extension 
 \begin_inset Quotes eld
 \end_inset
@@ -13106,28 +13104,36 @@ 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.
 \end_layout
 
 \begin_layout Standard
+XHTML output remains 
+\begin_inset Quotes eld
+\end_inset
 
-\change_inserted 1 1262888092
-As of this writing, LyX's `native' XHTML output remains somewhat `experimental',
- and not all LyX features work properly.
- It is our hope, however, that native output will solve many of the problems
- users have encountered when using third-party LyX- or LaTeX-to-HTML converters.
-\end_layout
+under development
+\begin_inset Quotes erd
+\end_inset
 
-\begin_layout Standard
+, and not all LyX features are supported yet.
+ See the chapter 
+\begin_inset Quotes eld
+\end_inset
 
-\change_inserted 1 1262888116
-Math is output as MathML, which renders nicely in browsers that support
- it, but not all do.
- Eventually, we will offer the option of instead outputing math as images.
+LyX and the World Wide Web
+\begin_inset Quotes erd
+\end_inset
+
+, in the 
+\emph on
+Additional Features
+\emph default
+ manual, for more information.
 \end_layout
 
 \begin_layout Standard
-
-\change_inserted 1 1262888178
 You can export your document as an XHTML file using the menu item 
 \family sans
 File\SpecialChar \menuseparator
@@ -13135,8 +13141,6 @@ Export\SpecialChar \menuseparator
 LyXHTML
 \family default
 .
-\change_unchanged
-
 \end_layout
 
 \begin_layout Subsection
@@ -15671,7 +15675,7 @@ reference "sub:Output-file-formats"
 , every output document format allows only a few image formats.
  LyX uses therefore the program 
 \family typewriter
-Imagemagick
+ImageMagick
 \family default
  in the background to convert the images to the right format.
  To increase your workflow by avoiding these conversions in the background,
@@ -15699,7 +15703,7 @@ Bitmap
 \end_inset
 
 images consist of pixel values, often in a compressed form.
- They are therefore not fully scalable and look pixeled in large zooms.
+ They are therefore not fully scalable and look pixelated in large zooms.
  Well-known bitmap image formats are 
 \begin_inset Quotes eld
 \end_inset
@@ -19051,7 +19055,7 @@ To have multi-line entries in table cells, you have to declare a fixed width
 \bar no
 \noun off
 \color none
-This is a multiline entry in a table.
+This is a multi-line entry in a table.
 \end_layout
 
 \end_inset
@@ -19163,7 +19167,7 @@ This is longer now.
 \bar no
 \noun off
 \color none
-This is a multiline entry in a table.
+This is a multi-line entry in a table.
  This is longer now.
 \end_layout
 
@@ -20337,7 +20341,7 @@ sideways
 
 \begin_layout Standard
 Rotated floats are always placed on their own pages (or columns, when you
- have a multi-column document).
+ have a multicolumn document).
  You can let them span several columns using the float settings option 
 \family sans
 Span
@@ -25168,7 +25172,7 @@ reference "sub:Biblio_environment"
 
 .
  If you want anything other than numerical citations that are used in this
- document, like author-year cituations, then you must
+ document, like author-year citations, then you must
 \emph on
  
 \emph default
@@ -26537,7 +26541,7 @@ key "makeindex,xindy"
 
 \begin_layout Standard
 If you need specific options or an alternative index program only for a
- given document, you can define the programm and\SpecialChar \slash{}
+ given document, you can define the program and\SpecialChar \slash{}
 or the options in 
 \family sans
 Document\SpecialChar \menuseparator
@@ -28301,7 +28305,7 @@ Note that some document classes have built-in solutions for well known problems
  like your case.
  For example if you use a 
 \family sans
-koma-script
+KOMA-Script
 \family default
  class, you don't need the package 
 \series bold
@@ -28588,13 +28592,18 @@ aspell
 \family typewriter
 ispell
 \family default
-, so that it is recommended to use aspell.
+, and contrary to 
+\family typewriter
+ispell
+\family default
+, it supports multiple languages in parallel, so it is recommended to use
+ aspell.
  
 \family typewriter
 hspell
 \family default
  is a Hebrew spell-checker.
- The used spell checker ind its settings are specified in LyX's preferences
+ The used spell checker and its settings are specified in LyX's preferences
  under 
 \family sans
 Language Settings
@@ -34720,9 +34729,8 @@ You can export your document to various file formats.
 \end_layout
 
 \begin_layout Standard
-Here is a list of all available entries
-\change_deleted 1 1262887786
-; they are explained in detail in section
+Here is a list of all available entries; some of them are explained in detail
+ in section
 \begin_inset space ~
 \end_inset
 
@@ -34734,10 +34742,6 @@ reference "sub:Output-file-formats"
 \end_inset
 
 :
-\change_inserted 1 1262887786
-:
-\change_unchanged
-
 \end_layout
 
 \begin_layout Description
@@ -34751,24 +34755,10 @@ LyX
 \family default
 format of the special LyX 1.4.x versions for Chinese, Japanese, and Korean
  (CJK)
-\change_deleted 1 1262887560
-;
-\change_inserted 1 1262887561
-
 \begin_inset Newline newline
 \end_inset
 
-
-\change_unchanged
-\change_deleted 1 1262887562
-(
-\change_unchanged
-Since LyX 1.5.0 CJK support is fully integrated to LyX.
-\change_deleted 1 1262887564
-)
-\change_unchanged
-
+ Since LyX 1.5.0 CJK support is fully integrated to LyX.
 \end_layout
 
 \begin_layout Description
@@ -34777,61 +34767,11 @@ Since LyX 1.5.0 CJK support is fully integrated to LyX.
 DVI
 \family default
  DVI-format
-\change_inserted 1 1262887797
- (see 
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
 \end_layout
 
 \begin_layout Description
-HTML HTML-format
-\change_inserted 1 1262887568
-
-\begin_inset Newline newline
-\end_inset
-
-
-\change_deleted 1 1262887572
- (t
-\change_inserted 1 1262887573
-T
-\change_unchanged
-he HTML
-\change_inserted 1 1262887602
-\change_deleted 1 1262887603
--
-\change_unchanged
-conver
-\change_inserted 1 1262887606
-sion
-\change_deleted 1 1262887609
-ter
-\change_unchanged
- is 
-\change_inserted 1 1262887612
-performed by 
-\change_unchanged
-a third-party product and 
-\change_inserted 1 1262887674
-may 
-\change_deleted 1 1262887617
-doesn't 
-\change_unchanged
-work in all cases
-\change_inserted 1 1262887618
-.
-\change_deleted 1 1262887618
-)
-\change_unchanged
-
+HTML HTML-format (the HTML-converter is a third-party product and may not
+ work in all cases)
 \end_layout
 
 \begin_layout Description
 \end_inset
 
  is replaced by the version number)
-\change_inserted 1 1262887695
-
 \end_layout
 
 \begin_layout Description
-
-\change_inserted 1 1262887844
-LyXHTML HTML-format, using LyX's internal XHTML engine (see 
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
+LyXHTML HTML-format, using LyX's internal XHTML engine
 \end_layout
 
 \begin_layout Description
@@ -34959,46 +34886,8 @@ KOffice
 Abiword
 \family default
 , etc.
-\change_inserted 1 1262887646
-
-\begin_inset Newline newline
-\end_inset
-
-
-\change_deleted 1 1262887649
- (t
-\change_inserted 1 1262887649
-T
-\change_unchanged
-he OpenDocument
-\change_inserted 1 1262887652
-\change_deleted 1 1262887652
--
-\change_unchanged
-conver
-\change_inserted 1 1262887656
-sion
-\change_deleted 1 1262887654
-ter
-\change_unchanged
- is 
-\change_inserted 1 1262887659
-performed by 
-\change_unchanged
-a third-party product and 
-\change_inserted 1 1262887665
-may not 
-\change_deleted 1 1262887667
-doesn't 
-\change_unchanged
-work in all cases
-\change_inserted 1 1262887669
-.
-\change_deleted 1 1262887670
-)
-\change_unchanged
-
+ (The OpenDocument-converter is a third-party product and may not work in
+ all cases)
 \end_layout
 
 \begin_layout Description
@@ -35013,19 +34902,6 @@ PDF
  PDF-format using the program 
 \family typewriter
 dvipdfm
-\change_inserted 1 1262887911
-\family default
-(see 
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
 \end_layout
 
 \begin_layout Description
@@ -35040,19 +34916,6 @@ PDF
  PDF-format using the program 
 \family typewriter
 pdflatex
-\change_inserted 1 1262887913
-\family default
-(see 
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
 \end_layout
 
 \begin_layout Description
@@ -35067,19 +34930,6 @@ PDF
  PDF-format using the program 
 \family typewriter
 ps2pdf
-\change_inserted 1 1262887914
-\family default
-(see 
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
 \end_layout
 
 \begin_layout Description
@@ -35121,19 +34971,6 @@ Postscript
  PostScript format using the program 
 \family typewriter
 dvips
-\change_inserted 1 1262887921
-\family default
-(see 
-\begin_inset CommandInset ref
-LatexCommand prettyref
-reference "sub:Output-file-formats"
-
-\end_inset
-
-)
-\change_unchanged
-
 \end_layout
 
 \begin_layout Description
@@ -44693,8 +44530,6 @@ The above bibliography is created from a BibTeX-database.
 \end_layout
 
 \begin_layout Standard
-
-\series bold
 \begin_inset CommandInset nomencl_print
 LatexCommand printnomenclature
 set_width "none"