]> git.lyx.org Git - features.git/blobdiff - lib/doc/Customization.lyx
Allow to separate menu string from label string for arguments
[features.git] / lib / doc / Customization.lyx
index f97cd15e4f2b3da879b81c09d1811223f94d0f7b..e034ea0aa10d4375c9602762744f521f5481bb8b 100644 (file)
@@ -1,5 +1,5 @@
-#LyX 2.0 created this file. For more info see http://www.lyx.org/
-\lyxformat 413
+#LyX 2.1 created this file. For more info see http://www.lyx.org/
+\lyxformat 452
 \begin_document
 \begin_header
 \textclass scrbook
@@ -68,13 +68,13 @@ End
 \font_roman default
 \font_sans default
 \font_typewriter default
+\font_math auto
 \font_default_family default
 \use_non_tex_fonts false
 \font_sc false
 \font_osf false
 \font_sf_scale 100
 \font_tt_scale 100
-
 \graphics default
 \default_output_format default
 \output_sync 0
@@ -99,15 +99,21 @@ End
 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue,pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
 \papersize default
 \use_geometry false
-\use_amsmath 0
-\use_esint 0
-\use_mhchem 0
-\use_mathdots 1
+\use_package amsmath 0
+\use_package amssymb 0
+\use_package esint 0
+\use_package mathdots 1
+\use_package mathtools 0
+\use_package mhchem 0
+\use_package undertilde 0
 \cite_engine basic
+\cite_engine_type numerical
+\biblio_style plain
 \use_bibtopic false
 \use_indices false
 \paperorientation portrait
 \suppress_date false
+\justification true
 \use_refstyle 0
 \branch OutDated
 \selected 0
@@ -131,7 +137,13 @@ End
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict true
+\author -712698321 "Jürgen Spitzmüller" 
 \author -195340706 "Georg Baum" 
+\author 5863208 "ab" 
+\author 155139281 "Jrgen Spitzmller" 
+\author 1082167584 "Kayvan Sylvan" kayvan@sylvan.com
+\author 1414654397 "Richard Heck" 
+\author 2090807402 "usti" 
 \end_header
 
 \begin_body
@@ -978,6 +990,40 @@ languages
 \end_inset
 
  this file contains a list of all the languages currently supported by LyX.
+\change_inserted -195340706 1334775793
+
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\change_inserted -195340706 1334775793
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -195340706 1334775793
+layouttranslations
+\end_layout
+
+\end_inset
+
+ this file contains translations for internationalized paragraph styles
+ (see sec.
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:I18n"
+
+\end_inset
+
+).
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -1772,6 +1818,36 @@ $$o
 \end_inset
 
  The output file
+\change_inserted 1082167584 1348453985
+
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\change_inserted 1082167584 1348453986
+$$b The base name (without filename extension) in the LyX temporary directory
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\change_inserted 1082167584 1348453986
+$$p The full directory path of the LyX temporary directory
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\change_inserted 1082167584 1348453986
+$$r The full pathname to the original LyX file being processed
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\change_inserted 1082167584 1348453986
+$$f The filename (without any directory path) of the LyX file.
 \end_layout
 
 \begin_layout Labeling
@@ -1786,6 +1862,8 @@ $$l
 \end_inset
 
  The `LaTeX name'
+\change_inserted 1082167584 1348453720
+
 \end_layout
 
 \begin_layout Standard
@@ -2245,6 +2323,53 @@ status collapsed
 \end_inset
 
  file for the conversion.
+\change_inserted 1414654397 1337693117
+
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\change_inserted 1414654397 1337693188
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 1414654397 1337693129
+nice
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ Needs a 
+\begin_inset Quotes eld
+\end_inset
+
+nice
+\begin_inset Quotes erd
+\end_inset
+
+ file from the backend, which in practice means a LaTeX file like the one
+ we would export, without 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 1414654397 1337693184
+input@path
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Labeling
@@ -5299,7 +5424,7 @@ name "cha:Installing-New-Document"
 \end_inset
 
 
-\begin_inset Argument
+\begin_inset Argument 1
 status collapsed
 
 \begin_layout Plain Layout
@@ -7112,6 +7237,10 @@ default
 
 \begin_layout Subsection
 The document class declaration
+\change_inserted -712698321 1349766602
+ and classification
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -7137,7 +7266,15 @@ status collapsed
 
 \end_inset
 
- files should begin with a line like:
+ files should begin with 
+\change_deleted -712698321 1349766533
+a 
+\change_unchanged
+line
+\change_inserted -712698321 1349766536
+s
+\change_unchanged
+ like:
 \end_layout
 
 \begin_layout LyX-Code
@@ -7151,11 +7288,45 @@ status collapsed
 \size small
 #  
 \backslash
-DeclareLaTeXClass{article}
+DeclareLaTeXClass{
+\change_deleted -712698321 1349766193
+article
+\change_inserted -712698321 1349766201
+Article (Standard Class)
+\change_unchanged
+}
+\change_inserted -712698321 1349766538
+
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -712698321 1349766581
+
+\size small
+#  
+\backslash
+DeclareCategory{Articles}
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
-The second line is used when you (re)configure LyX.
+The second 
+\change_inserted -712698321 1349766695
+and third 
+\change_unchanged
+line
+\change_inserted -712698321 1349766626
+s
+\change_unchanged
+\change_deleted -712698321 1349766628
+is
+\change_inserted -712698321 1349766628
+are
+\change_unchanged
+ used when you (re)configure LyX.
  The layout file is read by the LaTeX script 
 \begin_inset Flex Code
 status collapsed
@@ -7177,8 +7348,19 @@ status collapsed
 \end_inset
 
  is ignored.
- The first line is just a LaTeX comment, and the second one contains the
- declaration of the text class.
+ The first line is just a LaTeX comment, 
+\change_deleted -712698321 1349766656
+and 
+\change_unchanged
+the second one contains the 
+\change_inserted -712698321 1349766650
+mandatory 
+\change_unchanged
+declaration of the text class
+\change_inserted -712698321 1349766689
+, and the third line contains the optional classification of the class
+\change_unchanged
+.
  If these lines appear in a file named 
 \begin_inset Flex Code
 status collapsed
@@ -7214,7 +7396,13 @@ article.cls
 \begin_inset Quotes eld
 \end_inset
 
+
+\change_deleted -712698321 1349766253
 article
+\change_inserted -712698321 1349766260
+Article (Standard Class)
+\change_unchanged
+
 \begin_inset Quotes erd
 \end_inset
 
@@ -7230,6 +7418,90 @@ Settings
 \end_inset
 
  dialog.
+
+\change_inserted -712698321 1349767097
+ The category (
+\begin_inset Quotes eld
+\end_inset
+
+Articles
+\begin_inset Quotes erd
+\end_inset
+
+ in the example) is also used in the 
+\begin_inset Flex MenuItem
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1349766801
+Document\SpecialChar \menuseparator
+Settings
+\end_layout
+
+\end_inset
+
+ dialog: the text classes are grouped by these categories (which are usually
+ genres, so typical categories are 
+\begin_inset Quotes eld
+\end_inset
+
+Articles
+\begin_inset Quotes erd
+\end_inset
+
+, 
+\begin_inset Quotes eld
+\end_inset
+
+Books
+\begin_inset Quotes erd
+\end_inset
+
+, 
+\begin_inset Quotes eld
+\end_inset
+
+Reports
+\begin_inset Quotes erd
+\end_inset
+
+, 
+\begin_inset Quotes eld
+\end_inset
+
+Letters
+\begin_inset Quotes erd
+\end_inset
+
+, 
+\begin_inset Quotes eld
+\end_inset
+
+Presentations
+\begin_inset Quotes erd
+\end_inset
+
+, 
+\begin_inset Quotes eld
+\end_inset
+
+Curricula Vitae
+\begin_inset Quotes erd
+\end_inset
+
+ etc.).
+ If no category has been declared, the class will be put in the 
+\begin_inset Quotes eld
+\end_inset
+
+Uncategorized
+\begin_inset Quotes erd
+\end_inset
+
+ group.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -7268,7 +7540,45 @@ myarticle.layout
 \size small
 #  
 \backslash
-DeclareLaTeXClass[article]{article (with my own headings)}
+DeclareLaTeXClass[article]{
+\change_deleted -712698321 1349766303
+a
+\change_inserted -712698321 1349766303
+A
+\change_unchanged
+rticle (with 
+\change_deleted -712698321 1349766338
+m
+\change_inserted -712698321 1349766338
+M
+\change_unchanged
+y 
+\change_deleted -712698321 1349766340
+o
+\change_inserted -712698321 1349766340
+O
+\change_unchanged
+wn 
+\change_deleted -712698321 1349766343
+h
+\change_inserted -712698321 1349766343
+H
+\change_unchanged
+eadings)}
+\change_inserted -712698321 1349767223
+
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -712698321 1349767223
+
+\size small
+#  
+\backslash
+DeclareCategory{Articles}
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -7296,7 +7606,31 @@ article.cls
 \begin_inset Quotes eld
 \end_inset
 
-article (with my own headings)
+
+\change_deleted -712698321 1349766329
+a
+\change_inserted -712698321 1349766329
+A
+\change_unchanged
+rticle (with 
+\change_deleted -712698321 1349766347
+m
+\change_inserted -712698321 1349766347
+M
+\change_unchanged
+y 
+\change_deleted -712698321 1349766350
+o
+\change_inserted -712698321 1349766350
+O
+\change_unchanged
+wn 
+\change_deleted -712698321 1349766352
+h
+\change_inserted -712698321 1349766352
+H
+\change_unchanged
+eadings)
 \begin_inset Quotes erd
 \end_inset
 
@@ -7315,7 +7649,45 @@ article (with my own headings)
 \size small
 #  
 \backslash
-DeclareLaTeXClass[article,foo.sty]{article (with my own headings)}
+DeclareLaTeXClass[article,foo.sty]{
+\change_deleted -712698321 1349766366
+a
+\change_inserted -712698321 1349766366
+A
+\change_unchanged
+rticle (with 
+\change_deleted -712698321 1349766369
+m
+\change_inserted -712698321 1349766369
+M
+\change_unchanged
+y 
+\change_deleted -712698321 1349766371
+o
+\change_inserted -712698321 1349766371
+O
+\change_unchanged
+wn 
+\change_deleted -712698321 1349766374
+h
+\change_inserted -712698321 1349766374
+H
+\change_unchanged
+eadings)}
+\change_inserted -712698321 1349767240
+
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -712698321 1349767240
+
+\size small
+#  
+\backslash
+DeclareCategory{Articles}
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -7345,7 +7717,27 @@ foo.sty
 \size small
 # 
 \backslash
-DeclareDocBookClass[article]{SGML (DocBook article)}
+DeclareDocBookClass[article]{SGML (DocBook 
+\change_deleted -712698321 1349766387
+a
+\change_inserted -712698321 1349766387
+A
+\change_unchanged
+rticle)}
+\change_inserted -712698321 1349767247
+
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -712698321 1349767302
+
+\size small
+# 
+\backslash
+DeclareCategory{Articles (DocBook)}
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -7363,6 +7755,20 @@ So, to be as explicit as possible, the form of the layout declaration is:
 #  
 \backslash
 DeclareLaTeXClass[class,package.sty]{layout description}
+\change_inserted -712698321 1349767329
+
+\end_layout
+
+\begin_layout LyX-Code
+
+\change_inserted -712698321 1349767339
+
+\size small
+#  
+\backslash
+DeclareCategory{category}
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -9808,63 +10214,861 @@ block
  (Some LaTeX styles prohibit certain alignments, since those wouldn't make
  sense.
  For example a right-aligned or centered enumeration isn't possible.)
+\change_inserted -712698321 1353679769
+
 \end_layout
 
 \begin_layout Description
+
+\change_inserted -712698321 1353680268
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-BabelPreamble
+
+\change_inserted -712698321 1353679781
+Argument
 \end_layout
 
 \end_inset
 
- Note that this will completely override any prior 
+ [
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-BabelPreamble
-\end_layout
 
-\end_inset
+\change_inserted -712698321 1353679772
+int
+\end_layout
 
- declaration for this style.
- Must end with 
-\begin_inset Quotes eld
 \end_inset
 
-
+] Defines argument number <int> of a command\SpecialChar \slash{}
+environment associated with
+ the current style.
+ This is useful for things like section headings, and only makes sense with
+ LaTeX.
+ Every (optional or required) argument of a command or environment -- except
+ for the required argument that is associated with the content of the paragraph
+ itself -- has a separate definition, where the number specifies the order
+ of the arguments.
+ The definition must end with 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-EndBabelPreamble
-\end_layout
-
-\end_inset
 
+\change_inserted -712698321 1353680069
+EndArgument
+\end_layout
 
-\begin_inset Quotes erd
 \end_inset
 
 .
- See section 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sub:I18n"
+ So a command with two optional arguments has:
+\end_layout
 
-\end_inset
+\begin_deeper
+\begin_layout Quote
 
- for details on its use.
+\change_inserted -712698321 1353680127
+
+\family typewriter
+Argument 1
 \end_layout
 
-\begin_layout Description
-\begin_inset Flex Code
-status collapsed
+\begin_layout Quote
 
-\begin_layout Plain Layout
+\change_inserted -712698321 1353680195
+
+\family typewriter
+...
+\end_layout
+
+\begin_layout Quote
+
+\change_inserted -712698321 1353680135
+
+\family typewriter
+EndArgument
+\end_layout
+
+\begin_layout Quote
+
+\change_inserted -712698321 1353680140
+
+\family typewriter
+Argument 2
+\end_layout
+
+\begin_layout Quote
+
+\change_inserted -712698321 1353680197
+
+\family typewriter
+...
+\end_layout
+
+\begin_layout Quote
+
+\change_inserted -712698321 1353680147
+
+\family typewriter
+EndArgument
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1353680528
+Inside the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680412
+Argument
+\end_layout
+
+\end_inset
+
+ definition, the following specifications are possible:
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1355076779
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680543
+LabelString
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680567
+[string]
+\end_layout
+
+\end_inset
+
+ The string that will appear both in the menu (to insert this argument)
+ and on the argument inset button (unless you also specify a separate 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1355076779
+MenuString
+\end_layout
+
+\end_inset
+
+).
+ For the menu, you can define an accelerator by appending the respective
+ character to the string, divided by 
+\begin_inset Quotes eld
+\end_inset
+
+|
+\begin_inset Quotes erd
+\end_inset
+
+ (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353691482
+\begin_inset Quotes eld
+\end_inset
+
+Short Title|S
+\begin_inset Quotes erd
+\end_inset
+
+
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1355076754
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1355076658
+MenuString
+\end_layout
+
+\end_inset
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1355076654
+[string]
+\end_layout
+
+\end_inset
+
+ A separate string for the menu.
+ You can define an accelerator by appending the respective character to
+ the string, divided by 
+\begin_inset Quotes eld
+\end_inset
+
+|
+\begin_inset Quotes erd
+\end_inset
+
+ (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1355076654
+\begin_inset Quotes eld
+\end_inset
+
+Short Title|S
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+).
+ This specification is optional.
+ If it is not given the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1355076736
+LabelString
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ will be used instead for the menu.
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1353680665
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680616
+Tooltip
+\end_layout
+
+\end_inset
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680623
+[string]
+\end_layout
+
+\end_inset
+
+ A longer explanatory text that appears in the tooltip when hovering over
+ the argument inset.
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1353680874
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680732
+Mandatory
+\end_layout
+
+\end_inset
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680738
+[int=0]
+\end_layout
+
+\end_inset
+
+ Declare if this is a mandatory 
+\change_inserted 2090807402 1353765594
+(1) 
+\change_inserted -712698321 1353680874
+or an optional 
+\change_inserted 2090807402 1353765599
+(0) 
+\change_inserted -712698321 1353680874
+argument.
+ Mandatory arguments will be output empty if not given, while optional arguments
+ will not be output at all.
+ By default, mandatory arguments are delimited by 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680808
+{...}
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+, while optional arguments are delimited by 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680833
+[...]
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1353917199
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680879
+Requires
+\end_layout
+
+\end_inset
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353680874
+[int=0]
+\end_layout
+
+\end_inset
+
+ defines another argument (by its number) which this argument requires to
+ be output if it is itself output.
+ E.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., in LaTeX commands, optional arguments often require previous optional
+ arguments to be output (at least empty), as in 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353688183
+
+\backslash
+command[][arg]{text}
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+.
+ This can be achieved by the statement 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681031
+Requires 1
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ within 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681045
+Argument 2
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1354263104
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681072
+LeftDelim
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681067
+[string]
+\end_layout
+
+\end_inset
+
+ defines a custom left delimiter (instead of 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681127
+{
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ or 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681133
+[
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+).
+ A line break in the output can be indicated by 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354263104
+<br/>
+\end_layout
+
+\end_inset
+
+.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1354263106
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681149
+RightDelim
+\end_layout
+
+\end_inset
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681146
+[string]
+\end_layout
+
+\end_inset
+
+ defines a custom right delimiter (instead of 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681158
+}
+\end_layout
+
+\end_inset
+
+ or 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353681161
+]
+\end_layout
+
+\end_inset
+
+).
+ A line break in the output can be indicated by 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354263106
+<br/>
+\end_layout
+
+\end_inset
+
+.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1353917320
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353917320
+Font
+\end_layout
+
+\end_inset
+
+ The font used for the argument content.
+ See section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Font-description"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1353917320
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353917320
+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 Itemize
+
+\change_inserted -712698321 1353917320
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353917320
+Decoration
+\end_layout
+
+\end_inset
+
+ can be 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353917320
+Classic
+\end_layout
+
+\end_inset
+
+, 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353917320
+Minimalistic
+\end_layout
+
+\end_inset
+
+, or 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353917320
+Conglomerate
+\end_layout
+
+\end_inset
+
+, describing the rendering style used for the inset's frame and buttons.
+ Default is 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353917320
+Classic
+\end_layout
+
+\end_inset
+
+.
+\change_inserted 155139281 1354198988
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 155139281 1354199102
+Arguments for list 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354199013
+
+\backslash
+item
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+s (as in 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354199102
+
+\backslash
+item[foo]
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+) have the prefix 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354199044
+item:
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ followed by the number (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354199064
+Argument item:1
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+)
+\change_unchanged
+
+\end_layout
+
+\end_deeper
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+BabelPreamble
+\end_layout
+
+\end_inset
+
+ Note that this will completely override any prior 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+BabelPreamble
+\end_layout
+
+\end_inset
+
+ declaration for this style.
+ Must end with 
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+EndBabelPreamble
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ See section 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:I18n"
+
+\end_inset
+
+ for details on its use.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
 BottomSep
 \end_layout
 
@@ -11532,31 +12736,75 @@ settings
 Putting the last few things together, the LaTeX output will be either: 
 \end_layout
 
-\begin_layout LyX-Code
+\begin_layout LyX-Code
+
+\backslash
+latexname[latexparam]{\SpecialChar \ldots{}
+}
+\end_layout
+
+\begin_layout Standard
+or: 
+\end_layout
+
+\begin_layout LyX-Code
+
+\backslash
+begin{latexname}[latexparam] \SpecialChar \ldots{}
+\backslash
+end{latexname}.
+\end_layout
+
+\begin_layout Standard
+depending upon the LaTeX type.
+\end_layout
+
+\end_deeper
+\begin_layout Description
+
+\change_inserted -712698321 1354263086
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353866852
+LeftDelim
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353866852
+string
+\end_layout
+
+\end_inset
+
+] A string that is put at the beginning of the style content.
+ A line break in the output can be indicated by 
+\begin_inset Flex Code
+status collapsed
 
-\backslash
-latexname[latexparam]{\SpecialChar \ldots{}
-}
-\end_layout
+\begin_layout Plain Layout
 
-\begin_layout Standard
-or: 
+\change_inserted -712698321 1354263086
+<br/>
 \end_layout
 
-\begin_layout LyX-Code
+\end_inset
 
-\backslash
-begin{latexname}[latexparam] \SpecialChar \ldots{}
-\backslash
-end{latexname}.
-\end_layout
+.
+\change_unchanged
 
-\begin_layout Standard
-depending upon the LaTeX type.
 \end_layout
 
-\end_deeper
 \begin_layout Description
 \begin_inset Flex Code
 status collapsed
@@ -11985,6 +13233,8 @@ ObsoletedBy
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1353679722
 \begin_inset Flex Code
 status collapsed
 
@@ -12015,23 +13265,33 @@ int=0
 \begin_deeper
 \begin_layout LyX-Code
 
+\change_deleted -712698321 1353679722
+
 \backslash
 mycmd[opt1]{req1}{contents of paragraph}
 \end_layout
 
 \begin_layout Standard
+
+\change_deleted -712698321 1353679722
 but one cannot have things like: 
 \end_layout
 
 \begin_layout LyX-Code
 
+\change_deleted -712698321 1353679722
+
 \backslash
 mycmd[opt1]{req1}[opt2]{contents of paragraph}
 \end_layout
 
 \begin_layout Standard
+
+\change_deleted -712698321 1353679722
 at least, not without ERT (with which you can have anything).
  
+\change_unchanged
+
 \end_layout
 
 \end_deeper
@@ -12369,6 +13629,8 @@ string
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1353681258
 \begin_inset Flex Code
 status collapsed
 
@@ -12409,6 +13671,8 @@ OptionalArgs
 \end_inset
 
  tag above for more information.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -12461,6 +13725,128 @@ reference "des:FreeSpacing"
 
 ) for information on `features'.
  
+\change_inserted -712698321 1353693134
+
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1353693371
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353693146
+ResetArgs
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353693235
+
+\emph on
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353693235
+1
+\end_layout
+
+\end_inset
+
+] Resets the LaTeX arguments of this style (as defined via the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353693371
+Argument
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ tag).
+ This is useful if you have copied a style via 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353693302
+CopyStyle
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+, but you do not want to inherit its (required and optional) arguments.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1354263074
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353866876
+RightDelim
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353866873
+string
+\end_layout
+
+\end_inset
+
+] A string that is put at the end of the layout content.
+ A line break in the output can be indicated by 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354263069
+<br/>
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+.
 \end_layout
 
 \begin_layout Description
@@ -13028,8 +14414,25 @@ babel
 
 \begin_layout Standard
 One important point to note here is that the translations are provided by
- LyX itself, through the same mechanism it uses for internationalization
- of the user interface.
+ LyX itself, through the 
+\change_inserted -195340706 1334775793
+file 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -195340706 1334775793
+layouttranslations
+\end_layout
+
+\end_inset
+
+
+\change_deleted -195340706 1334775793
+same mechanism it uses for internationalization of the user interface
+\change_unchanged
+.
  This means, in effect, that 
 \begin_inset Flex Code
 status collapsed
@@ -13052,9 +14455,34 @@ BabelPreamble
 
  are really only of use in layout files that are provided with LyX, since
  text entered in user-created layout files will not be seen by LyX's internation
-alization routines.
+alization routines
+\change_inserted -195340706 1334775793
+ unless the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -195340706 1334775793
+layouttranslations
+\end_layout
+
+\end_inset
+
+ file is modified accordingly
+\change_unchanged
+.
  That said, however, any layout created with the intention that it will
  be included with LyX should use these tags where appropriate.
+
+\change_inserted -195340706 1334775793
+ Please note that the paragraph style translations provided by LyX will
+ never change with a minor update (e.g.
+ from version 2.1.x to 2.1.y).
+ It is however quite likely that a major update (e.g.
+ from 2.0.x to 2.1.y) will introduce new translations or corrections.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Subsection
@@ -13961,7 +15389,12 @@ status collapsed
 
 \end_inset
 
- indicates the inset whose layout is being defined, and here there are two
+ indicates the inset whose layout is being defined, and here there are 
+\change_inserted 5863208 1334489266
+three
+\change_deleted 5863208 1334489267
+two
+\change_unchanged
  cases.
 \end_layout
 
@@ -14152,7 +15585,15 @@ Note:Greyedout
 status collapsed
 
 \begin_layout Plain Layout
-OptArg
+
+\change_deleted -712698321 1353866704
+Opt
+\change_unchanged
+Arg
+\change_inserted -712698321 1353866707
+ument
+\change_unchanged
+
 \end_layout
 
 \end_inset
@@ -14201,60 +15642,176 @@ status collapsed
 status collapsed
 
 \begin_layout Plain Layout
-Flex:<name>
-\end_layout
-
-\end_inset
+Flex:<name>
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+, where 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+name
+\end_layout
+
+\end_inset
+
+ may be be any valid identifier not used by a pre-existing Flex inset.
+ The identifier may include spaces, but in that case the whole thing must
+ be wrapped in quotes.
+ Note that the definition of a flex inset 
+\emph on
+must 
+\emph default
+also include a 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+LyXType
+\end_layout
+
+\end_inset
+
+ entry, declaring which type of inset it defines.
+\change_inserted 5863208 1334489312
+
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 5863208 1334492248
+The layout for user specific branch is being defined.
+ In this case, 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 5863208 1334489384
+<Type>
+\end_layout
+
+\end_inset
+
+ must be of the form 
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 5863208 1334489392
+Branch:<name>
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+, where 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 5863208 1334489384
+name
+\end_layout
+
+\end_inset
+
+ may be be any valid identifier of branch defined in user's document.
+ The identifier may include spaces, but in that case the whole thing must
+ be wrapped in quotes.
+ The main purpose of this feature is to allow LaTeX wrapping around specific
+ branches as user needs.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Standard
+The 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+InsetLayout
+\end_layout
+
+\end_inset
+
+ definition can contain the following entries:
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1353681390
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
 
+\change_inserted -712698321 1353681344
+Argument
+\end_layout
 
-\begin_inset Quotes erd
 \end_inset
 
-, where 
+ [
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-name
+
+\change_inserted -712698321 1353681344
+int
 \end_layout
 
 \end_inset
 
- may be be any valid identifier not used by a pre-existing Flex inset.
- The identifier may include spaces, but in that case the whole thing must
- be wrapped in quotes.
- Note that the definition of a flex inset 
-\emph on
-must 
-\emph default
-also include a 
+] Defines argument number <int> of a command\SpecialChar \slash{}
+environment associated with
+ the current layout.
+ The definition must end with 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-LyXType
+
+\change_inserted -712698321 1353681344
+EndArgument
 \end_layout
 
 \end_inset
 
- entry, declaring which type of inset it defines.
-\end_layout
+.
+ See section
+\begin_inset space ~
+\end_inset
 
-\begin_layout Standard
-The 
-\begin_inset Flex Code
-status collapsed
 
-\begin_layout Plain Layout
-InsetLayout
-\end_layout
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Paragraph-Styles"
 
 \end_inset
 
- definition can contain the following entries:
+ for details.
 \end_layout
 
 \begin_layout Description
+
 \change_inserted -195340706 1333913893
 \begin_inset Flex Code
 status collapsed
@@ -14265,7 +15822,8 @@ BabelPreamble
 
 \end_inset
 
- Preamble for changing languages. See section
+ Preamble for changing languages.
+ See section
 \begin_inset space ~
 \end_inset
 
@@ -14627,6 +16185,81 @@ LabelFont
 \end_inset
 
  later if you want them to be different.
+\change_inserted 155139281 1354130923
+
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 155139281 1354130923
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354130923
+ForceLocalFontSwitch
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354130923
+
+\emph on
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354130923
+1
+\end_layout
+
+\end_inset
+
+] When using babel, always use a local font switch (
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354130923
+
+\backslash
+foreignlanguage
+\end_layout
+
+\end_inset
+
+), never a global one (such as 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 155139281 1354130923
+
+\backslash
+selectlanguage
+\end_layout
+
+\end_inset
+
+).
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -14929,22 +16562,22 @@ Branch
 \end_inset
 
 ) modify this label on the fly.
-
 \end_layout
 
 \begin_layout Description
+
 \change_inserted -195340706 1333913893
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-
 LangPreamble
 \end_layout
 
 \end_inset
 
- Language dependent preamble.  See section
+ Language dependent preamble.
+ See section
 \begin_inset space ~
 \end_inset
 
@@ -14956,7 +16589,6 @@ reference "sub:I18n"
 \end_inset
 
 .
-
 \end_layout
 
 \begin_layout Description
@@ -15023,10 +16655,20 @@ status collapsed
 
 \begin_layout Plain Layout
 
+\change_deleted -712698321 1353867544
+
 \emph on
 Paragraph
 \emph default
-, Command, Environment, Item_Environment,
+, 
+\change_unchanged
+Command, Environment, 
+\change_inserted -712698321 1353867573
+None
+\change_deleted -712698321 1353867557
+Item_Environment,
+\change_unchanged
+
 \end_layout
 
 \end_inset
@@ -15036,7 +16678,15 @@ Paragraph
 status collapsed
 
 \begin_layout Plain Layout
-List_Environment, Bib_Environment
+
+\change_deleted -712698321 1353867564
+List_Environment
+\change_unchanged
+, 
+\change_deleted -712698321 1353867569
+Bib_Environment
+\change_unchanged
+
 \end_layout
 
 \end_inset
@@ -15070,7 +16720,13 @@ LatexType
 status collapsed
 
 \begin_layout Plain Layout
+
+\change_deleted -712698321 1353867582
 Paragraph
+\change_inserted -712698321 1353867583
+None
+\change_unchanged
+
 \end_layout
 
 \end_inset
@@ -15147,6 +16803,8 @@ LatexName
 \end_layout
 
 \begin_layout Itemize
+
+\change_deleted -712698321 1353867600
 \begin_inset Flex Code
 status collapsed
 
@@ -15183,6 +16841,8 @@ item
 \end_layout
 
 \begin_layout Itemize
+
+\change_deleted -712698321 1353867600
 \begin_inset Flex Code
 status collapsed
 
@@ -15248,6 +16908,8 @@ settings
 
  dialog.
  
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -15279,6 +16941,52 @@ depending upon the LaTeX type.
 \end_layout
 
 \end_deeper
+\begin_layout Description
+
+\change_inserted -712698321 1354263128
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353866742
+LeftDelim
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353866752
+string
+\end_layout
+
+\end_inset
+
+] A string that is put at the beginning of the layout content.
+ A line break in the output can be indicated by 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354263128
+<br/>
+\end_layout
+
+\end_inset
+
+.
+\change_unchanged
+
+\end_layout
+
 \begin_layout Description
 \begin_inset Flex Code
 status collapsed
@@ -15704,7 +17412,81 @@ reference "des:FreeSpacing"
 \end_inset
 
 ) for information on `features'.
+\change_inserted -712698321 1354439699
+
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1354439705
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354439699
+ResetArgs
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354439699
+
+\emph on
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354439699
+1
+\end_layout
+
+\end_inset
+
+] Resets the LaTeX arguments of this layout (as defined via the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354439699
+Argument
+\end_layout
+
+\end_inset
+
+ tag).
+ This is useful if you have copied a style via 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354439699
+CopyStyle
+\end_layout
+
+\end_inset
+
+, but you do not want to inherit its (required and optional) arguments.
+
+\change_deleted -712698321 1354439698
  
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -15742,6 +17524,52 @@ status collapsed
 ] Whether this inset should use the font of its surrounding environment
  or uses its own.
  Default is true: uses its own.
+\change_inserted -712698321 1353866806
+
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1354263134
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353866810
+RightDelim
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1353866806
+string
+\end_layout
+
+\end_inset
+
+] A string that is put at the end of the layout content.
+ A line break in the output can be indicated by 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1354263134
+<br/>
+\end_layout
+
+\end_inset
+
+.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description