]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Customization.lyx
Customization.lyx: only whitespace (and update to latest file format)
[lyx.git] / lib / doc / Customization.lyx
index 8945a49c7e31cfbd0f415473ce8af748157b8a67..c785bde109e5117fb83159b26b4178c804c7f3c2 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 361
+\lyxformat 369
 \begin_document
 \begin_header
 \textclass scrbook
@@ -103,20 +103,19 @@ End
 \paperorientation portrait
 \branch OutDated
 \selected 0
+\filename_suffix 0
 \color #f5fae7
 \end_branch
 \secnumdepth 3
 \tocdepth 3
 \paragraph_separation indent
-\defskip medskip
+\paragraph_indentation default
 \quotes_language english
 \papercolumns 1
 \papersides 2
 \paperpagestyle headings
-\tracking_changes true
+\tracking_changes false
 \output_changes false
-\author "Jean-Marc Lasgouttes" 
-\author "" 
 \end_header
 
 \begin_body
@@ -151,11 +150,7 @@ type "mailto:"
 \end_inset
 
  in the subject header, and please cc the current maintainer of this file,
- Richard Heck <
-rgheck
-@
-comcast
-.net>.
+ Richard Heck <rgheck@comcast.net>.
 \end_layout
 
 \end_inset
@@ -204,9 +199,7 @@ Introduction
 This manual covers the customization features present in LyX.
  In it, we discuss issues like keyboard shortcuts, screen previewing options,
  printer options, sending commands to LyX via the LyX Server, internationalizati
-on, installing new 
-LaTeX
- classes and LyX layouts, etc.
+on, installing new LaTeX classes and LyX layouts, etc.
  We can't possibly hope to touch on everything you can change—our developers
  add new features faster than we can document them—but we will explain the
  most common customizations and hopefully point you in the right direction
@@ -219,12 +212,8 @@ status open
 
 \begin_layout Standard
 Information from previous versions of this document that now seems to be
- outdated is contained in the 
-OutDated
- branch of this document.
- By default, this information will not appear in the 
-LaTeX
- output.
+ outdated is contained in the OutDated branch of this document.
+ By default, this information will not appear in the LaTeX output.
 \end_layout
 
 \end_inset
@@ -263,7 +252,6 @@ on files; the user directory is where you can place your modified versions.
 status collapsed
 
 \begin_layout Plain Layout
-
 LyXDir
 \end_layout
 
@@ -274,7 +262,6 @@ LyXDir
 status collapsed
 
 \begin_layout Plain Layout
-
 UserDir
 \end_layout
 
@@ -290,7 +277,6 @@ What's in
 status collapsed
 
 \begin_layout Plain Layout
-
 LyXDir
 \end_layout
 
@@ -304,7 +290,6 @@ LyXDir
 status collapsed
 
 \begin_layout Plain Layout
-
 LyXDir
 \end_layout
 
@@ -332,7 +317,6 @@ Preferences
 status collapsed
 
 \begin_layout Plain Layout
-
 LyXDir
 \end_layout
 
@@ -353,7 +337,6 @@ The files, which are to be found in
 status collapsed
 
 \begin_layout Plain Layout
-
 UserDir
 \end_layout
 
@@ -385,8 +368,7 @@ lyxrc.defaults
 status collapsed
 
 \begin_layout Plain Layout
-packages.
-lst
+packages.lst
 \end_layout
 
 \end_inset
@@ -399,9 +381,7 @@ status collapsed
 
 \begin_layout Plain Layout
 Help\SpecialChar \menuseparator
-
 LaTeX
-
 \begin_inset space ~
 \end_inset
 
@@ -419,10 +399,7 @@ Configuration
 status collapsed
 
 \begin_layout Plain Layout
-
-textclass
-.
-lst
+textclass.lst
 \end_layout
 
 \end_inset
@@ -437,9 +414,8 @@ layout/
 
 \end_inset
 
- directories, along with the associated 
-LaTeX
- document class and their description.
+ directories, along with the associated LaTeX document class and their descripti
+on.
 \end_layout
 
 \begin_layout Labeling
@@ -448,10 +424,7 @@ LaTeX
 status collapsed
 
 \begin_layout Plain Layout
-
-lyxmodules
-.
-lst
+lyxmodules.lst
 \end_layout
 
 \end_inset
@@ -475,15 +448,12 @@ layout/
 status collapsed
 
 \begin_layout Plain Layout
-*files.
-lst
+*files.lst
 \end_layout
 
 \end_inset
 
- lists of various sorts of 
-LaTeX
--related files found on your system
+ lists of various sorts of LaTeX-related files found on your system
 \end_layout
 
 \begin_layout Labeling
@@ -492,9 +462,7 @@ LaTeX
 status collapsed
 
 \begin_layout Plain Layout
-doc/
-LaTeXConfig
-.lyx
+doc/LaTeXConfig.lyx
 \end_layout
 
 \end_inset
@@ -504,17 +472,13 @@ LaTeXConfig
 status collapsed
 
 \begin_layout Plain Layout
-
-LaTeXConfig
-.lyx.in
+LaTeXConfig.lyx.in
 \end_layout
 
 \end_inset
 
 .
- It contains information on your 
-LaTeX
- configuration.
+ It contains information on your LaTeX configuration.
 \end_layout
 
 \begin_layout Subsection
@@ -527,7 +491,6 @@ These directories are duplicated between
 status collapsed
 
 \begin_layout Plain Layout
-
 LyXDir
 \end_layout
 
@@ -538,7 +501,6 @@ LyXDir
 status collapsed
 
 \begin_layout Plain Layout
-
 UserDir
 \end_layout
 
@@ -550,7 +512,6 @@ UserDir
 status collapsed
 
 \begin_layout Plain Layout
-
 UserDir
 \end_layout
 
@@ -580,9 +541,7 @@ status collapsed
 
 \end_inset
 
- that define the 
-keybindings
- used in LyX.
+ that define the keybindings used in LyX.
  If there exists an internationalized version of the bind file named 
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -602,9 +561,7 @@ $LANG_xxx.bind
 status collapsed
 
 \begin_layout Plain Layout
-
-clipart
-/
+clipart/
 \end_layout
 
 \end_inset
@@ -630,17 +587,13 @@ doc/
 status collapsed
 
 \begin_layout Plain Layout
-
-LaTeXConfig
-.lyx
+LaTeXConfig.lyx
 \end_layout
 
 \end_inset
 
  deserves special attention, as noted above.
- The internationalized help docs are in 
-subdirectories
+ The internationalized help docs are in subdirectories 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -730,16 +683,12 @@ Document
 status collapsed
 
 \begin_layout Plain Layout
-
-kbd
-/
+kbd/
 \end_layout
 
 \end_inset
 
- contains keyboard 
-keymapping
- files.
+ contains keyboard keymapping files.
  See Chapter
 \begin_inset space ~
 \end_inset
@@ -785,7 +734,6 @@ reference "cha:Installing-New-Document"
 status collapsed
 
 \begin_layout Plain Layout
-
 lyx2lyx
 \end_layout
 
@@ -796,7 +744,6 @@ lyx2lyx
 status collapsed
 
 \begin_layout Plain Layout
-
 lyx2lyx
 \end_layout
 
@@ -867,9 +814,7 @@ reference "sec:Creating-Templates"
 status collapsed
 
 \begin_layout Plain Layout
-
-ui
-/
+ui/
 \end_layout
 
 \end_inset
@@ -879,8 +824,7 @@ ui
 status collapsed
 
 \begin_layout Plain Layout
-.
-ui
+.ui
 \end_layout
 
 \end_inset
@@ -935,17 +879,12 @@ LyX
 status collapsed
 
 \begin_layout Plain Layout
-
-chkconfig
-.
-ltx
+chkconfig.ltx
 \end_layout
 
 \end_inset
 
- this is a 
-LaTeX
- script used during the configuration process.
+ this is a LaTeX script used during the configuration process.
  Do not run directly.
 \end_layout
 
@@ -955,8 +894,7 @@ LaTeX
 status collapsed
 
 \begin_layout Plain Layout
-configure.
-py
+configure.py
 \end_layout
 
 \end_inset
@@ -975,15 +913,13 @@ Other files needing a line or two...
 status collapsed
 
 \begin_layout Plain Layout
-
 encodings
 \end_layout
 
 \end_inset
 
- this contains tables describing how different character 
-encodings
- can be mapped to Unicode
+ this contains tables describing how different character encodings can be
+ mapped to Unicode
 \end_layout
 
 \begin_layout Labeling
@@ -1040,7 +976,6 @@ Even if you are using LyX as an unprivileged user, you might want to change
 status collapsed
 
 \begin_layout Plain Layout
-
 UserDir
 \end_layout
 
@@ -1076,7 +1011,6 @@ LyX
 status collapsed
 
 \begin_layout Plain Layout
-
 LyXDir
 \end_layout
 
@@ -1087,7 +1021,6 @@ LyXDir
 status collapsed
 
 \begin_layout Plain Layout
-
 UserDir
 \end_layout
 
@@ -1098,7 +1031,6 @@ UserDir
 status collapsed
 
 \begin_layout Plain Layout
-
 LyXDir
 \end_layout
 
@@ -1141,7 +1073,6 @@ preferences
 status collapsed
 
 \begin_layout Plain Layout
-
 UserDir
 \end_layout
 
@@ -1167,8 +1098,7 @@ Reconfigure
 status collapsed
 
 \begin_layout Plain Layout
-configure.
-py
+configure.py
 \end_layout
 
 \end_inset
@@ -1181,9 +1111,7 @@ py
 status collapsed
 
 \begin_layout Plain Layout
-
-UserDir
-/layouts
+UserDir/layouts
 \end_layout
 
 \end_inset
@@ -1210,9 +1138,7 @@ If you get some updated documentation from LyX ftp site and cannot install
 status collapsed
 
 \begin_layout Plain Layout
-
-UserDir
-/doc/
+UserDir/doc/
 \end_layout
 
 \end_inset
@@ -1249,8 +1175,7 @@ Invoking LyX with the command line switch
 status collapsed
 
 \begin_layout Plain Layout
--
-userdir
+-userdir
 \end_layout
 
 \end_inset
@@ -1266,8 +1191,7 @@ userdir
 status collapsed
 
 \begin_layout Plain Layout
--
-userdir
+-userdir
 \end_layout
 
 \end_inset
@@ -1283,10 +1207,7 @@ userdir
 status collapsed
 
 \begin_layout Plain Layout
-LYX_
-USERDIR
-_
-VER
+LYX_USERDIR_VER
 \end_layout
 
 \end_inset
@@ -1301,9 +1222,7 @@ Having several configurations also requires more maintenance: if you want
 status collapsed
 
 \begin_layout Plain Layout
-
-NewUserDir
-/layouts
+NewUserDir/layouts
 \end_layout
 
 \end_inset
@@ -1311,15 +1230,10 @@ NewUserDir
  which you want available from all your configurations, you must add it
  to each directory separately.
  You can avoid this with the following trick: after LyX creates the additional
- directory, most of the 
-subdirectories
- (see above) are empty.
+ directory, most of the subdirectories (see above) are empty.
  If you want the new configuration to mirror an existing one, replace the
- empty 
-subdirectory
- with a symbolic link to the matching 
-subdirectory
- in the existing configuration.
+ empty subdirectory with a symbolic link to the matching subdirectory in
+ the existing configuration.
  Take care with the 
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -1330,10 +1244,8 @@ doc/
 
 \end_inset
 
-subdirectory
-, however, since it contains a file written by the configuration script
- (also accessible through 
+ subdirectory, however, since it contains a file written by the configuration
+ script (also accessible through 
 \begin_inset Flex CharStyle:MenuItem
 status collapsed
 
@@ -1498,7 +1410,6 @@ Editor
 status collapsed
 
 \begin_layout Plain Layout
-
 Ghostview
 \end_layout
 
@@ -1585,7 +1496,6 @@ View
 status collapsed
 
 \begin_layout Plain Layout
-
 png
 \end_layout
 
@@ -1597,7 +1507,6 @@ png
 status collapsed
 
 \begin_layout Plain Layout
-
 pdf
 \end_layout
 
@@ -1624,7 +1533,6 @@ Vector graphics format
 status collapsed
 
 \begin_layout Plain Layout
-
 pdflatex
 \end_layout
 
@@ -1636,7 +1544,6 @@ pdflatex
 status collapsed
 
 \begin_layout Plain Layout
-
 pdf
 \end_layout
 
@@ -1647,7 +1554,6 @@ pdf
 status collapsed
 
 \begin_layout Plain Layout
-
 png
 \end_layout
 
@@ -1658,7 +1564,6 @@ png
 status collapsed
 
 \begin_layout Plain Layout
-
 jpg
 \end_layout
 
@@ -1669,7 +1574,6 @@ jpg
 status collapsed
 
 \begin_layout Plain Layout
-
 pdflatex
 \end_layout
 
@@ -1681,7 +1585,6 @@ pdflatex
 status collapsed
 
 \begin_layout Plain Layout
-
 pdf
 \end_layout
 
@@ -1692,7 +1595,6 @@ pdf
 status collapsed
 
 \begin_layout Plain Layout
-
 png
 \end_layout
 
@@ -1703,7 +1605,6 @@ png
 status collapsed
 
 \begin_layout Plain Layout
-
 jpg
 \end_layout
 
@@ -1714,7 +1615,6 @@ jpg
 status collapsed
 
 \begin_layout Plain Layout
-
 pdf
 \end_layout
 
@@ -1725,7 +1625,6 @@ pdf
 status collapsed
 
 \begin_layout Plain Layout
-
 png
 \end_layout
 
@@ -1832,18 +1731,11 @@ $$l
 
 \end_inset
 
- The `
-LaTeX
-name'
+ The `LaTeX name'
 \end_layout
 
 \begin_layout Standard
-The latter should be the 
-filename
- as it would be used in a 
-LaTeX's
+The latter should be the filename as it would be used in a LaTeX's 
 \series bold
 
 \backslash
@@ -1855,16 +1747,13 @@ include
 
 \begin_layout Standard
 Copiers can be used to do almost anything with output files.
- For example, suppose you want generated 
-pdf
- files to be copied to a special directory, 
+ For example, suppose you want generated pdf files to be copied to a special
+ directory, 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-/home/you/
-pdf
-/
+/home/you/pdf/
 \end_layout
 
 \end_inset
@@ -1905,9 +1794,7 @@ Save it in your local LyX directory—say,
 status collapsed
 
 \begin_layout Plain Layout
-/home/you/.lyx/scripts/
-pdfcopier
-.sh
+/home/you/.lyx/scripts/pdfcopier.sh
 \end_layout
 
 \end_inset
@@ -1940,25 +1827,17 @@ File formats
 status collapsed
 
 \begin_layout Plain Layout
-
-PDF
-(
-pdflatex
-)
+PDF(pdflatex)
 \end_layout
 
 \end_inset
 
- format—or one of the other 
-pdf
- formats—and enter 
+ format—or one of the other pdf formats—and enter 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-pdfcopier
-.sh $$i $$o
+pdfcopier.sh $$i $$o
 \end_layout
 
 \end_inset
@@ -2008,9 +1887,8 @@ HTML
  When these formats are exported, the copier sees that not just the main
  HTML file but various associated files (style files, images, etc.) are also
  copied.
- All these files are written to a 
-subdirectory
- of the directory in which the original LyX file was found.
+ All these files are written to a subdirectory of the directory in which
+ the original LyX file was found.
 \begin_inset Foot
 status collapsed
 
@@ -2044,7 +1922,6 @@ This copier can be customized.
 status collapsed
 
 \begin_layout Plain Layout
-
 LyXconv
 \end_layout
 
@@ -2059,9 +1936,7 @@ LyXconv
 status collapsed
 
 \begin_layout Plain Layout
-/path/to/
-filename
-.lyx
+/path/to/filename.lyx
 \end_layout
 
 \end_inset
@@ -2071,12 +1946,7 @@ filename
 status collapsed
 
 \begin_layout Plain Layout
-/path/to/
-filename
-.
-html
-.
-LyXconv
+/path/to/filename.html.LyXconv
 \end_layout
 
 \end_inset
@@ -2216,9 +2086,7 @@ $$b
 
 \end_inset
 
- The base 
-filename
- of the input file (i.
+ The base filename of the input file (i.
 \begin_inset space \thinspace{}
 \end_inset
 
@@ -2283,12 +2151,8 @@ latex
 
 \end_inset
 
- This converter runs some form of 
-LaTeX
-.
- This will make LyX's 
-LaTeX
- error logs available.
+ This converter runs some form of LaTeX.
+ This will make LyX's LaTeX error logs available.
 \end_layout
 
 \begin_layout Labeling
@@ -2297,15 +2161,12 @@ LaTeX
 status collapsed
 
 \begin_layout Plain Layout
-
 needaux
 \end_layout
 
 \end_inset
 
- Needs the 
-LaTeX
+ Needs the LaTeX 
 \begin_inset Flex CharStyle:MenuItem
 status collapsed
 
@@ -2324,7 +2185,6 @@ status collapsed
 status collapsed
 
 \begin_layout Plain Layout
-
 xml
 \end_layout
 
@@ -2362,7 +2222,6 @@ value
 status collapsed
 
 \begin_layout Plain Layout
-
 parselog
 \end_layout
 
@@ -2373,9 +2232,7 @@ parselog
 status collapsed
 
 \begin_layout Plain Layout
-
-infile
-.out
+infile.out
 \end_layout
 
 \end_inset
@@ -2385,11 +2242,7 @@ infile
 status collapsed
 
 \begin_layout Plain Layout
-script < 
-infile
-.out > 
-infile
-.log
+script < infile.out > infile.log
 \end_layout
 
 \end_inset
@@ -2414,7 +2267,6 @@ $$s
 status collapsed
 
 \begin_layout Plain Layout
-
 resultdir
 \end_layout
 
@@ -2439,11 +2291,7 @@ $$b
 \begin_inset Newline newline
 \end_inset
 
-Note that 
-resultdir
- and 
-usetempdir
- make no sense together.
+Note that resultdir and usetempdir make no sense together.
  The latter will be ignored if the former is given.
 \end_layout
 
@@ -2453,7 +2301,6 @@ usetempdir
 status collapsed
 
 \begin_layout Plain Layout
-
 resultfile
 \end_layout
 
@@ -2470,11 +2317,8 @@ $$b
 \end_inset
 
 .
- Sensible only with 
-resultdir
- and optional even then; if not given, it defaults to `
-index'
-.
+ Sensible only with resultdir and optional even then; if not given, it defaults
+ to `index'.
 \end_layout
 
 \begin_layout Standard
@@ -2486,34 +2330,21 @@ None of these last three are presently used in any of the converters that
 \begin_layout Standard
 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 for this) which is then converted
- to DVI using the `
-LaTeX
- to 
-DVI'
- converter, and finally converting the resulting DVI file to PostScript.
- LyX finds such `
-chains'
- of converters automatically, and it will always choose the shortest possible
- chain.
+ 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
+ for this) which is then converted to DVI using the `LaTeX to DVI' converter,
+ and finally converting the resulting DVI file to PostScript.
+ LyX finds such `chains' of converters automatically, and it will always
+ choose the shortest possible chain.
  You can, though, still define multiple conversion methods between file
  formats.
  For example, the standard LyX configuration provides three ways to convert
-LaTeX
- to 
-PDF
-: Directly, using 
+ LaTeX to PDF: Directly, using 
 \begin_inset Flex CharStyle:MenuItem
 status collapsed
 
 \begin_layout Plain Layout
-
 pdflatex
 \end_layout
 
@@ -2524,7 +2355,6 @@ pdflatex
 status collapsed
 
 \begin_layout Plain Layout
-
 ps2pdf
 \end_layout
 
@@ -2535,7 +2365,6 @@ ps2pdf
 status collapsed
 
 \begin_layout Plain Layout
-
 dvipdfm
 \end_layout
 
@@ -2543,9 +2372,7 @@ dvipdfm
 
 .
  To define such alternate chains, you must define multiple target `file
-formats'
-, as described in section 
+ formats', as described in section 
 \begin_inset CommandInset ref
 LatexCommand ref
 reference "sec:Formats"
@@ -2558,7 +2385,6 @@ reference "sec:Formats"
 status collapsed
 
 \begin_layout Plain Layout
-
 pdf
 \end_layout
 
@@ -2569,7 +2395,6 @@ pdf
 status collapsed
 
 \begin_layout Plain Layout
-
 pdf2
 \end_layout
 
@@ -2580,7 +2405,6 @@ pdf2
 status collapsed
 
 \begin_layout Plain Layout
-
 pdf3
 \end_layout
 
@@ -2591,8 +2415,7 @@ pdf3
 status collapsed
 
 \begin_layout Plain Layout
-.
-pdf
+.pdf
 \end_layout
 
 \end_inset
@@ -2672,7 +2495,6 @@ LyX uses the GNU
 status collapsed
 
 \begin_layout Plain Layout
-
 gettext
 \end_layout
 
@@ -2685,7 +2507,6 @@ gettext
 status collapsed
 
 \begin_layout Plain Layout
-
 po
 \end_layout
 
@@ -2719,7 +2540,6 @@ mo
 status collapsed
 
 \begin_layout Plain Layout
-
 gettext
 \end_layout
 
@@ -2729,9 +2549,8 @@ gettext
  It is possible to do this just for yourself, but if you're going to do
  it, you might as well share the results of your labors with the rest of
  the LyX community.
- Send a message to the LyX 
-developers'
- list for more information about how to proceed.
+ Send a message to the LyX developers' list for more information about how
+ to proceed.
 \end_layout
 
 \begin_layout Standard
@@ -2767,8 +2586,7 @@ lyx.pot
 status collapsed
 
 \begin_layout Plain Layout
-**.
-po
+**.po
 \end_layout
 
 \end_inset
@@ -2779,8 +2597,7 @@ po
 status collapsed
 
 \begin_layout Plain Layout
-xx.
-po
+xx.po
 \end_layout
 
 \end_inset
@@ -2806,9 +2623,8 @@ make lyx.pot
 
 \end_inset
 
- in that directory, or you can use an existing 
-po
--file for some other language as a template).
+ in that directory, or you can use an existing po-file for some other language
+ as a template).
 \end_layout
 
 \begin_layout Itemize
@@ -2817,8 +2633,7 @@ Edit
 status collapsed
 
 \begin_layout Plain Layout
-xx.
-po
+xx.po
 \end_layout
 
 \end_inset
@@ -2838,21 +2653,16 @@ Poedit
 \family typewriter
 KBabel
 \family default
- (for 
-KDE
-).
+ (for KDE).
  
 \family typewriter
 Emacs
 \family default
- contains a `
-mode'
- for editing 
+ contains a `mode' for editing 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
 po
 \end_layout
 
@@ -2873,7 +2683,6 @@ po
 status collapsed
 
 \begin_layout Plain Layout
-
 po
 \end_layout
 
@@ -2904,10 +2713,7 @@ xx.mo
 status collapsed
 
 \begin_layout Plain Layout
-
-msgfmt
- -o xx.mo < xx.
-po
+msgfmt -o xx.mo < xx.po
 \end_layout
 
 \end_inset
@@ -2970,7 +2776,6 @@ As said, however, it would be best if the new
 status collapsed
 
 \begin_layout Plain Layout
-
 po
 \end_layout
 
@@ -2978,9 +2783,8 @@ po
 
 -file could be added to the LyX distribution, so others can use it.
  Adding it involves making additional changes to LyX.
- So send an email to the 
-developers'
- mailing list if you're interested in doing that.
+ So send an email to the developers' mailing list if you're interested in
+ doing that.
 \end_layout
 
 \begin_layout Subsubsection
@@ -3022,7 +2826,6 @@ to
 status collapsed
 
 \begin_layout Plain Layout
-
 gettext
 \end_layout
 
@@ -3045,11 +2848,7 @@ To
 status collapsed
 
 \begin_layout Plain Layout
-To[[as in 
-'From
- format x to format 
-y'
-]]
+To[[as in 'From format x to format y']]
 \end_layout
 
 \end_inset
@@ -3059,11 +2858,7 @@ y'
 status collapsed
 
 \begin_layout Plain Layout
-To[[as in 
-'From
- page x to page 
-y'
-]].
+To[[as in 'From page x to page y']].
 \end_layout
 
 \end_inset
@@ -3083,7 +2878,6 @@ To
 status collapsed
 
 \begin_layout Plain Layout
-
 gettext
 \end_layout
 
@@ -3177,21 +2971,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
@@ -3231,11 +3010,7 @@ status collapsed
 
 \begin_layout Plain Layout
 Help\SpecialChar \menuseparator
-
-\bar under
-I
-\bar default
-ntroduction
+Introduction
 \end_layout
 
 \end_inset
@@ -6159,13 +5934,7 @@ Settings
 \end_inset
 
 .
-\change_inserted 0 1243500588
-
-\end_layout
-
-\begin_layout Standard
-The argument in square brackets is optional: It declares any LaTeX packages
+ 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.
@@ -6179,15 +5948,11 @@ The list of such packages is documented only in the source code.
 \end_inset
 
  LyX will not check for arbitrary packages.
-
-\change_inserted 0 1243500694
  It is also possible to use the form 
 \begin_inset Flex CharStyle:MenuItem
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted 0 1243500706
 from->to
 \end_layout
 
@@ -6195,8 +5960,6 @@ from->to
 
 , which declares that the module can only be used when there exists a conversion
  chain between formats `from' and `to'.
-\change_unchanged
-
 \end_layout
 
 \begin_layout Standard
@@ -7519,27 +7282,6 @@ NoStyle
 status collapsed
 
 \begin_layout Plain Layout
-OutputType
-\end_layout
-
-\end_inset
-
- A string indicating what sort of output documents using this class will
- produce.
- At present, the options are: `docbook', `latex', and `literate'.
-\change_inserted 0 1243500198
-
-\end_layout
-
-\begin_layout Description
-
-\change_inserted 0 1243500505
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted 0 1243500208
 OutputFormat
 \end_layout
 
@@ -7552,8 +7294,6 @@ OutputFormat
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted 0 1243500394
 OutputType
 \end_layout
 
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted 0 1243500473
 OutputType
 \end_layout
 
 \end_inset
 
  parameter is encountered.
-\change_unchanged
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
 
+\begin_layout Plain Layout
+OutputType
+\end_layout
+
+\end_inset
+
+ A string indicating what sort of output documents using this class will
+ produce.
+ At present, the options are: `docbook', `latex', and `literate'.
 \end_layout
 
 \begin_layout Description
@@ -8528,84 +8279,174 @@ block
 status collapsed
 
 \begin_layout Plain Layout
-BottomSep
+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
-float=0
+BabelPreamble
 \end_layout
 
 \end_inset
 
-]
-\begin_inset Foot
+ declarations.
+ Must end with 
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Note that a `float' here is a real number, such as: 1.5.
+EndBabelPreamble
 \end_layout
 
 \end_inset
 
- The vertical space with which the last of a chain of paragraphs with this
- layout is separated from the following paragraph.
- If the next paragraph has another layout, the separations are not simply
- added, but the maximum is taken.
+
+\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_layout Description
+\begin_deeper
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Category
+$$lang
 \end_layout
 
 \end_inset
 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-[string]
+ is replaced by the language name (as used by the babel package).
 \end_layout
 
+\begin_layout Itemize
+The 
+\begin_inset Quotes eld
 \end_inset
 
- The category for this style.
- This is used to group related styles in the Layout combobox on the toolbar.
- Any string can be used, but you may want to use existing categories with
- your own styles.
-\end_layout
+Function
+\begin_inset Quotes erd
+\end_inset
 
-\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-CommandDepth
+_()
 \end_layout
 
 \end_inset
 
- Depth of XML command.
Used only with XML-type formats.
+ 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
-CopyStyle
+BottomSep
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+float=0
+\end_layout
+
+\end_inset
+
+]
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+Note that a `float' here is a real number, such as: 1.5.
+\end_layout
+
+\end_inset
+
+ The vertical space with which the last of a chain of paragraphs with this
+ layout is separated from the following paragraph.
+ If the next paragraph has another layout, the separations are not simply
+ added, but the maximum is taken.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+Category
+\end_layout
+
+\end_inset
+
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+[string]
+\end_layout
+
+\end_inset
+
+ The category for this style.
+ This is used to group related styles in the Layout combobox on the toolbar.
+ Any string can be used, but you may want to use existing categories with
+ your own styles.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+CommandDepth
+\end_layout
+
+\end_inset
+
+ Depth of XML command.
+ Used only with XML-type formats.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+CopyStyle
 \end_layout
 
 \end_inset
@@ -9062,331 +8903,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
+[1, 0]
+\end_layout
 
+\end_inset
 
+ 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
-EndBabelPreamble
+TitleLatexType
 \end_layout
 
 \end_inset
 
+ and 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+TitleLatexName
+\end_layout
 
-\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:
+ global entries).
 \end_layout
 
-\begin_deeper
-\begin_layout Itemize
+\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-$$lang
+ItemSep
 \end_layout
 
 \end_inset
 
- is replaced by the language name (as used by the babel package).
-\end_layout
+ [
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-\begin_layout Itemize
-The 
-\begin_inset Quotes eld
-\end_inset
+\begin_layout Plain Layout
+float=0
+\end_layout
 
-Function
-\begin_inset Quotes erd
 \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
 \end_layout
 
 \end_inset
 
- replaces its argument by the translation of the argument to the current
- language.
+.
+ 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_layout Standard
-This preamble snippet will only be used if the document contains more than
- one language and the babel package is used.
+\end_inset
+
+.
+ Note that this is a
+\emph on
+ multiplier.
 \end_layout
 
-\end_deeper
 \begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LangPreamble
+ItemTag
 \end_layout
 
 \end_inset
 
- Like 
+ [[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
 
-, but this preamble snippet occurs independently from the babel package,
- and only for the document language.
- Must end with 
-\begin_inset Quotes eld
+\begin_inset CommandInset label
+LatexCommand label
+name "des:KeepEmpty"
+
 \end_inset
 
+[
+\emph on
 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-EndLangPreamble
+
+\emph on
+0
 \end_layout
 
 \end_inset
 
 
-\begin_inset Quotes erd
+\emph default
+, 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+1
+\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.
 \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
+LabelBottomsep
 \end_layout
 
 \end_inset
 
- and 
+ [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
-BabelPreamble
+Top_Environment
 \end_layout
 
 \end_inset
 
- 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
-theorems-ams.inc
+Centered_Top_Environment
 \end_layout
 
 \end_inset
 
- file) shows how this works:
+).
 \end_layout
 
-\begin_layout LyX-Code
-Preamble
-\end_layout
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-\begin_layout LyX-Code
-  
-\backslash
-theoremstyle{remark}
+\begin_layout Plain Layout
+LabelCounter
 \end_layout
 
-\begin_layout LyX-Code
-  
-\backslash
-newtheorem{claim}[thm]{
-\backslash
-protect
-\backslash
-claimname}
-\end_layout
+\end_inset
 
-\begin_layout LyX-Code
-EndPreamble
-\end_layout
+ [
+\begin_inset Flex CharStyle:Code
+status collapsed
 
-\begin_layout LyX-Code
-LangPreamble
+\begin_layout Plain Layout
+string=""
 \end_layout
 
-\begin_layout LyX-Code
-  
-\backslash
-providecommand{
-\backslash
-claimname}{_(Claim)}
-\end_layout
-
-\begin_layout LyX-Code
+\end_inset
 
-\end_layout
+]
+\begin_inset Newline newline
+\end_inset
 
-\begin_layout LyX-Code
-EndLangPreamble
-\end_layout
+The name of the counter for automatic numbering.
+\begin_inset Newline newline
+\end_inset
 
-\begin_layout LyX-Code
-BabelPreamble
-\end_layout
+This 
+\emph on
+must
+\emph default
+ be given if 
+\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
+LabelType
 \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 
+ is 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\backslash
-claimname
+Counter
 \end_layout
 
 \end_inset
 
- in the language preamble.
- This command holds the name of the theorem that will appear in the output.
- The 
+.
+ 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
-BabelPreamble
+LabelType
 \end_layout
 
 \end_inset
 
- then uses the commands offered by the babel package to redefine 
+ is 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\backslash
-claimname
+Enumerate
 \end_layout
 
 \end_inset
 
- for each used language in multilanguage documents.
-\end_layout
+, though this case is a bit complicated.
+ Suppose you declare 
+\begin_inset Quotes eld
+\end_inset
+
 
-\end_deeper
-\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-InnerTag
+LabelCounter myenum
 \end_layout
 
 \end_inset
 
- [[FIXME]] (Used only with XML-type formats.)
-\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
-InTitle
+myenumi
 \end_layout
 
 \end_inset
 
+, 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-[1, 0]
+myenumii
 \end_layout
 
 \end_inset
 
- 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
-TitleLatexType
+myenumiii
 \end_layout
 
 \end_inset
 
- and 
+, and 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-TitleLatexName
+myenumiv
 \end_layout
 
 \end_inset
 
- global entries).
+, 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
@@ -9394,49 +9265,61 @@ TitleLatexName
 status collapsed
 
 \begin_layout Plain Layout
-ItemSep
+LabelFont
 \end_layout
 
 \end_inset
 
- [
+ 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
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-float=0
+LabelIndent
 \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 
+ 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
-Parsep
+Labelsep
 \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
+string=""
 \end_layout
 
 \end_inset
 
-.
- Note that this is a
-\emph on
- multiplier.
+] 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
@@ -9444,97 +9327,106 @@ Itemsep
 status collapsed
 
 \begin_layout Plain Layout
-ItemTag
+LabelString
 \end_layout
 
 \end_inset
 
- [[FIXME]] (Used only with XML-type formats.)
-\end_layout
-
-\begin_layout Description
+ [
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-KeepEmpty
+string=""
 \end_layout
 
 \end_inset
 
-\begin_inset CommandInset label
-LatexCommand label
-name "des:KeepEmpty"
-
-\end_inset
-
-[
-\emph on
-
+] The string used for a label with a 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\emph on
-0
+Static
 \end_layout
 
 \end_inset
 
-
-\emph default
-, 
+ labeltype.
+ When 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-1
+LabelCounter
 \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.
-\end_layout
+ is set, this string can be contain the special formatting commands described
+ in Section 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Counters"
 
-\begin_layout Description
+\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
-LabelBottomsep
+@
+\emph on
+style-name
+\emph default
+@
 \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 (
+ will be replaced by the expanded 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Top_Environment
+LabelString
 \end_layout
 
 \end_inset
 
-, 
+ of style 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Centered_Top_Environment
+
+\emph on
+style-name
 \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 "sub:Counters"
+
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Description
@@ -9542,7 +9434,7 @@ Centered_Top_Environment
 status collapsed
 
 \begin_layout Plain Layout
-LabelCounter
+LabelStringAppendix
 \end_layout
 
 \end_inset
@@ -9557,64 +9449,38 @@ string=""
 
 \end_inset
 
-]
-\begin_inset Newline newline
-\end_inset
-
-The name of the counter for automatic numbering (see Section 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sub:Counters"
-
-\end_inset
-
- for details).
- This must be given if 
+] This is used inside the appendix instead of 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Labeltype
+LabelString
 \end_layout
 
 \end_inset
 
- is 
+.
+ Note that every 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Counter
+LabelString
 \end_layout
 
 \end_inset
 
-.
-\end_layout
-
-\begin_layout Description
+ statement resets 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelFont
+LabelStringAppendix
 \end_layout
 
 \end_inset
 
- 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
-
-.
+ too.
 \end_layout
 
 \begin_layout Description
@@ -9622,12 +9488,12 @@ reference "sub:Font-description"
 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
@@ -9635,7 +9501,7 @@ LabelIndent
 status collapsed
 
 \begin_layout Plain Layout
-Labelsep
+LabelType
 \end_layout
 
 \end_inset
@@ -9645,268 +9511,312 @@ 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
 
- [
+ means the label is the very first word (up to the first real blank).
+ Use protected spaces (like
+\begin_inset space ~
+\end_inset
+
+that one) if you want more than one word as the label.
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-string=""
+Static
 \end_layout
 
 \end_inset
 
-] The string used for a label with a 
+ means the label is simply whatever 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Static
+LabelString
 \end_layout
 
 \end_inset
 
- labeltype.
- When 
+ declares it to be.
+ Note that this really is `static'.
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelCounter
+Top_Environment
 \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 "sub:Counters"
-
-\end_inset
-
-.
-\begin_inset Foot
+ and 
+\begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-For the sake of backwards compatibility, the string 
+Centered_Top_Environment
+\end_layout
+
+\end_inset
+
+ are special cases of 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-@
-\emph on
-style-name
-\emph default
-@
+Static
 \end_layout
 
 \end_inset
 
- will be replaced by the expanded 
-\begin_inset Flex CharStyle:Code
+.
+ 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
-LabelString
+Abstract
 \end_layout
 
 \end_inset
 
- of style 
+ layout, for example.
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\emph on
-style-name
+Sensitive
 \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 "sub:Counters"
+ 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
+Sensitive
 \end_layout
 
 \end_inset
 
-
+ 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 Description
+\begin_layout Itemize
+The 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelStringAppendix
+Counter
 \end_layout
 
 \end_inset
 
- [
+ label type defines automatically numbered labels.
+ The 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-string=""
+LabelString
 \end_layout
 
 \end_inset
 
-] This is used inside the appendix instead of 
+ 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
-LabelString
+Section 
+\backslash
+thechapter.
+\backslash
+thesection
 \end_layout
 
 \end_inset
 
-.
- Note that every 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-LabelString
+
+\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
 
-\end_inset
-
- statement resets 
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-LabelStringAppendix
+Enumerate
 \end_layout
 
 \end_inset
 
- too.
+ 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
-LabelTag
+Itemize
 \end_layout
 
 \end_inset
 
- [FIXME] (Used only with XML-type formats.)
+ produces various bullets at the different levels.
+ It is also hardcoded.
 \end_layout
 
-\begin_layout Description
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Labeltype
+Bibliography
 \end_layout
 
 \end_inset
 
- [
+ is used internally by LyX and should be used only with 
 \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
+LatexType BibEnvironment
 \end_layout
 
 \end_inset
 
-] 
-\begin_inset Newline newline
-\end_inset
-
+.
+\end_layout
 
+\end_deeper
+\begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Manual
+LangPreamble
 \end_layout
 
 \end_inset
 
- means the label is the very first word (up to the first real blank).
-\begin_inset Foot
+ Like 
+\begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Use protected spaces if you want more than one word as the label.
+BabelPreamble
 \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
+
+
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-Static
+EndLangPreamble
 \end_layout
 
 \end_inset
 
- means it is defined in the layout (see 
-\begin_inset Flex CharStyle:Code
-status collapsed
-
-\begin_layout Plain Layout
-LabelString
-\end_layout
 
+\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
@@ -9916,125 +9826,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 "sub:Counters"
+\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
@@ -10109,13 +10025,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
 
@@ -10127,6 +10066,9 @@ Paragraph
 
  means nothing special.
  
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10153,7 +10095,10 @@ LatexName
 
 \end_inset
 
- and 
+.
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10188,6 +10133,9 @@ LatexName
 
 .
  
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10207,7 +10155,7 @@ Environment
 
 \end_inset
 
-, except that a 
+, except that an 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10221,6 +10169,9 @@ item
 
  is generated for each paragraph of this environment.
  
+\end_layout
+
+\begin_layout Itemize
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -10282,19 +10233,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
@@ -10325,6 +10263,7 @@ end{latexname}.
 depending upon the LaTeX type.
 \end_layout
 
+\end_deeper
 \begin_layout Description
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -10347,7 +10286,8 @@ string=""
 
 ] If you put layouts into environments, the leftmargins are not simply added,
  but added with a factor 
-\begin_inset Formula $\frac{4}{depth+4}$
+\begin_inset Formula $\frac{4}{depth+4}
+$
 \end_inset
 
 .
@@ -11409,6 +11349,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
@@ -11506,6 +11447,7 @@ string
 \end_inset
 
 ] The heading used for the list of floats.
+ This is translated to the document language.
 \end_layout
 
 \begin_layout Description
@@ -12220,7 +12162,6 @@ URL
 \end_inset
 
 .
 \end_layout
 
 \begin_layout Enumerate