]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Additional.lyx
Fix EOLs
[lyx.git] / lib / doc / Additional.lyx
index 3bfa4e66669ee407b124143a1d66d54ccdd5bd7c..cdef9cc3e2d4afdab5998e1fcdcad5abc47a763b 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.1 created this file. For more info see http://www.lyx.org/
-\lyxformat 459
+\lyxformat 474
 \begin_document
 \begin_header
 \textclass scrbook
@@ -101,6 +101,7 @@ End
 \use_geometry false
 \use_package amsmath 1
 \use_package amssymb 1
+\use_package cancel 0
 \use_package esint 0
 \use_package mathdots 1
 \use_package mathtools 0
@@ -109,7 +110,7 @@ End
 \use_package stmaryrd 0
 \use_package undertilde 0
 \cite_engine basic
-\cite_engine_type numerical
+\cite_engine_type default
 \biblio_style plain
 \use_bibtopic false
 \use_indices false
@@ -6277,7 +6278,7 @@ On Mac OSX you have to use
 status collapsed
 
 \begin_layout Plain Layout
-DISPLAY=:0.0 xdvi -editor 'lyxeditor.sh %f %l'
+DISPLAY=:0.0 xdvi -editor "lyxeditor.sh %f %l"
 \end_layout
 
 \end_inset
@@ -6292,7 +6293,7 @@ DISPLAY=:0.0 xdvi -editor 'lyxeditor.sh %f %l'
 status collapsed
 
 \begin_layout Plain Layout
-xdvi -editor 'lyxeditor.sh %f %l'
+xdvi -editor "lyxeditor.sh %f %l"
 \end_layout
 
 \end_inset
@@ -6328,7 +6329,7 @@ echo "$COMMAND" > "${LYXPIPE}".in || exit
 \begin_inset Newline newline
 \end_inset
 
-read < "${LYXPIPE}".out || exit
+read TMP < "${LYXPIPE}".out || exit
 \end_layout
 
 \begin_layout Standard
@@ -7098,7 +7099,44 @@ $$o
 
 \begin_layout Standard
 Note that only some of the viewers provide full forward search functionality,
- among them yap, xdvi, okular and Sumatra PDF.
+ among them yap, xdvi, okular
+\begin_inset Foot
+status open
+
+\begin_layout Plain Layout
+You might want to set 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+okular --unique
+\end_layout
+
+\end_inset
+
+ in 
+\begin_inset Flex MenuItem
+status collapsed
+
+\begin_layout Plain Layout
+Tools\SpecialChar \menuseparator
+Preferences\SpecialChar \menuseparator
+File Handling\SpecialChar \menuseparator
+File
+\begin_inset space ~
+\end_inset
+
+Formats
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+ and Sumatra PDF
 \begin_inset Foot
 status collapsed
 
@@ -7115,6 +7153,7 @@ target "http://www.istri.fr/zip/CMCDDE.zip"
 
 \end_inset
 
+.
  While many of the widespread PDF viewers (most notably Adobe Reader) do
  not support forward search at all, some other viewers -- e.
 \begin_inset space \thinspace{}
@@ -10439,21 +10478,9 @@ FoilTeX
 \end_layout
 
 \begin_layout Standard
-\begin_inset ERT
+\begin_inset Flex Multiple Columns
 status open
 
-\begin_layout Plain Layout
-
-
-\backslash
-begin{multicols}{2}
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
 \begin_layout Itemize
 
 \family sans
@@ -10562,17 +10589,6 @@ Caption
 Comment
 \end_layout
 
-\begin_layout Standard
-\begin_inset ERT
-status open
-
-\begin_layout Plain Layout
-
-
-\backslash
-end{multicols}
-\end_layout
-
 \end_inset
 
 
@@ -10630,21 +10646,9 @@ FoilTeX
 \end_layout
 
 \begin_layout Standard
-\begin_inset ERT
+\begin_inset Flex Multiple Columns
 status open
 
-\begin_layout Plain Layout
-
-
-\backslash
-begin{multicols}{2}
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
 \begin_layout Itemize
 
 \family sans
@@ -10711,17 +10715,6 @@ Proposition*
 Definition*
 \end_layout
 
-\begin_layout Standard
-\begin_inset ERT
-status open
-
-\begin_layout Plain Layout
-
-
-\backslash
-end{multicols}
-\end_layout
-
 \end_inset
 
 
@@ -10776,21 +10769,9 @@ Martin Vermeer
 \end_layout
 
 \begin_layout Standard
-\begin_inset ERT
+\begin_inset Flex Multiple Columns
 status open
 
-\begin_layout Plain Layout
-
-
-\backslash
-begin{multicols}{2}
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
 \begin_layout Itemize
 
 \family sans
@@ -10838,7 +10819,7 @@ Header
 \end_layout
 
 \begin_deeper
-\begin_layout Standard
+\begin_layout Plain Layout
 \begin_inset space ~
 \end_inset
 
@@ -10846,17 +10827,6 @@ Header
 \end_layout
 
 \end_deeper
-\begin_layout Standard
-\begin_inset ERT
-status open
-
-\begin_layout Plain Layout
-
-
-\backslash
-end{multicols}
-\end_layout
-
 \end_inset
 
 
@@ -10964,8 +10934,11 @@ ShortRotatefoilhead
 \family default
  environments.
  Again the only difference is the spacing between foilhead and body.
- Both of the short versions have 0.5 inches less separation between the foilhead
- and the body.
+ Both of the short versions have 0.5
+\begin_inset space ~
+\end_inset
+
+inches less separation between the foilhead and the body.
  
 \end_layout
 
@@ -18915,7 +18888,7 @@ Introduction
 \end_layout
 
 \begin_layout Standard
-LyX supports some of the most basic RCS/CVS/SVN commands.
+LyX supports some of the most basic RCS/CVS/SVN/GIT commands.
  If you need something a bit more sophisticated you will have to do that
  manually in a terminal.
 \end_layout
@@ -18964,7 +18937,7 @@ man rcsintro
 
 \begin_layout Standard
 Before you begin to use the version control features in LyX, you should
- be familiar with RCS/CVS/SVN usage.
+ be familiar with RCS/CVS/SVN/GIT usage.
  The implementation in LyX assumes a recent version of the GNU RCS or CVS/SVN
  package — no guarantees are made for older versions.
  Most of the log messages are not currently displayed after operations —
@@ -20807,8 +20780,8 @@ svnversion
 \begin_inset Tabular
 <lyxtabular version="3" rows="6" columns="2">
 <features rotate="0" tabularvalignment="middle">
-<column alignment="center" valignment="top" width="0">
-<column alignment="center" valignment="top" width="0">
+<column alignment="center" valignment="top">
+<column alignment="center" valignment="top">
 <row>
 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
 \begin_inset Text
@@ -21563,174 +21536,485 @@ svn propset svn:eol-style native FILE_NAME
 \end_layout
 
 \begin_layout Subsection
-Further tuning
-\end_layout
-
-\begin_layout Standard
-With the recent addition of the vc-command function LyX power users are
- allowed to create their own commands for revision control.
+GIT commands in LyX
 \end_layout
 
 \begin_layout Standard
-As an example you can see how two TortoiseSVN commands could be integrated
- directly:
-\end_layout
-
-\begin_layout Description
-Commit: 
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-vc-command DR "." "TortoiseProc /command:commit /path:$$p"
-\end_layout
-
+A minimal subset of GIT commands is now supported by LyX.
+ You can find the commands in the 
+\family sans
+File\SpecialChar \menuseparator
+Version
+\begin_inset space ~
 \end_inset
 
-
+Control
+\family default
+ submenu.
+ Please note that if you use password protected access to repository via
+ ssh, you will be asked in terminal window.
+ LyX was tested against GIT 1.7.
 \end_layout
 
-\begin_layout Description
-Revert: 
+\begin_layout Standard
+One big difference of GIT and the other supported version control systems
+ is the distributed nature of GIT: With traditional version control systems
+ there is one central server which hosts the repository.
+ Users commit their changes to the server, and get updates made by other
+ users from it.
+ With GIT, users commit to a local repository.
+ The local repository can be synchronized with one or more remote repositories
+ using the 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-vc-command DR "." "TortoiseProc /command:revert /path:$$p"
+pull
 \end_layout
 
 \end_inset
 
-
-\end_layout
-
-\begin_layout Subsection
-Version control and Document comparison
-\end_layout
-
-\begin_layout Standard
-One of the typical uses of version control is to inspect the changes between
- revisions, usually by creating 
+ and 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-diff
+push
 \end_layout
 
 \end_inset
 
dumps.
- While this is useful for plain text files, it is much less useful in the
- case of LyX files, which have more a complicated structure.
Hence we provide binding to the Document comparison feature.
- There are two ways of calling this feature - either by direct call of 
GIT commands.
+ LyX does not interact in any way with remote GIT repositories.
+ It works exclusively with the local repository in a very similar way as
with a central CVS or SVN repository.
+ If you use remote GIT repositories you need to do the 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-VC_COMPARE
+pull
 \end_layout
 
 \end_inset
 
- LyX function (for details see LyX functions manual) or by icon/menu item
-\begin_inset Flex MenuItem
+ and 
+\begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-Compare with older revision...
+push
 \end_layout
 
 \end_inset
 
-.
- One can either compare two chosen revisions of the document or he can simply
- compare the current version of edited text with older revisions (where
- '
-\begin_inset Flex MenuItem
-status collapsed
-
-\begin_layout Plain Layout
-0
+ operations with your favourite GIT client.
 \end_layout
 
-\end_inset
+\begin_layout Subsubsection
 
-' revisions back means comparison of the edited file with last commited
- revision).
+\family sans
+Register
 \end_layout
 
 \begin_layout Standard
-This feature is supported for SVN and RCS though due to the more complicated
- versioning scheme of RCS there is a constraint -- when addressing the revisions
- in dialog, numbers always point to the last number in RCS revision number,
- i.e.
- '35' in '1.2.35'.
-\end_layout
-
-\begin_layout Section
-Literate Programming
+If your document is not under revision control, this is the only item shown
+ in the menu.
+ And if it is under revision control, the 
+\family sans
+\bar under
+R
+\bar default
+egister
+\family default
+ item is not visible.
 \end_layout
 
 \begin_layout Standard
-Updated by 
-\noun on
-Kayvan Sylvan 
-\noun default
-(kayvan@sylvan.com)
-\noun on
-, 
-\noun default
-original documentation written by 
-\noun on
-Edmar Wienskoski Jr.
-
-\noun default
- (edmar-w-jr@technologist.com)
+This command registers in GIT your document ONLY in case you have already
+ the documents directory under GIT control (in particular 
+\family typewriter
+.git/index
+\family default
+ file exists).
+ This means you have to checkout the archive by yourself.
 \end_layout
 
-\begin_layout Subsection
-Introduction
+\begin_layout Standard
+Then you are asked interactively to supply an initial description of the
+ document.
+ Don't forget that registered file is not yet commited.
 \end_layout
 
 \begin_layout Standard
-The main purpose of this documentation is to show you how to use LyX for
- literate programming, where it is assumed that you are familiar with this
- programming technique, and know what 
+GIT command that is run: 
+\family typewriter
+git add 
 \begin_inset Quotes eld
 \end_inset
 
-tangling
+<file-name>
 \begin_inset Quotes erd
 \end_inset
 
- and 
-\begin_inset Quotes eld
-\end_inset
-
-weaving
-\begin_inset Quotes erd
-\end_inset
 
- means.
- If that is not the case, please follow the web links provided in the following
- sections.
- There is a lot of good documentation out there covering old development
- history to the latest tools tips.
 \end_layout
 
 \begin_layout Standard
-It is also assumed that you are familiar with LyX itself to a point that
- you are comfortable changing your LyX preferences, and X resources file.
- If that is not the case please refer to other LyX documentation to cover
- your specific needs.
+Read 
+\family typewriter
+man git
+\family default
+ to understand the switches.
 \end_layout
 
-\begin_layout Subsection
-Literate Programming
+\begin_layout Subsubsection
+
+\family sans
+Check In Changes
+\end_layout
+
+\begin_layout Standard
+When you are finished editing a file, you commit your changes.
+ When you do this, you are asked for a description of the changes.
+ After that changes are commited.
+\end_layout
+
+\begin_layout Standard
+GIT command: 
+\family typewriter
+git commit -q -m"<description>" <file-name>
+\end_layout
+
+\begin_layout Subsubsection
+
+\family sans
+Revert To Repository Version
+\end_layout
+
+\begin_layout Standard
+This will discard all changes made to the document since the last check
+ in.
+ You get a warning before changes are discarded.
+\end_layout
+
+\begin_layout Standard
+GIT command: 
+\family typewriter
+git checkout -q 
+\begin_inset Quotes eld
+\end_inset
+
+<file-name>
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+
+\family sans
+Rename
+\end_layout
+
+\begin_layout Standard
+This will rename the current document including the version history.
+ It requires a clean document without any changes since the last checkin.
+ You are asked for a file name and a description of the rename operation.
+ After that the document is renamed, both locally and in the repository.
+ If the parent directories of the new and old file names differ, all relative
+ paths of included files are adjusted (like in 
+\family sans
+File\SpecialChar \menuseparator
+Save As
+\family default
+\SpecialChar \ldots{}
+).
+ Finally, the document is reloaded using the new name.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+GIT
+\begin_inset space ~
+\end_inset
+
+commands: 
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+git mv 
+\family typewriter
+
+\begin_inset Quotes eld
+\end_inset
+
+<file-name>
+\begin_inset Quotes erd
+\end_inset
+
+\begin_inset Quotes eld
+\end_inset
+
+<new-file-name>
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+git commit
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+
+\family sans
+Show History
+\end_layout
+
+\begin_layout Standard
+This shows the complete history of the GIT document.
+ The output of 
+\family typewriter
+git log 
+\begin_inset Quotes eld
+\end_inset
+
+<file-name>
+\begin_inset Quotes erd
+\end_inset
+
+
+\family default
+ is shown in a browser.
+\end_layout
+
+\begin_layout Subsubsection
+Version Info
+\end_layout
+
+\begin_layout Standard
+LyX supports GIT hash number of the last commit to the file, author name,
+ date and time of last commit.
+ All those are extracted from 
+\family typewriter
+git log -n 1 --pretty=format:%H%n%an%n%ai
+\family default
+.
+ Tree version information is obtained via 
+\family typewriter
+git describe --abbrev --dirty --long
+\family default
+.
+ See 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:VCS-Revision-Information"
+
+\end_inset
+
+ for other details.
+\end_layout
+
+\begin_layout Subsection
+Further tuning
+\end_layout
+
+\begin_layout Standard
+With the recent addition of the vc-command function LyX power users are
+ allowed to create their own commands for revision control.
+\end_layout
+
+\begin_layout Standard
+As an example you can see how two TortoiseSVN commands could be integrated
+ directly:
+\end_layout
+
+\begin_layout Description
+Commit: 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+vc-command DR "." "TortoiseProc /command:commit /path:$$p"
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+Revert: 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+vc-command DR "." "TortoiseProc /command:revert /path:$$p"
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsection
+Version control and Document comparison
+\end_layout
+
+\begin_layout Standard
+One of the typical uses of version control is to inspect the changes between
+ revisions, usually by creating 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+diff
+\end_layout
+
+\end_inset
+
+ dumps.
+ While this is useful for plain text files, it is much less useful in the
+ case of LyX files, which have more a complicated structure.
+ Hence we provide binding to the Document comparison feature.
+ There are two ways of calling this feature - either by direct call of 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+VC_COMPARE
+\end_layout
+
+\end_inset
+
+ LyX function (for details see LyX functions manual) or by icon/menu item
+\begin_inset Flex MenuItem
+status collapsed
+
+\begin_layout Plain Layout
+Compare with older revision...
+\end_layout
+
+\end_inset
+
+.
+ One can either compare two chosen revisions of the document or he can simply
+ compare the current version of edited text with older revisions (where
+ '
+\begin_inset Flex MenuItem
+status collapsed
+
+\begin_layout Plain Layout
+0
+\end_layout
+
+\end_inset
+
+' revisions back means comparison of the edited file with last commited
+ revision).
+\end_layout
+
+\begin_layout Standard
+This feature is supported for SVN and RCS though due to the more complicated
+ versioning scheme of RCS there is a constraint -- when addressing the revisions
+ in dialog, numbers always point to the last number in RCS revision number,
+ i.e.
+ '35' in '1.2.35'.
+ We don't currently support GIT addressing of revisions, one can just compare
+ edited document with its revision X steps backs, where X is addressed as
+ HEAD~X.
+\end_layout
+
+\begin_layout Section
+Literate Programming
+\end_layout
+
+\begin_layout Standard
+Updated by 
+\noun on
+Kayvan Sylvan 
+\noun default
+(kayvan@sylvan.com)
+\noun on
+, 
+\noun default
+original documentation written by 
+\noun on
+Edmar Wienskoski Jr.
+
+\noun default
+ (edmar-w-jr@technologist.com)
+\end_layout
+
+\begin_layout Subsection
+Introduction
+\end_layout
+
+\begin_layout Standard
+The main purpose of this documentation is to show you how to use LyX for
+ literate programming, where it is assumed that you are familiar with this
+ programming technique, and know what 
+\begin_inset Quotes eld
+\end_inset
+
+tangling
+\begin_inset Quotes erd
+\end_inset
+
+ and 
+\begin_inset Quotes eld
+\end_inset
+
+weaving
+\begin_inset Quotes erd
+\end_inset
+
+ means.
+ If that is not the case, please follow the web links provided in the following
+ sections.
+ There is a lot of good documentation out there covering old development
+ history to the latest tools tips.
+\end_layout
+
+\begin_layout Standard
+It is also assumed that you are familiar with LyX itself to a point that
+ you are comfortable changing your LyX preferences, and X resources file.
+ If that is not the case please refer to other LyX documentation to cover
+ your specific needs.
+\end_layout
+
+\begin_layout Subsection
+Literate Programming
 \end_layout
 
 \begin_layout Standard
@@ -23025,38 +23309,39 @@ If you want to have 2
 \begin_inset space ~
 \end_inset
 
-columns in your text, use the style 
+columns in your text, insert a multicolumn inset via the menu 
 \family sans
-Begin Multiple Columns
-\family default
- where the columns should start.
- The content of the style is the number of the columns, so in this case
- use a 
-\begin_inset Quotes eld
+Insert\SpecialChar \menuseparator
+Custom
+\begin_inset space ~
 \end_inset
 
-2
-\begin_inset Quotes erd
+Insets\SpecialChar \menuseparator
+Multiple
+\begin_inset space ~
 \end_inset
 
-.
- At the point where the columns should end use the style 
-\family sans
-End Multiple Columns
+Columns
 \family default
- and keep it empty.
+ where the columns should start.
+ Write all text that should be printed in 2
+\begin_inset space ~
+\end_inset
+
+columns into this inset.
 \end_layout
 
 \begin_layout Standard
 Here is an example:
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
-\end_layout
-
 \begin_layout Standard
 \noindent
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
+\noindent
 
 \series bold
 \size small
@@ -23066,12 +23351,10 @@ The Adventure of the Empty House
 \begin_inset Newline newline
 \end_inset
 
-by 
-\noun on
-Sir Arthur Conan Doyle
+by Sir Arthur Conan Doyle
 \end_layout
 
-\begin_layout Standard
+\begin_layout Plain Layout
 
 \size small
 It was in the spring of the year 1894 that all London was interested, and
@@ -23097,11 +23380,43 @@ ty which utterly submerged my mind.
  only withdrawn upon the third of last month.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
 \begin_layout Standard
+To get 3 or more columns, set the cursor into the multicolumn inset and
+ use the menu 
+\family sans
+Insert\SpecialChar \menuseparator
+Number
+\begin_inset space ~
+\end_inset
+
+of
+\begin_inset space ~
+\end_inset
+
+Columns
+\family default
+.
+ The number of the desired columns is written into that inset (for 3
+\begin_inset space ~
+\end_inset
+
+columns write 
+\begin_inset Quotes eld
+\end_inset
+
+3
+\begin_inset Quotes erd
+\end_inset
+
+).
+\begin_inset Newline newline
+\end_inset
+
 Here is an example with 3
 \begin_inset space ~
 \end_inset
@@ -23109,13 +23424,22 @@ Here is an example with 3
 columns:
 \end_layout
 
-\begin_layout Begin Multiple Columns
+\begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
+
+\size footnotesize
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
 3
 \end_layout
 
-\begin_layout Standard
+\end_inset
 
-\size footnotesize
 It can be imagined that my close intimacy with Sherlock Holmes had interested
  me deeply in crime, and that after his disappearance I never failed to
  read with care the various problems which came before the public.
@@ -23137,7 +23461,8 @@ It can be imagined that my close intimacy with Sherlock Holmes had interested
  as they were known to the public at the conclusion of the inquest.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
@@ -23165,11 +23490,11 @@ Columns inside Columns
 You can also have columns inside columns:
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
-\end_layout
-
 \begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
 
 \size footnotesize
 The Honourable Ronald Adair was the second son of the Earl of Maynooth,
@@ -23179,11 +23504,11 @@ The Honourable Ronald Adair was the second son of the Earl of Maynooth,
  at 427 Park Lane.
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
-\end_layout
+\begin_layout Plain Layout
+\begin_inset Flex Multiple Columns
+status open
 
-\begin_layout Standard
+\begin_layout Plain Layout
 
 \size footnotesize
 The youth moved in the best society–had, so far as was known, no enemies
@@ -23198,11 +23523,12 @@ The youth moved in the best society–had, so far as was known, no enemies
  on the night of March 30, 1894.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
-\begin_layout Standard
+\begin_layout Plain Layout
 
 \size footnotesize
 Ronald Adair was fond of cards–playing continually, but never for such stakes
@@ -23229,7 +23555,8 @@ The evidence of those who had played with him– Mr.
  So much for his recent history as it came out at the inquest.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
@@ -23263,17 +23590,18 @@ Preface
 \end_layout
 
 \begin_layout Standard
-To add a preface text for multiple columns, add the optional parameter 
+To add a preface text for multiple columns, set the cursor into the multicolumn
+ inset and use the menu 
 \family sans
+Insert\SpecialChar \menuseparator
 Preface
 \family default
- behind the number of columns in the
-\family sans
- Begin Multiple Columns
-\family default
- style.
- Write in there your preface.
- An example with some preface text:
+.
+ Write your preface text into that inset.
+\begin_inset Newline newline
+\end_inset
+
+This is an example with some preface text:
 \end_layout
 
 \begin_layout Standard
@@ -23283,9 +23611,12 @@ Preface
 
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
-\begin_inset Argument post:1
+\begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 2
 status open
 
 \begin_layout Plain Layout
@@ -23296,10 +23627,6 @@ And the story continues and continues and continues and continues\SpecialChar \l
 \end_inset
 
 
-\end_layout
-
-\begin_layout Standard
-
 \size small
 On the evening of the crime, he returned from the club exactly at ten.
  His mother and sister were out spending the evening with a relation.
@@ -23317,7 +23644,8 @@ On the evening of the crime, he returned from the club exactly at ten.
  no weapon of any sort was to be found in the room.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
@@ -23340,9 +23668,12 @@ creates a subsection.
  In this example the preface is a subsubsection:
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
-\begin_inset Argument post:1
+\begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
+\begin_inset Argument 2
 status open
 
 \begin_layout Plain Layout
@@ -23375,10 +23706,6 @@ status collapsed
 \end_inset
 
 
-\end_layout
-
-\begin_layout Standard
-
 \size small
 A minute examination of the circumstances served only to make the case more
  complex.
@@ -23402,7 +23729,8 @@ A minute examination of the circumstances served only to make the case more
  No one had heard a shot.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
@@ -23415,12 +23743,26 @@ text lines is left on the page at the beginning of the multiple columns,
  a page break will be inserted before the multiple columns.
  Depending on the number of lines of the preface text, you might want to
  change this space.
- This is done by inserting the optional parameter 
+ This is done by setting the cursor into the mulitcolumn inset behind the
+ preface (if there is any) and using the menu 
 \family sans
-Space before page break
+Insert\SpecialChar \menuseparator
+Space
+\begin_inset space ~
+\end_inset
+
+Before
+\begin_inset space ~
+\end_inset
+
+Page
+\begin_inset space ~
+\end_inset
+
+Break
 \family default
- behind the preface.
There insert the amount of space like e.
+.
Insert into that inset the amount of space like e.
 \begin_inset space \thinspace{}
 \end_inset
 
 \end_inset
 
 .
- In this example the space is set to 7
+\begin_inset Newline newline
+\end_inset
+
+In this example the space is set to 7
 \begin_inset space ~
 \end_inset
 
@@ -23460,50 +23805,12 @@ baselineskip
  needs to be inserted as TeX code):
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
-\begin_inset Argument post:1
+\begin_layout Standard
+\begin_inset Flex Multiple Columns
 status open
 
 \begin_layout Plain Layout
-\begin_inset ERT
-status collapsed
-
-\begin_layout Plain Layout
-
-
-\backslash
-subsubsection{
-\end_layout
-
-\end_inset
-
-This is the sectioning command
-\begin_inset Newline newline
-\end_inset
-
-as a preface and
-\begin_inset Newline newline
-\end_inset
-
-with multiple text lines
-\begin_inset ERT
-status collapsed
-
-\begin_layout Plain Layout
-
-}
-\end_layout
-
-\end_inset
-
-
-\end_layout
-
-\end_inset
-
-
-\begin_inset Argument post:2
+\begin_inset Argument 3
 status open
 
 \begin_layout Plain Layout
@@ -23526,10 +23833,6 @@ baselineskip
 \end_inset
 
 
-\end_layout
-
-\begin_layout Standard
-
 \size small
 On the evening of the crime, he returned from the club exactly at ten.
  His mother and sister were out spending the evening with a relation.
@@ -23547,7 +23850,8 @@ On the evening of the crime, he returned from the club exactly at ten.
  no weapon of any sort was to be found in the room.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
@@ -23623,11 +23927,11 @@ multicolsep}{2.5cm}
 
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
-\end_layout
-
 \begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
 
 \size small
 All day I turned these facts over in my mind, endeavouring to hit upon some
@@ -23648,7 +23952,8 @@ ion.
  me, and I knocked down several books which he was carrying.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
@@ -23691,20 +23996,154 @@ multicolsep}{13pt}
 \end_inset
 
 
-\begin_inset Note Note
-status collapsed
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+go back to the default
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Newpage newpage
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+Column Breaks
+\end_layout
+
+\begin_layout Standard
+A column break can be forced by inserting the command 
+\series bold
+
+\backslash
+columnbreak{}
+\series default
+ as TeX-Code to that position in the text where the column should be broken.
+ Note that this leads in most cases to whitespace in the text.
+\begin_inset Newline newline
+\end_inset
+
+Here is an example:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
+
+\size small
+\begin_inset Quotes eld
+\end_inset
+
+You're surprised to see me, sir,
+\begin_inset Quotes erd
+\end_inset
+
+ said he, in a strange, croaking voice.
+\end_layout
+
+\begin_layout Plain Layout
+
+\size small
+I acknowledged that I was.
+\end_layout
+
+\begin_layout Plain Layout
+
+\size small
+\begin_inset Quotes eld
+\end_inset
+
+Well, I've a conscience, sir, and when I chanced to see you go into this
+ house, as I came hobbling after you, I thought to myself, I'll just step
+ in and see that kind gentleman, and tell him that if I was a bit gruff
+ in my manner there was not any harm meant, and that I am much obliged to
+ him for picking up my books.
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\begin_layout Plain Layout
+
+\size small
+\begin_inset Quotes eld
+\end_inset
+
+You make too much of a trifle,
+\begin_inset Quotes erd
+\end_inset
+
+ said I.
+\begin_inset Quotes eld
+\end_inset
+
+May I ask how you knew who I was?
+\begin_inset Quotes erd
+\end_inset
+
+ AFTER THIS SENTENCE THE COLUMN BREAK IS FORCED.
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+
+\backslash
+columnbreak{}
+\end_layout
+
+\end_inset
+
+
+\end_layout
 
 \begin_layout Plain Layout
-go back to the default
-\end_layout
 
+\size small
+\begin_inset Quotes eld
+\end_inset
+
+Well, sir, if it isn't too great a liberty, I am a neighbour of yours, for
+ you'll find my little bookshop at the corner of Church Street, and very
+ happy to see you, I am sure.
+ Maybe you collect yourself, sir.
+ Here's 
+\noun on
+British
+\begin_inset space ~
+\end_inset
+
+Birds
+\noun default
+, and 
+\noun on
+Catullus
+\noun default
+, and 
+\noun on
+The Holy War
+\noun default
+--a bargain, every one of them.
+ With five volumes you could just fill that gap on that second shelf.
+ It looks untidy, does it not, sir?
+\begin_inset Quotes erd
 \end_inset
 
 
 \end_layout
 
-\begin_layout Standard
-\begin_inset Newpage newpage
 \end_inset
 
 
@@ -23760,11 +24199,11 @@ columnsep}{3cm}
 
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
-\end_layout
-
 \begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
 
 \size small
 My observations of No.
@@ -23785,7 +24224,8 @@ My observations of No.
  precious volumes, a dozen of them at least, wedged under his right arm.
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
@@ -23834,7 +24274,7 @@ columnseprule
 \end_inset
 
 pt (this is the default), the rule is suppressed.
- In the following example the line is 2
+ In the following example the rule is 2
 \begin_inset space \thinspace{}
 \end_inset
 
@@ -23859,11 +24299,220 @@ columnseprule}{2pt}
 
 \end_layout
 
-\begin_layout Begin Multiple Columns
-2
+\begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
+
+\size small
+\begin_inset Quotes eld
+\end_inset
+
+You're surprised to see me, sir,
+\begin_inset Quotes erd
+\end_inset
+
+ said he, in a strange, croaking voice.
+\end_layout
+
+\begin_layout Plain Layout
+
+\size small
+I acknowledged that I was.
+\end_layout
+
+\begin_layout Plain Layout
+
+\size small
+\begin_inset Quotes eld
+\end_inset
+
+Well, I've a conscience, sir, and when I chanced to see you go into this
+ house, as I came hobbling after you, I thought to myself, I'll just step
+ in and see that kind gentleman, and tell him that if I was a bit gruff
+ in my manner there was not any harm meant, and that I am much obliged to
+ him for picking up my books.
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\begin_layout Plain Layout
+
+\size small
+\begin_inset Quotes eld
+\end_inset
+
+You make too much of a trifle,
+\begin_inset Quotes erd
+\end_inset
+
+ said I.
+\begin_inset Quotes eld
+\end_inset
+
+May I ask how you knew who I was?
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\begin_layout Plain Layout
+
+\size small
+\begin_inset Quotes eld
+\end_inset
+
+Well, sir, if it isn't too great a liberty, I am a neighbour of yours, for
+ you'll find my little bookshop at the corner of Church Street, and very
+ happy to see you, I am sure.
+ Maybe you collect yourself, sir.
+ Here's 
+\noun on
+British
+\begin_inset space ~
+\end_inset
+
+Birds
+\noun default
+, and 
+\noun on
+Catullus
+\noun default
+, and 
+\noun on
+The Holy War
+\noun default
+--a bargain, every one of them.
+ With five volumes you could just fill that gap on that second shelf.
+ It looks untidy, does it not, sir?
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace defskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The rule can be colored by redefining the command 
+\series bold
+
+\backslash
+columnseprulecolor
+\series default
+.
+ This is done by inserting the command
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+
+\backslash
+renewcommand{
+\backslash
+columnseprulecolor}{
+\backslash
+color{red}}
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+as TeX-Code before the multicolumn inset.
+ Replace 
+\series bold
+red
+\series default
+ in this command by a color of your choice.
+ You can use all pre- and self-defined colors.
+ See the 
+\emph on
+EmbeddedObjects
+\emph default
+ manual, section 
+\emph on
+Colored
+\begin_inset space ~
+\end_inset
+
+Tables
+\emph default
+ for more information about pre- and self-defined colors.
+ To go back to the default color insert the command
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+
+\backslash
+renewcommand{
+\backslash
+columnseprulecolor}{
+\backslash
+normalcolor}
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+Here is the example with a cyan rule and 1
+\begin_inset space \thinspace{}
+\end_inset
+
+cm column separation:
+\end_layout
+
+\begin_layout Standard
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+
+\backslash
+setlength{
+\backslash
+columnsep}{1cm}
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+renewcommand{
+\backslash
+columnseprulecolor}{
+\backslash
+color{cyan}}
+\end_layout
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Standard
+\begin_inset Flex Multiple Columns
+status open
+
+\begin_layout Plain Layout
 
 \size small
 \begin_inset Quotes eld
@@ -23876,13 +24525,13 @@ You're surprised to see me, sir,
  said he, in a strange, croaking voice.
 \end_layout
 
-\begin_layout Standard
+\begin_layout Plain Layout
 
 \size small
 I acknowledged that I was.
 \end_layout
 
-\begin_layout Standard
+\begin_layout Plain Layout
 
 \size small
 \begin_inset Quotes eld
@@ -23899,7 +24548,7 @@ Well, I've a conscience, sir, and when I chanced to see you go into this
 
 \end_layout
 
-\begin_layout Standard
+\begin_layout Plain Layout
 
 \size small
 \begin_inset Quotes eld
@@ -23921,7 +24570,7 @@ May I ask how you knew who I was?
 
 \end_layout
 
-\begin_layout Standard
+\begin_layout Plain Layout
 
 \size small
 \begin_inset Quotes eld
@@ -23956,7 +24605,8 @@ The Holy War
 
 \end_layout
 
-\begin_layout End Multiple Columns
+\end_inset
+
 
 \end_layout
 
@@ -23973,6 +24623,17 @@ setlength{
 columnseprule}{0pt}
 \end_layout
 
+\begin_layout Plain Layout
+
+
+\backslash
+renewcommand{
+\backslash
+columnseprulecolor}{
+\backslash
+normalcolor}
+\end_layout
+
 \end_inset
 
 
@@ -23986,13 +24647,6 @@ go back to the default
 \end_inset
 
 
-\end_layout
-
-\begin_layout Standard
-\begin_inset Newpage newpage
-\end_inset
-
-
 \end_layout
 
 \begin_layout Section