]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Customization.lyx
Fix bug 5412 by updating docs.
[lyx.git] / lib / doc / Customization.lyx
index 4a8b2a8fa133c486cc3fe69a259cad0df27bd8b9..ee6d62440970527b97b67c1a84763713a36eaceb 100644 (file)
@@ -1,14 +1,14 @@
 #LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 348
+\lyxformat 371
 \begin_document
 \begin_header
 \textclass scrbook
 \begin_preamble
 % DO NOT ALTER THIS PREAMBLE!!!
 %
-% This preamble is designed to ensure that the User's Guide prints
+% This preamble is designed to ensure that this document prints
 % out as advertised. If you mess with this preamble,
-% parts of the User's Guide may not print out as expected.  If you
+% parts of this document may not print out as expected.  If you
 % have problems LaTeXing this file, please contact 
 % the documentation team
 % email: lyx-docs@lists.lyx.org
@@ -66,12 +66,16 @@ End
 \font_sans default
 \font_typewriter default
 \font_default_family default
+\use_xetex false
 \font_sc false
 \font_osf false
 \font_sf_scale 100
 \font_tt_scale 100
 
 \graphics default
+\default_output_format default
+\bibtex_command default
+\index_command default
 \paperfontsize 12
 \spacing single
 \use_hyperref true
@@ -93,26 +97,31 @@ End
 \use_geometry false
 \use_amsmath 0
 \use_esint 0
+\use_mhchem 1
 \cite_engine basic
 \use_bibtopic false
+\use_indices false
 \paperorientation portrait
+\suppress_date false
 \branch OutDated
 \selected 0
+\filename_suffix 0
 \color #f5fae7
 \end_branch
+\index Index
+\shortcut idx
+\color #008000
+\end_index
 \secnumdepth 3
 \tocdepth 3
 \paragraph_separation indent
-\defskip medskip
+\paragraph_indentation default
 \quotes_language english
 \papercolumns 1
 \papersides 2
 \paperpagestyle headings
 \tracking_changes false
 \output_changes false
-\author "" 
-\author "" 
-\author "" 
 \end_header
 
 \begin_body
@@ -616,7 +625,7 @@ xx
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "chap:i18n"
+reference "cha:Internationalizing-LyX"
 
 \end_inset
 
@@ -693,7 +702,7 @@ kbd/
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:keymap"
+reference "sec:International-Keymap-Stuff"
 
 \end_inset
 
@@ -718,7 +727,7 @@ layouts/
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "chap:textclass"
+reference "cha:Installing-New-Document"
 
 \end_inset
 
@@ -798,7 +807,7 @@ templates/
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:templates"
+reference "sec:Creating-Templates"
 
 \end_inset
 
@@ -1274,142 +1283,14 @@ User's Guide
 \end_layout
 
 \begin_layout Section
-Using the dialog for the first time
-\end_layout
-
-\begin_layout Standard
-The 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-UserDir/preferences
-\end_layout
-
-\end_inset
-
- file will contain only changes that you have made to the default behavior,
- some of which is hard-coded into LyX and some of which is contained in
- the system file 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-LyXDir/lyxrc.defaults
-\end_layout
-
-\end_inset
-
-.
- Note that in both files lines beginning with a 
-\begin_inset Quotes eld
-\end_inset
-
-#
-\begin_inset Quotes erd
-\end_inset
-
- are just comments and are not interpreted.
- However, only system administrators should edit 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-LyXDir/lyxrc.defaults
-\end_layout
-
-\end_inset
-
-.
- Users should use the 
-\begin_inset Flex CharStyle:MenuItem
-status collapsed
-
-\begin_layout Plain Layout
-Tools\SpecialChar \menuseparator
-Preferences
-\end_layout
-
-\end_inset
-
- dialog to create and modify their own 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-UserDir/preferences
-\end_layout
-
-\end_inset
-
- file.
-\end_layout
-
-\begin_layout Standard
-We hope that the 
-\begin_inset Flex CharStyle:MenuItem
-status collapsed
-
-\begin_layout Plain Layout
-Tools\SpecialChar \menuseparator
-Preferences
-\end_layout
-
-\end_inset
-
- dialog will be largely self-explanatory.
- Most things in the dialog have associated `tool tips': hover your mouse
- pointer over something for more information.
- Before we highlight a few of the more important commands below, however,
- a word of warning: Applying some of your changes (e.
-\begin_inset space \thinspace{}
-\end_inset
-
-g.
-\begin_inset space \space{}
-\end_inset
-
-screen fonts) will have an instant effect.
- Others (e.
-\begin_inset space \thinspace{}
-\end_inset
-
-g.
-\begin_inset space \space{}
-\end_inset
-
-changing the bind file) will not.
- If nothing appears to have changed, just 
-\begin_inset Flex CharStyle:MenuItem
-status collapsed
-
-\begin_layout Plain Layout
-Save
-\end_layout
-
-\end_inset
-
- the changes and restart LyX.
-\end_layout
-
-\begin_layout Section
-File Handling
-\end_layout
-
-\begin_layout Standard
-LyX has a powerful mechanism to convert to and from any file format using
- external programs.
-\end_layout
-
-\begin_layout Subsection
+Formats
 \begin_inset CommandInset label
 LatexCommand label
-name "sub:Formats"
+name "sec:Formats"
 
 \end_inset
 
-Formats
+
 \end_layout
 
 \begin_layout Standard
@@ -1459,7 +1340,7 @@ Format
 
 \end_inset
 
- field contains the named used to identify the format in the GUI.
+ field contains the name used to identify the format in the GUI.
  The 
 \begin_inset Flex CharStyle:MenuItem
 status collapsed
@@ -1519,7 +1400,7 @@ Viewer
 
 \end_inset
 
- and 
+ and an 
 \begin_inset Flex CharStyle:MenuItem
 status collapsed
 
@@ -1556,37 +1437,18 @@ View
 \end_inset
 
  menu.
- The editor is for example launched when you press the 
-\begin_inset Flex CharStyle:MenuItem
-status collapsed
-
-\begin_layout Plain Layout
-Edit
-\end_layout
-
-\end_inset
-
- button in the 
-\begin_inset Flex CharStyle:MenuItem
-status collapsed
-
-\begin_layout Plain Layout
-Graphics
-\end_layout
-
-\end_inset
-
- or the 
+ The editor is for example launched when you right-click on an image and
+ choose 
 \begin_inset Flex CharStyle:MenuItem
 status collapsed
 
 \begin_layout Plain Layout
-External material
+Edit externally
 \end_layout
 
 \end_inset
 
dialog.
in the appearing context menu.
 \end_layout
 
 \begin_layout Standard
@@ -1601,10 +1463,14 @@ Document format
 \end_inset
 
  option tells LyX that a format is suitable for document export.
- If this is is set and if a suitable conversion route exists (see 
+ If this is set and if a suitable conversion route exists (see sec.
+\begin_inset space \thinspace{}
+\end_inset
+
+
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sub:Converters"
+reference "sec:Converters"
 
 \end_inset
 
@@ -1773,7 +1639,7 @@ png
 .
 \end_layout
 
-\begin_layout Subsection
+\begin_layout Section
 Copiers
 \end_layout
 
@@ -1929,7 +1795,7 @@ cp $FROMFILE /home/you/pdf/$TOFILE
 
 \end_inset
 
-Save that in your local LyX directory—say, 
+Save it in your local LyX directory—say, 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -2100,14 +1966,15 @@ status collapsed
 
 \end_layout
 
-\begin_layout Subsection
+\begin_layout Section
+Converters
 \begin_inset CommandInset label
 LatexCommand label
-name "sub:Converters"
+name "sec:Converters"
 
 \end_inset
 
-Converters
+
 \end_layout
 
 \begin_layout Standard
@@ -2257,8 +2124,8 @@ $$r
 
 \end_inset
 
- The path to the original input file (this is different from $$p when chain
- of converters is called).
+ The path to the original input file (this is different from $$p when a
chain of converters is called).
 \end_layout
 
 \begin_layout Standard
@@ -2381,7 +2248,7 @@ infile.out
 status collapsed
 
 \begin_layout Plain Layout
-script <infile.out >infile.log
+script < infile.out > infile.log
 \end_layout
 
 \end_inset
@@ -2467,8 +2334,8 @@ None of these last three are presently used in any of the converters that
 \end_layout
 
 \begin_layout Standard
-You do not have to define converters between all the formats between which
you want to convert.
+You do not have to define converters for all formats between which you want
+ to convert.
  For example, you will note that there is no `LyX to PostScript' converter,
  but LyX will export PostScript.
  It does so by first creating a LaTeX file (no converter needs to be defined
@@ -2514,7 +2381,7 @@ dvipdfm
  formats', as described in section 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sub:Formats"
+reference "sec:Formats"
 
 \end_inset
 
@@ -2566,7 +2433,7 @@ status collapsed
 Internationalizing LyX
 \begin_inset CommandInset label
 LatexCommand label
-name "chap:i18n"
+name "cha:Internationalizing-LyX"
 
 \end_inset
 
@@ -3110,21 +2977,6 @@ DocName
  do right away:
 \end_layout
 
-\begin_layout Itemize
-Read 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-DocStyle.lyx
-\end_layout
-
-\end_inset
-
-, the guide to writing LyX documentation.
- Pay special attention to the translator's section.
-\end_layout
-
 \begin_layout Itemize
 Check out the documentation translation web page at 
 \begin_inset CommandInset href
@@ -3164,11 +3016,7 @@ status collapsed
 
 \begin_layout Plain Layout
 Help\SpecialChar \menuseparator
-
-\bar under
-I
-\bar default
-ntroduction
+Introduction
 \end_layout
 
 \end_inset
@@ -3785,13 +3633,14 @@ kinclude
 \end_layout
 
 \begin_layout Section
+International Keymap Stuff
 \begin_inset CommandInset label
 LatexCommand label
-name "sec:keymap"
+name "sec:International-Keymap-Stuff"
 
 \end_inset
 
-International Keymap Stuff
+
 \end_layout
 
 \begin_layout Standard
@@ -5380,10 +5229,10 @@ Preferences
 \end_layout
 
 \begin_layout Chapter
-Installing New Document Classes, Layouts, and Templates 
+Installing New Document Classes, Layouts, and Templates
 \begin_inset CommandInset label
 LatexCommand label
-name "chap:textclass"
+name "cha:Installing-New-Document"
 
 \end_inset
 
@@ -6014,13 +5863,14 @@ default
 \end_layout
 
 \begin_layout Subsection
+Layout modules
 \begin_inset CommandInset label
 LatexCommand label
 name "sub:Layout-modules"
 
 \end_inset
 
-Layout modules
+
 \end_layout
 
 \begin_layout Standard
@@ -6077,9 +5927,7 @@ DeclareLyXModule[endnotes.sty]{Endnotes}
 \end_layout
 
 \begin_layout Standard
-The argument in square brackets is optional: It declares any LaTeX packages
- on which the module depends.
- The mandatory argument, in curly brackets, is the name of the module, as
+The mandatory argument, in curly brackets, is the name of the module, as
  it should appear in 
 \begin_inset Flex CharStyle:MenuItem
 status collapsed
@@ -6092,7 +5940,32 @@ Settings
 \end_inset
 
 .
+ The argument in square brackets is optional: It declares any LaTeX packages
+ on which the module depends.
+ Please note that only packages about which LyX knows should be listed in
+ the square brackets.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+The list of such packages is documented only in the source code.
+\end_layout
+
+\end_inset
+
+ LyX will not check for arbitrary packages.
+ It is also possible to use the form 
+\begin_inset Flex CharStyle:MenuItem
+status collapsed
+
+\begin_layout Plain Layout
+from->to
+\end_layout
+
+\end_inset
+
+, which declares that the module can only be used when there exists a conversion
+ chain between formats `from' and `to'.
 \end_layout
 
 \begin_layout Standard
@@ -6943,7 +6816,7 @@ ClassOptions
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:classoptions"
+reference "sub:ClassOptions"
 
 \end_inset
 
@@ -7026,19 +6899,19 @@ Counter
 
 \end_inset
 
- This sequence defines a new counter.
- See Section
-\begin_inset space ~
-\end_inset
-
+ [
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:counter"
+\begin_layout Plain Layout
+string
+\end_layout
 
 \end_inset
 
- for details.
+] This sequence defines the properties for a counter.
+ If the counter does not yet exist, it is created; if it does exist, it
+ is modified.
  Must end with 
 \begin_inset Quotes eld
 \end_inset
@@ -7058,6 +6931,21 @@ End
 \end_inset
 
 .
+\begin_inset Newline newline
+\end_inset
+
+See Section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Counters"
+
+\end_inset
+
+ for details on counters.
 \end_layout
 
 \begin_layout Description
@@ -7078,7 +6966,7 @@ DefaultFont
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:fonts"
+reference "sub:Font-description"
 
 \end_inset
 
@@ -7253,7 +7141,7 @@ Float
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:floats"
+reference "sub:Floats"
 
 \end_inset
 
@@ -7284,59 +7172,66 @@ End
 status collapsed
 
 \begin_layout Plain Layout
-Input
+IfCounter
 \end_layout
 
 \end_inset
 
- As its name implies, this command allows you to include another layout
- definition file within yours to avoid duplicating commands.
- Common examples are the standard layout files, for example, 
+ [
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-stdclass.inc
+string
 \end_layout
 
 \end_inset
 
-, which contains most of the basic layouts.
-\end_layout
+] Modifies the properties of the given counter.
+ If the counter does not exist, the section is ignored.
+ Must end with 
+\begin_inset Quotes eld
+\end_inset
+
 
-\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-InsetLayout
+End
 \end_layout
 
 \end_inset
 
- This section (re-)defines the layout of an inset.
- It can be applied to an existing inset of to a new, user-defined inset,
- e.
-\begin_inset space \thinspace{}
-\end_inset
 
-g.
-\begin_inset space \space{}
+\begin_inset Quotes erd
 \end_inset
 
-a new character style.
- See Section
-\begin_inset space ~
+.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+IfStyle
+\end_layout
+
 \end_inset
 
+ [
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:charstyle"
+\begin_layout Plain Layout
+string
+\end_layout
 
 \end_inset
 
- for more information.
+] Modifies the properties of the given paragraph style.
+ If the style does not exist, the section is ignored.
  Must end with 
 \begin_inset Quotes eld
 \end_inset
@@ -7363,17 +7258,96 @@ End
 status collapsed
 
 \begin_layout Plain Layout
-LeftMargin
+Input
 \end_layout
 
 \end_inset
 
- A string that indicates the width of the left margin on the screen, for
- example, 
-\begin_inset Quotes eld
-\end_inset
+ As its name implies, this command allows you to include another layout
+ definition file within yours to avoid duplicating commands.
+ Common examples are the standard layout files, for example, 
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-MMMMM
+\begin_layout Plain Layout
+stdclass.inc
+\end_layout
+
+\end_inset
+
+, which contains most of the basic layouts.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+InsetLayout
+\end_layout
+
+\end_inset
+
+ This section (re-)defines the layout of an inset.
+ It can be applied to an existing inset of to a new, user-defined inset,
+ e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+a new character style.
+ See Section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Flex-insets-and"
+
+\end_inset
+
+ for more information.
+ Must end with 
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+End
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+LeftMargin
+\end_layout
+
+\end_inset
+
+ A string that indicates the width of the left margin on the screen, for
+ example, 
+\begin_inset Quotes eld
+\end_inset
+
+MMMMM
 \begin_inset Quotes erd
 \end_inset
 
@@ -7414,6 +7388,43 @@ NoStyle
 \begin_inset Flex CharStyle:Code
 status collapsed
 
+\begin_layout Plain Layout
+OutputFormat
+\end_layout
+
+\end_inset
+
+ A string indicating the file format (as defined in the Preferences dialog)
+ produced by this class.
+ It is mainly useful when 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+OutputType
+\end_layout
+
+\end_inset
+
+ is `literate' and one wants to define a new type of literate document.
+ This string is reset to `docbook', `latex', or `literate' when the correspondin
+g 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+OutputType
+\end_layout
+
+\end_inset
+
+ parameter is encountered.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
 \begin_layout Plain Layout
 OutputType
 \end_layout
@@ -7853,21 +7864,9 @@ Style
 
 \end_inset
 
- This sequence defines a new paragraph style.
- If the style already exists, it will redefine some of its parameters instead.
- See Section
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:style"
-
-\end_inset
-
- for details.
- Must end with 
+ This sequence defines a paragraph style.
+ If the style does not yet exist, it is created; if it does exist, its parameter
+s are redefined Must end with 
 \begin_inset Quotes eld
 \end_inset
 
@@ -7886,6 +7885,21 @@ End
 \end_inset
 
 .
+\begin_inset Newline newline
+\end_inset
+
+See Section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Paragraph-Styles"
+
+\end_inset
+
+ for details on paragraph styles.
 \end_layout
 
 \begin_layout Description
@@ -8069,15 +8083,16 @@ ClassOptions
 \end_inset
 
  section
-\end_layout
-
-\begin_layout Standard
 \begin_inset CommandInset label
 LatexCommand label
-name "sec:classoptions"
+name "sub:ClassOptions"
 
 \end_inset
 
+
+\end_layout
+
+\begin_layout Standard
 The 
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -8270,15 +8285,16 @@ End
 
 \begin_layout Subsection
 Paragraph Styles
-\end_layout
-
-\begin_layout Standard
 \begin_inset CommandInset label
 LatexCommand label
-name "sec:style"
+name "sub:Paragraph-Styles"
 
 \end_inset
 
+
+\end_layout
+
+\begin_layout Standard
 A paragraph style description looks like this:
 \begin_inset Foot
 status collapsed
@@ -8372,6 +8388,96 @@ block
 \begin_inset Flex CharStyle:Code
 status collapsed
 
+\begin_layout Plain Layout
+BabelPreamble
+\end_layout
+
+\end_inset
+
+ Language dependent information to be included in the LaTeX preamble when
+ this style is used.
+ Note that this will completely override any prior 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+BabelPreamble
+\end_layout
+
+\end_inset
+
+ declarations.
+ Must end with 
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+EndBabelPreamble
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ The contents of this tag will occur once in the LaTeX preamble for each
+ language used by the document.
+ Each time, the following substitutions are made:
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+$$lang
+\end_layout
+
+\end_inset
+
+ is replaced by the language name (as used by the babel package).
+\end_layout
+
+\begin_layout Itemize
+The 
+\begin_inset Quotes eld
+\end_inset
+
+Function
+\begin_inset Quotes erd
+\end_inset
+
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+_()
+\end_layout
+
+\end_inset
+
+ replaces its argument by the translation of the argument to the current
+ language.
+\end_layout
+
+\begin_layout Standard
+This preamble snippet will only be used if the document contains more than
+ one language and the babel package is used.
+\end_layout
+
+\end_deeper
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
 \begin_layout Plain Layout
 BottomSep
 \end_layout
@@ -8810,7 +8916,7 @@ and
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:fonts"
+reference "sub:Font-description"
 
 \end_inset
 
@@ -8907,381 +9013,361 @@ FreeSpacing
 status collapsed
 
 \begin_layout Plain Layout
-BabelPreamble
+InnerTag
 \end_layout
 
 \end_inset
 
- Language dependent information to be included in the LaTeX preamble when
- this style is used.
- Note that this will completely override any prior 
+ [[FIXME]] (Used only with XML-type formats.)
+\end_layout
+
+\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-BabelPreamble
+InTitle
 \end_layout
 
 \end_inset
 
- declarations.
- Must end with 
-\begin_inset Quotes eld
-\end_inset
-
-
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-EndBabelPreamble
+[1, 0]
 \end_layout
 
 \end_inset
 
-
-\begin_inset Quotes erd
-\end_inset
-
-.
- The contents of this tag will occur once in the LaTeX preamble for each
- language used by the document.
- Each time, the following substitutions are made:
-\end_layout
-
-\begin_deeper
-\begin_layout Itemize
+ If 1, marks the layout as being part of a title block (see also the 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-$$lang
-\end_layout
-
-\end_inset
-
- is replaced by the language name (as used by the babel package).
+TitleLatexType
 \end_layout
 
-\begin_layout Itemize
-The 
-\begin_inset Quotes eld
-\end_inset
-
-Function
-\begin_inset Quotes erd
 \end_inset
 
+ and 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-_()
+TitleLatexName
 \end_layout
 
 \end_inset
 
- replaces its argument by the translation of the argument to the current
- language.
-\end_layout
-
-\begin_layout Standard
-This preamble snippet will only be used if the document contains more than
- one language and the babel package is used.
+ global entries).
 \end_layout
 
-\end_deeper
 \begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LangPreamble
+ItemSep
 \end_layout
 
 \end_inset
 
- Like 
+ [
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-BabelPreamble
+float=0
 \end_layout
 
 \end_inset
 
-, but this preamble snippet occurs independently from the babel package,
- and only for the document language.
- Must end with 
-\begin_inset Quotes eld
-\end_inset
-
-
+] This provides extra space between paragraphs that have the same layout.
+ If you put other layouts into an environment, each is separated with the
+ environment's 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-EndLangPreamble
+Parsep
 \end_layout
 
 \end_inset
 
+.
+ But the whole items of the environment are additionally separated with
+ this 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Itemsep
+\end_layout
 
-\begin_inset Quotes erd
 \end_inset
 
 .
+ Note that this is a
+\emph on
+ multiplier.
 \end_layout
 
-\begin_deeper
-\begin_layout Standard
-If the style defines text that appears in the typeset document, it may use
+\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LangPreamble
+ItemTag
 \end_layout
 
 \end_inset
 
- and 
+ [[FIXME]] (Used only with XML-type formats.)
+\end_layout
+
+\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-BabelPreamble
+KeepEmpty
 \end_layout
 
 \end_inset
 
- to support non-english and even multilanguage documents correctly.
- The following excerpt (from the 
+\begin_inset CommandInset label
+LatexCommand label
+name "des:KeepEmpty"
+
+\end_inset
+
+[
+\emph on
+
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-theorems-ams.inc
-\end_layout
 
-\end_inset
-
- file) shows how this works:
+\emph on
+0
 \end_layout
 
-\begin_layout LyX-Code
-Preamble
-\end_layout
+\end_inset
 
-\begin_layout LyX-Code
-  
-\backslash
-theoremstyle{remark}
-\end_layout
 
-\begin_layout LyX-Code
-  
-\backslash
-newtheorem{claim}[thm]{
-\backslash
-protect
-\backslash
-claimname}
-\end_layout
+\emph default
+, 
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-\begin_layout LyX-Code
-EndPreamble
+\begin_layout Plain Layout
+1
 \end_layout
 
-\begin_layout LyX-Code
-LangPreamble
-\end_layout
+\end_inset
 
-\begin_layout LyX-Code
-  
-\backslash
-providecommand{
-\backslash
-claimname}{_(Claim)}
+] Usually LyX does not allow you to leave a paragraph empty, since it would
+ lead to empty LaTeX output.
+ There are some cases where this could be desirable however: in a letter
+ template, the required fields can be provided as empty fields, so that
+ people do not forget them; in some special classes, a layout can be used
+ as some kind of break, which does not contain actual text.
 \end_layout
 
-\begin_layout LyX-Code
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
 
+\begin_layout Plain Layout
+LabelBottomsep
 \end_layout
 
-\begin_layout LyX-Code
-EndLangPreamble
-\end_layout
+\end_inset
 
-\begin_layout LyX-Code
-BabelPreamble
-\end_layout
+ [float=0] The vertical space between the label and the text body.
+ Only used for labels that are above the text body (
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-\begin_layout LyX-Code
-    
-\backslash
-addto
-\backslash
-captions$$lang{
-\backslash
-renewcommand{
-\backslash
-claimname}{_(Claim)}}
+\begin_layout Plain Layout
+Top_Environment
 \end_layout
 
-\begin_layout LyX-Code
-EndBabelPreamble
-\end_layout
+\end_inset
 
-\begin_layout Standard
-The key to correct translation of the user visible text is the definition
- of the command 
+, 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\backslash
-claimname
+Centered_Top_Environment
 \end_layout
 
 \end_inset
 
- in the language preamble.
- This command holds the name of the theorem that will appear in the output.
- The 
+).
+\end_layout
+
+\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-BabelPreamble
+LabelCounter
 \end_layout
 
 \end_inset
 
- then uses the commands offered by the babel package to redefine 
+ [
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\backslash
-claimname
+string=""
 \end_layout
 
 \end_inset
 
- for each used language in multilanguage documents.
-\end_layout
+]
+\begin_inset Newline newline
+\end_inset
 
-\end_deeper
-\begin_layout Description
+The name of the counter for automatic numbering.
+\begin_inset Newline newline
+\end_inset
+
+This 
+\emph on
+must
+\emph default
+ be given if 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-InnerTag
+LabelType
 \end_layout
 
 \end_inset
 
- [[FIXME]] (Used only with XML-type formats.)
-\end_layout
-
-\begin_layout Description
+ is 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-InTitle
+Counter
 \end_layout
 
 \end_inset
 
+.
+ In that case, the counter will be stepped each time the layout appears.
  
+\begin_inset Newline newline
+\end_inset
+
+This 
+\emph on
+may
+\emph default
+ also be given if 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-[1, 0]
+LabelType
 \end_layout
 
 \end_inset
 
- If 1, marks the layout as being part of a title block (see also the 
+ is 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-TitleLatexType
+Enumerate
 \end_layout
 
 \end_inset
 
- and 
+, though this case is a bit complicated.
+ Suppose you declare 
+\begin_inset Quotes eld
+\end_inset
+
+
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-TitleLatexName
+LabelCounter myenum
 \end_layout
 
 \end_inset
 
- global entries).
-\end_layout
 
-\begin_layout Description
+\begin_inset Quotes erd
+\end_inset
+
+.
+ Then the actual counters used are 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-ItemSep
+myenumi
 \end_layout
 
 \end_inset
 
- [
+, 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-float=0
+myenumii
 \end_layout
 
 \end_inset
 
-] This provides extra space between paragraphs that have the same layout.
- If you put other layouts into an environment, each is separated with the
- environment's 
+, 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Parsep
+myenumiii
 \end_layout
 
 \end_inset
 
-.
- But the whole items of the environment are additionally separated with
- this 
+, and 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Itemsep
+myenumiv
 \end_layout
 
 \end_inset
 
-.
- Note that this is a
-\emph on
- multiplier.
+, much as in LaTeX.
+ These counters must all be declared separately.
+\begin_inset Newline newline
+\end_inset
+
+See Section 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Counters"
+
+\end_inset
+
+ for details on counters.
 \end_layout
 
 \begin_layout Description
@@ -9289,12 +9375,24 @@ Itemsep
 status collapsed
 
 \begin_layout Plain Layout
-ItemTag
+LabelFont
 \end_layout
 
 \end_inset
 
- [[FIXME]] (Used only with XML-type formats.)
+ The font used for the label.
+ See section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Font-description"
+
+\end_inset
+
+.
 \end_layout
 
 \begin_layout Description
@@ -9302,50 +9400,36 @@ ItemTag
 status collapsed
 
 \begin_layout Plain Layout
-KeepEmpty
+LabelIndent
 \end_layout
 
 \end_inset
 
-\begin_inset CommandInset label
-LatexCommand label
-name "des:KeepEmpty"
-
-\end_inset
-
-[
-\emph on
+ Text that indicates how far a label should be indented.
+\end_layout
 
+\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\emph on
-0
+Labelsep
 \end_layout
 
 \end_inset
 
-
-\emph default
-, 
+ [
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-1
+string=""
 \end_layout
 
 \end_inset
 
-] Usually LyX does not allow you to leave a paragraph empty, since it would
- lead to empty LaTeX output.
- There are some cases where this could be desirable however: in a letter
- template, the required fields can be provided as empty fields, so that
- people do not forget them; in some special classes, a layout can be used
- as some kind of break, which does not contain actual text.
+] The horizontal space between the label and the text body.
+ Only used for labels that are not above the text body.
 \end_layout
 
 \begin_layout Description
@@ -9353,113 +9437,160 @@ status collapsed
 status collapsed
 
 \begin_layout Plain Layout
-LabelBottomsep
+LabelString
 \end_layout
 
 \end_inset
 
- [float=0] The vertical space between the label and the text body.
- Only used for labels that are above the text body (
+ [
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Top_Environment
+string=""
 \end_layout
 
 \end_inset
 
-, 
+] The string used for a label with a 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Centered_Top_Environment
+Static
 \end_layout
 
 \end_inset
 
-).
+ labeltype.
+ When 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+LabelCounter
 \end_layout
 
-\begin_layout Description
+\end_inset
+
+ is set, this string can be contain the special formatting commands described
+ in Section 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Counters"
+
+\end_inset
+
+.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+For the sake of backwards compatibility, the string 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelCounter
+@
+\emph on
+style-name
+\emph default
+@
 \end_layout
 
 \end_inset
 
- [
+ will be replaced by the expanded 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-string=""
+LabelString
 \end_layout
 
 \end_inset
 
-]
-\begin_inset Newline newline
+ of style 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+style-name
+\end_layout
+
 \end_inset
 
-The name of the counter for automatic numbering (see Section 
+.
+ This feature is now obsolete and should be replaced by the mechanisms of
+ Section 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:counter"
+reference "sub:Counters"
 
 \end_inset
 
- for details).
- This must be given if 
+.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Labeltype
+LabelStringAppendix
 \end_layout
 
 \end_inset
 
- is 
+ [
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Counter
+string=""
 \end_layout
 
 \end_inset
 
-.
-\end_layout
-
-\begin_layout Description
+] This is used inside the appendix instead of 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelFont
+LabelString
 \end_layout
 
 \end_inset
 
- The font used for the label.
- See section
-\begin_inset space ~
+.
+ Note that every 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+LabelString
+\end_layout
+
 \end_inset
 
+ statement resets 
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:fonts"
+\begin_layout Plain Layout
+LabelStringAppendix
+\end_layout
 
 \end_inset
 
-.
+ too.
 \end_layout
 
 \begin_layout Description
@@ -9467,12 +9598,12 @@ reference "sec:fonts"
 status collapsed
 
 \begin_layout Plain Layout
-LabelIndent
+LabelTag
 \end_layout
 
 \end_inset
 
- Text that indicates how far a label should be indented.
+ [FIXME] (Used only with XML-type formats.)
 \end_layout
 
 \begin_layout Description
@@ -9480,7 +9611,7 @@ LabelIndent
 status collapsed
 
 \begin_layout Plain Layout
-Labelsep
+LabelType
 \end_layout
 
 \end_inset
@@ -9490,36 +9621,40 @@ Labelsep
 status collapsed
 
 \begin_layout Plain Layout
-string=""
+
+\emph on
+No_Label
+\emph default
+, Manual, Static, Top_Environment, Centered_Top_Environment, Counter, Sensitive,
+ Enumerate, Itemize, Bibliography
 \end_layout
 
 \end_inset
 
-] The horizontal space between the label and the text body.
- Only used for labels that are not above the text body.
+] 
 \end_layout
 
-\begin_layout Description
+\begin_deeper
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelString
+Manual
 \end_layout
 
 \end_inset
 
- [
-\begin_inset Flex CharStyle:Code
-status collapsed
+ means the label is the very first word (up to the first real blank).
+ Use protected spaces (like
+\begin_inset space ~
+\end_inset
 
-\begin_layout Plain Layout
-string=""
+that one) if you want more than one word as the label.
 \end_layout
 
-\end_inset
-
-] The string used for a label with a 
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -9529,115 +9664,121 @@ Static
 
 \end_inset
 
- labeltype.
- When 
+ means the label is simply whatever 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelCounter
+LabelString
 \end_layout
 
 \end_inset
 
- is set, this string can be contain the special formatting commands described
- in Section 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:counter"
-
-\end_inset
-
-.
-\begin_inset Foot
-status collapsed
+ declares it to be.
+ Note that this really is `static'.
+\end_layout
 
-\begin_layout Plain Layout
-For the sake of backwards compatibility, the string 
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-@
-\emph on
-style-name
-\emph default
-@
+Top_Environment
 \end_layout
 
 \end_inset
 
will be replaced by the expande
an
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelString
+Centered_Top_Environment
 \end_layout
 
 \end_inset
 
- of style 
+ are special cases of 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\emph on
-style-name
+Static
 \end_layout
 
 \end_inset
 
 .
- This feature is now obsolete and should be replaced by the mechanisms of
- Section 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:counter"
-
-\end_inset
+ The label will be printed above the paragraph, but only at the top of an
+ environment or the top of a chain of paragraphs with this layout.
+ This might be used with the 
+\begin_inset Flex CharStyle:MenuItem
+status collapsed
 
-.
+\begin_layout Plain Layout
+Abstract
 \end_layout
 
 \end_inset
 
-
+ layout, for example.
 \end_layout
 
-\begin_layout Description
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelStringAppendix
+Sensitive
 \end_layout
 
 \end_inset
 
- [
+ is a special case for the caption-labels 
+\begin_inset Quotes eld
+\end_inset
+
+Figure
+\begin_inset Quotes erd
+\end_inset
+
+ and 
+\begin_inset Quotes eld
+\end_inset
+
+Table
+\begin_inset Quotes erd
+\end_inset
+
+.
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-string=""
+Sensitive
 \end_layout
 
 \end_inset
 
-] This is used inside the appendix instead of 
+ means the (hardcoded) label string depends on the kind of float: It is
+ hardcoded to be `FloatType N', where N is the value of the counter associated
+ with the float.
+\end_layout
+
+\begin_layout Itemize
+The 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelString
+Counter
 \end_layout
 
 \end_inset
 
-.
- Note that every 
+ label type defines automatically numbered labels.
+ The 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -9647,111 +9788,145 @@ LabelString
 
 \end_inset
 
- statement resets 
+ will be expanded to resolve any counter references it contains: For example,
+ it might be 
+\begin_inset Quotes eld
+\end_inset
+
+
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelStringAppendix
+Section 
+\backslash
+thechapter.
+\backslash
+thesection
 \end_layout
 
 \end_inset
 
- too.
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ See Section 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Counters"
+
+\end_inset
+
+ for more information on counters.
 \end_layout
 
-\begin_layout Description
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelTag
+Enumerate
 \end_layout
 
 \end_inset
 
- [FIXME] (Used only with XML-type formats.)
+ produces the usual sort of enumeration labels.
+ At present, it is hardcoded to use Arabic numerals, lowercase letters,
+ small Roman numerals, and uppercase letters for the four possible depths.
 \end_layout
 
-\begin_layout Description
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Labeltype
+Itemize
 \end_layout
 
 \end_inset
 
- [
+ produces various bullets at the different levels.
+ It is also hardcoded.
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\emph on
-No_Label
-\emph default
-, Manual, Static, Top_Environment, 
-\begin_inset Newline newline
-\end_inset
-
-Centered_Top_Environment, Sensitive, Counter
+Bibliography
 \end_layout
 
 \end_inset
 
-] 
-\begin_inset Newline newline
-\end_inset
-
-
+ is used internally by LyX and should be used only with 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Manual
+LatexType BibEnvironment
 \end_layout
 
 \end_inset
 
- means the label is the very first word (up to the first real blank).
-\begin_inset Foot
+.
+\end_layout
+
+\end_deeper
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Use protected spaces if you want more than one word as the label.
+LangPreamble
 \end_layout
 
 \end_inset
 
+ Like 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Static
+BabelPreamble
 \end_layout
 
 \end_inset
 
- means it is defined in the layout (see 
+, but this preamble snippet occurs independently from the babel package,
+ and only for the document language.
+ Must end with 
+\begin_inset Quotes eld
+\end_inset
+
+
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelString
+EndLangPreamble
 \end_layout
 
 \end_inset
 
-).
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_deeper
+\begin_layout Standard
+If the style defines text that appears in the typeset document, it may use
  
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Top_Environment
+LangPreamble
 \end_layout
 
 \end_inset
@@ -9761,125 +9936,131 @@ Top_Environment
 status collapsed
 
 \begin_layout Plain Layout
-Centered_Top_Environment
+BabelPreamble
 \end_layout
 
 \end_inset
 
- are special cases of 
+ to support non-english and even multilanguage documents correctly.
+ The following excerpt (from the 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Static
+theorems-ams.inc
 \end_layout
 
 \end_inset
 
-.
- The label will be printed above the paragraph, but only at the top of an
- environment or the top of a chain of paragraphs with this layout.
- Usage is for example the 
-\begin_inset Flex CharStyle:MenuItem
-status collapsed
+ file) shows how this works:
+\end_layout
 
-\begin_layout Plain Layout
-Abstract
+\begin_layout LyX-Code
+Preamble
 \end_layout
 
-\end_inset
+\begin_layout LyX-Code
+  
+\backslash
+theoremstyle{remark}
+\end_layout
 
- layout or the 
-\begin_inset Flex CharStyle:MenuItem
-status collapsed
+\begin_layout LyX-Code
+  
+\backslash
+newtheorem{claim}[thm]{
+\backslash
+protect
+\backslash
+claimname}
+\end_layout
 
-\begin_layout Plain Layout
-Bibliography
+\begin_layout LyX-Code
+EndPreamble
 \end_layout
 
-\end_inset
+\begin_layout LyX-Code
+LangPreamble
+\end_layout
 
- layout.
- This is also the case for 
-\begin_inset Flex CharStyle:Code
-status collapsed
+\begin_layout LyX-Code
+  
+\backslash
+providecommand{
+\backslash
+claimname}{_(Claim)}
+\end_layout
+
+\begin_layout LyX-Code
 
-\begin_layout Plain Layout
-Manual
 \end_layout
 
-\end_inset
+\begin_layout LyX-Code
+EndLangPreamble
+\end_layout
 
- labels with latex type 
-\begin_inset Flex CharStyle:Code
-status collapsed
+\begin_layout LyX-Code
+BabelPreamble
+\end_layout
 
-\begin_layout Plain Layout
-Environment
+\begin_layout LyX-Code
+    
+\backslash
+addto
+\backslash
+captions$$lang{
+\backslash
+renewcommand{
+\backslash
+claimname}{_(Claim)}}
 \end_layout
 
-\end_inset
+\begin_layout LyX-Code
+EndBabelPreamble
+\end_layout
 
-, in order to make layouts for theorems work correctly.
+\begin_layout Standard
+The key to correct translation of the user visible text is the definition
+ of the command 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Sensitive
-\end_layout
-
-\end_inset
-
- is a special case for the caption-labels 
-\begin_inset Quotes eld
-\end_inset
 
-Figure
-\begin_inset Quotes erd
-\end_inset
-
- and 
-\begin_inset Quotes eld
-\end_inset
+\backslash
+claimname
+\end_layout
 
-Table
-\begin_inset Quotes erd
 \end_inset
 
-.
+ in the language preamble.
+ This command holds the name of the theorem that will appear in the output.
+ The 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Sensitive
+BabelPreamble
 \end_layout
 
 \end_inset
 
- means the (hardcoded) label string depends on the kind of float.
- The 
+ then uses the commands offered by the babel package to redefine 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Counter
-\end_layout
-
-\end_inset
 
- label type defines automatically numbered labels.
- See Section 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:counter"
+\backslash
+claimname
+\end_layout
 
 \end_inset
 
-.
+ for each used language in multilanguage documents.
 \end_layout
 
+\end_deeper
 \begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -9954,13 +10135,36 @@ Paragraph
 status collapsed
 
 \begin_layout Plain Layout
-List_Environment
+List_Environment, Bib_Environment
 \end_layout
 
 \end_inset
 
 ] How the layout should be translated into LaTeX.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+LatexType
+\end_layout
+
+\end_inset
+
+ is perhaps a bit misleading, since these rules apply to SGML classes, too.
+ Visit the SGML class files for specific examples.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -9972,6 +10176,9 @@ Paragraph
 
  means nothing special.
  
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -9998,7 +10205,10 @@ LatexName
 
 \end_inset
 
- and 
+.
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10033,6 +10243,9 @@ LatexName
 
 .
  
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10052,7 +10265,7 @@ Environment
 
 \end_inset
 
-, except that a 
+, except that an 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10066,6 +10279,9 @@ item
 
  is generated for each paragraph of this environment.
  
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10127,19 +10343,6 @@ aragraph
 
  dialog.
  
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\emph on
-LatexType
-\end_layout
-
-\end_inset
-
- is perhaps a bit misleading, since these rules apply to SGML classes, too.
- Visit the SGML class files for specific examples.
 \end_layout
 
 \begin_layout Standard
@@ -10170,6 +10373,7 @@ end{latexname}.
 depending upon the LaTeX type.
 \end_layout
 
+\end_deeper
 \begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -11084,7 +11288,7 @@ TextFont
  See section 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:fonts"
+reference "sub:Font-description"
 
 \end_inset
 
@@ -11135,15 +11339,16 @@ float=0
 
 \begin_layout Subsection
 Floats
-\end_layout
-
-\begin_layout Standard
 \begin_inset CommandInset label
 LatexCommand label
-name "sec:floats"
+name "sub:Floats"
 
 \end_inset
 
+
+\end_layout
+
+\begin_layout Standard
 Since version 1.3.0 of LyX, it is has been both possible and necessary to
  define the floats (
 \begin_inset Flex CharStyle:MenuItem
@@ -11253,6 +11458,7 @@ string
 \end_inset
 
 ] The string that will be used in the menus and also for the caption.
+ This is translated to the current language if babel is used.
 \end_layout
 
 \begin_layout Description
@@ -11350,6 +11556,7 @@ string
 \end_inset
 
 ] The heading used for the list of floats.
+ This is translated to the document language.
 \end_layout
 
 \begin_layout Description
@@ -11677,15 +11884,16 @@ type
 
 \begin_layout Subsection
 Flex insets and InsetLayout
-\end_layout
-
-\begin_layout Standard
 \begin_inset CommandInset label
 LatexCommand label
-name "sec:charstyle"
+name "sub:Flex-insets-and"
 
 \end_inset
 
+
+\end_layout
+
+\begin_layout Standard
 LyX has supported character styles since version 1.4.0; as of version 1.6.0,
  these are called Flex insets.
  
@@ -12063,7 +12271,6 @@ URL
 \end_inset
 
 .
 \end_layout
 
 \begin_layout Enumerate
@@ -12299,7 +12506,7 @@ and
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:fonts"
+reference "sub:Font-description"
 
 \end_inset
 
@@ -12491,7 +12698,7 @@ LabelFont
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:fonts"
+reference "sub:Font-description"
 
 \end_inset
 
@@ -12834,15 +13041,16 @@ reference "des:Requires"
 
 \begin_layout Subsection
 Counters
-\end_layout
-
-\begin_layout Standard
 \begin_inset CommandInset label
 LatexCommand label
-name "sec:counter"
+name "sub:Counters"
 
 \end_inset
 
+
+\end_layout
+
+\begin_layout Standard
 Since version 1.3.0 of LyX, it is both possible and necessary to define the
  counters (
 \begin_inset Flex CharStyle:MenuItem
@@ -12890,11 +13098,21 @@ to your layout file to get them to work.
 \end_layout
 
 \begin_layout LyX-Code
-Counter name
+Counter CounterName
 \end_layout
 
 \begin_layout Standard
-where of course `name' is replaced by the name of the counter.
+where of course `
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+CounterName
+\end_layout
+
+\end_inset
+
+' is replaced by the name of the counter.
  And it must end with 
 \begin_inset Quotes eld
 \end_inset
@@ -13259,15 +13477,16 @@ section
 
 \begin_layout Subsection
 Font description
-\end_layout
-
-\begin_layout Standard
 \begin_inset CommandInset label
 LatexCommand label
-name "sec:fonts"
+name "sub:Font-description"
 
 \end_inset
 
+
+\end_layout
+
+\begin_layout Standard
 A font description looks like this:
 \end_layout
 
@@ -13467,7 +13686,7 @@ string
 
 \end_inset
 
-] Valid argument are: 
+] Valid arguments are: 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -13529,6 +13748,45 @@ no_bar
 
 .
  Each of these turns on or off the corresponding attribute.
+ For example, 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+emph
+\end_layout
+
+\end_inset
+
+ turns on emphasis, and 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+no_emph
+\end_layout
+
+\end_inset
+
+ turns it off.
+\begin_inset Newline newline
+\end_inset
+
+If the latter seems puzzling, remember that the font settings for the present
+ context are generally inherited from the surrounding context.
+ So 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+no_emph
+\end_layout
+
+\end_inset
+
+ would turn off the emphasis that was anyway in effect, say, in a theorem
+ environment.
 \end_layout
 
 \begin_layout Description
@@ -13797,7 +14055,7 @@ The automatic conversion only handles syntax changes.
 Creating Templates
 \begin_inset CommandInset label
 LatexCommand label
-name "sec:templates"
+name "sec:Creating-Templates"
 
 \end_inset
 
@@ -14564,7 +14822,7 @@ InputFormat
  This must be the name of a format that is known to LyX (see section 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sub:Formats"
+reference "sec:Formats"
 
 \end_inset
 
@@ -15657,34 +15915,13 @@ status collapsed
 \end_layout
 
 \begin_layout Section
+Security discussion
 \begin_inset CommandInset label
 LatexCommand label
 name "sec:Security-discussion"
 
 \end_inset
 
-Security discussion
-\end_layout
-
-\begin_layout Standard
-\begin_inset Box Shadowbox
-position "t"
-hor_pos "c"
-has_inner_box 1
-inner_pos "t"
-use_parbox 0
-width "100col%"
-special "none"
-height "1in"
-height_special "totalheight"
-status open
-
-\begin_layout Plain Layout
-WARNING: This section is definitely outdated.
-\end_layout
-
-\end_inset
-
 
 \end_layout
 
@@ -15735,49 +15972,7 @@ This also implies that you are restricted in what command strings you can
  If you want to use some of the shell features, you should write a safe
  script to do this in a controlled manner, and then invoke the script from
  the command string.
- In the 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-lib/scripts
-\end_layout
-
-\end_inset
-
- directory of the LyX installation, you can find a safe wrapper script 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-general_command_wrapper.py
-\end_layout
-
-\end_inset
-
- that supports redirection of input and output.
- That can serve as an example for how to write safe template scripts.
- For a more advanced example that uses 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-fork
-\end_layout
-
-\end_inset
-
- and friends, take a look at the 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-pic2ascii.py
-\end_layout
-
-\end_inset
-
- converter script.
 \end_layout
 
 \begin_layout Standard