Update InsetLayout docs.

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

diff --git a/lib/doc/Customization.lyx b/lib/doc/Customization.lyx
index 12ccc4be335d5f4b01b6bfea5e8951faf9081375..eb7e77144d23ccd56dfe9afc25c0952549c1ceac 100644 (file)
--- a/lib/doc/Customization.lyx
+++ b/lib/doc/Customization.lyx
@@ -1,8 +1,8 @@
-#LyX 1.6.0beta3 created this file. For more info see http://www.lyx.org/
-\lyxformat 335
+#LyX 1.6.0rc1 created this file. For more info see http://www.lyx.org/
+\lyxformat 340
 \begin_document
 \begin_header
-\textclass book
+\textclass scrbook
 \begin_preamble
 % DO NOT ALTER THIS PREAMBLE!!!
 %
@@ -13,15 +13,23 @@
 % the documentation team
 % email: lyx-docs@lists.lyx.org
 
- % the pages of the TOC are numbered roman
- % and a pdf-bookmark for the TOC is added
- \pagenumbering{roman}
- \let\myTOC\tableofcontents
- \renewcommand\tableofcontents{%
-   \pdfbookmark[1]{Contents}{}
-   \myTOC
-   \cleardoublepage
-   \pagenumbering{arabic} }
+\usepackage{ifpdf} % part of the hyperref bundle
+\ifpdf % if pdflatex is used
+
+ % set fonts for nicer pdf view
+ \IfFileExists{lmodern.sty}
+  {\usepackage{lmodern}}{}
+
+\fi % end if pdflatex is used
+
+% the pages of the TOC is numbered roman
+% and a pdf-bookmark for the TOC is added
+\let\myTOC\tableofcontents
+\renewcommand\tableofcontents{%
+  \frontmatter
+  \pdfbookmark[1]{\contentsname}{}
+  \myTOC
+  \mainmatter }
 
 % redefine the \LyX macro for PDF bookmarks
 \def\LyX{\texorpdfstring{%
@@ -32,6 +40,7 @@
 \usepackage{multicol}
 \usepackage{inputenc}
 \end_preamble
+\options fleqn,liststotoc,bibtotoc,idxtotoc,BCOR7.5mm,titlepage,tablecaptionabove
 \begin_modules
 logicalmkup
 \end_modules
@@ -51,7 +60,7 @@ EndPreamble
 End
 \end_local_layout
 \language english
-\inputencoding default
+\inputencoding auto
 \font_roman default
 \font_sans default
 \font_typewriter default
@@ -60,22 +69,26 @@ End
 \font_osf false
 \font_sf_scale 100
 \font_tt_scale 100
+
 \graphics none
-\paperfontsize default
+\paperfontsize 12
 \spacing single
 \use_hyperref true
 \pdf_title "LyX Configuration Manual"
-\pdf_author "The LyX Team"
+\pdf_author "LyX Team"
+\pdf_subject "LyX-documentation Customization"
+\pdf_keywords "LyX, documentation, customization"
 \pdf_bookmarks true
-\pdf_bookmarksnumbered false
-\pdf_bookmarksopen false
+\pdf_bookmarksnumbered true
+\pdf_bookmarksopen true
 \pdf_bookmarksopenlevel 1
-\pdf_breaklinks true
-\pdf_pdfborder true
+\pdf_breaklinks false
+\pdf_pdfborder false
 \pdf_colorlinks true
 \pdf_backref false
 \pdf_pagebackref false
-\pdf_pdfusetitle true
+\pdf_pdfusetitle false
+\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue,pdfpagelayout=OneColumn, pdfnewwindow=true,pdfstartview=XYZ, plainpages=false, pdfpagelabels"
 \papersize default
 \use_geometry false
 \use_amsmath 0
@@ -115,7 +128,15 @@ status collapsed
 \begin_layout Plain Layout
 \noindent
 If you have comments or error corrections, please send them to the LyX Documenta
-tion mailing list, <lyx-docs@lists.lyx.org>.
+tion mailing list, 
+\begin_inset CommandInset href
+LatexCommand href
+target "lyx-docs@lists.lyx.org"
+type "mailto:"
+
+\end_inset
+
+.
 \end_layout
 
 \end_inset
@@ -149,7 +170,7 @@ on, installing new LaTeX classes and LyX layouts, etc.
 
 \begin_layout Standard
 \begin_inset Branch OutDated
-status open
+status collapsed
 
 \begin_layout Standard
 Information from previous versions of this document that now seems to be
@@ -309,7 +330,7 @@ UserDir
 en at any time.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -323,7 +344,7 @@ lyxrc.defaults
  contains defaults for various commands.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -362,7 +383,7 @@ Configuration
 .
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -387,7 +408,7 @@ layout/
 on.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -411,7 +432,7 @@ layout/
  directories
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -425,7 +446,7 @@ status collapsed
  lists of various sorts of LaTeX-related files found on your system
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -489,7 +510,7 @@ UserDir
  will be used.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -554,7 +575,7 @@ reference "sec:bindings"
 for details.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -569,7 +590,7 @@ clipart/
  
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -618,7 +639,7 @@ reference "chap:i18n"
  for details.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -643,7 +664,7 @@ Examples
  button to get there.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -669,7 +690,7 @@ Document
  and the banners that can be shown when LyX is launched.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -695,7 +716,7 @@ reference "sec:keymap"
  for details.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -720,7 +741,7 @@ reference "chap:textclass"
 .
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -746,7 +767,7 @@ lyx2lyx
  files.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -775,7 +796,7 @@ Template
  Also contains some scripts used by LyX itself.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -800,7 +821,7 @@ reference "sec:templates"
 .
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -843,7 +864,7 @@ These files are used internally by LyX and you generally do not need to
  modify them unless you are a developer.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -877,7 +898,7 @@ LyX
 .
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -892,7 +913,7 @@ chkconfig.ltx
  Do not run directly.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -911,7 +932,7 @@ configure.py
 Other files needing a line or two...
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -926,7 +947,7 @@ encodings
  mapped to unicode
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -954,7 +975,7 @@ Template
  feature.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -1243,7 +1264,7 @@ status collapsed
 status collapsed
 
 \begin_layout Plain Layout
-LYX_USERDIR_15x
+LYX_USERDIR_16x
 \end_layout
 
 \end_inset
@@ -2917,7 +2938,7 @@ For example, the file may refer to other files---images, for example---using
 The definitions of the copiers may use four variables:
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -2949,7 +2970,7 @@ status collapsed
 ).
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -2963,7 +2984,7 @@ $$i
  The input file
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -2977,7 +2998,7 @@ $$o
  The output file
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3025,18 +3046,22 @@ inline false
 status open
 
 \begin_layout Plain Layout
+
 #!/bin/bash
 \end_layout
 
 \begin_layout Plain Layout
+
 FROMFILE=$1
 \end_layout
 
 \begin_layout Plain Layout
+
 TOFILE=`basename $2`
 \end_layout
 
 \begin_layout Plain Layout
+
 cp $FROMFILE /home/you/pdf/$TOFILE
 \end_layout
 
@@ -3279,7 +3304,7 @@ Add
  Several variables can be used in the definition of converters:
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3293,7 +3318,7 @@ $$s
  The LyX system directory
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3307,7 +3332,7 @@ $$i
  The input file
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3321,7 +3346,7 @@ $$o
  The output file
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3335,7 +3360,7 @@ $$b
  The base filename of the input file (i.e., without the extension)
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3367,7 +3392,7 @@ Flag
  field you can enter the following flags, separated by commas:
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3382,7 +3407,7 @@ latex
  This will make LyX's LaTeX error logs available.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3406,7 +3431,7 @@ status collapsed
  file for the conversion.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3443,7 +3468,7 @@ value
  format:
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3488,7 +3513,7 @@ $$s
 .
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3522,7 +3547,7 @@ Note that resultdir and usetempdir make no sense together.
  The latter will be ignored if the former is given.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -3897,21 +3922,28 @@ target "http://www.lyx.org/devel/cvs.php"
 \end_layout
 
 \begin_layout Itemize
-Copy 
+Copy the file 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
 \begin_layout Plain Layout
-po/lyx.pot
+lyx.pot
 \end_layout
 
 \end_inset
 
- to
-\series bold
- 
-\series default
+ to the folder of the 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+**.po
+\end_layout
 
+\end_inset
+
+ files.
+ Then rename it to 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -3921,7 +3953,8 @@ xx.po
 
 \end_inset
 
- (if 
+.
+ (If 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -3931,7 +3964,7 @@ lyx.pot
 
 \end_inset
 
- doesn't exist, it can be remade with 
+ doesn't exist anywhere, it can be remade with the console command 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -3963,8 +3996,20 @@ status collapsed
 \begin_layout Plain Layout
 This is just a text file, so it can be edited in any text editor.
  But there are also specialized programs that support such editing, such
- as KBabel (for KDE).
- Emacs contains a `mode' for editing 
+ as 
+\family typewriter
+Poedit
+\family default
+ (for all platforms) or 
+\family typewriter
+KBabel
+\family default
+ (for KDE).
+ 
+\family typewriter
+Emacs
+\family default
+ contains a `mode' for editing 
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -4395,7 +4440,7 @@ If you ever find an error in the original document, fix it and notify the
 
 \begin_layout Standard
 \begin_inset Branch OutDated
-status open
+status collapsed
 
 \begin_layout Section
 International Keyboard Support
@@ -5101,7 +5146,7 @@ kcomb
  are described in this section.
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -5239,7 +5284,7 @@ status collapsed
 kmap & /
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -5436,7 +5481,7 @@ The following example specifies that the character ' is to be an acute accent,
 kmod ' acute aeiouAEIOU
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -5670,7 +5715,7 @@ kxmod acute i "
 i}"
 \end_layout
 
-\begin_layout List
+\begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex CharStyle:Code
 status collapsed
@@ -9473,6 +9518,13 @@ CopyStyle
 \end_inset
 
  
+\begin_inset CommandInset label
+LatexCommand label
+name "des:CopyStyle"
+
+\end_inset
+
+
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -11252,6 +11304,11 @@ protect
 \end_inset
 
 'ed.
+ (Note: This is 
+\emph on
+not
+\emph default
+ whether this command should itself be protected.)
 \end_layout
 
 \begin_layout Description
@@ -11870,6 +11927,7 @@ reference "sec:fonts"
 \end_layout
 
 \begin_layout Description
+Need
 \begin_inset Flex CharStyle:Code
 status collapsed
 
@@ -12877,6 +12935,26 @@ src/ColorCode.h
 \begin_inset Flex CharStyle:Code
 status collapsed
 
+\begin_layout Plain Layout
+CopyStyle
+\end_layout
+
+\end_inset
+
+ As with paragraph styles (see page 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "des:CopyStyle"
+
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
 \begin_layout Plain Layout
 Decoration
 \end_layout
@@ -13226,6 +13304,58 @@ end
 \begin_inset Flex CharStyle:Code
 status collapsed
 
+\begin_layout Plain Layout
+NeedProtect
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+1
+\end_layout
+
+\end_inset
+
+] Whether fragile commands in this layout should be 
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\backslash
+protect
+\end_layout
+
+\end_inset
+
+'ed.
+ (Note: This is 
+\emph on
+not
+\emph default
+ whether this command should itself be protected.)
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex CharStyle:Code
+status collapsed
+
 \begin_layout Plain Layout
 Preamble
 \end_layout