-#LyX 1.6.0rc5 created this file. For more info see http://www.lyx.org/
-\lyxformat 344
+#LyX 1.6.2svn created this file. For more info see http://www.lyx.org/
+\lyxformat 345
\begin_document
\begin_header
\textclass scrbook
% redefine the \LyX macro for PDF bookmarks
\def\LyX{\texorpdfstring{%
L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@}
- {LyX }}
+ {LyX}}
% used for multi-column text
\usepackage{multicol}
\end_inset
will translate most legal LaTeX, but not everything.
- It will put things it doesn't understand into ERT, so after translating
+ It will put things it doesn't understand into TeX code, so after translating
a file with
\begin_inset Flex CharStyle:Code
status collapsed
\end_inset
-, you can look for ERT and hand-edit it until it looks right.
+, you can look for TeX code and hand-edit it until it looks right.
\end_layout
\begin_layout Standard
-If you don't know what ERT is, read the next section.
+If you don't know what TeX code is, read the next section.
\end_layout
\begin_layout Section
\end_inset
box containing this text is directly after this paragraph.
- Those of you reading the manual in LyX will only see the ERT inset.
+ Those of you reading the manual in LyX will only see the TeX code inset.
Those reading a printed version of the manuals will see the actual results:
\end_layout
\end_layout
\begin_layout Standard
-In addition to using ERT, you can also create a separate file containing
+In addition to using TeX code, you can also create a separate file containing
some complex LaTeX structure and then use
\begin_inset Flex CharStyle:MenuItem
status collapsed
\begin_layout Standard
If you already know LaTeX, there is no need to explain here what the preamble
is good for.
- If you don't, the following will give you some ideas---we recommend again
+ If you don't, the following will give you some ideas—we recommend again
that you consult a LaTeX book for further information.
In any case, you should read the points below, because they explain what
you can do and what you don't need to do in the LaTeX preamble of a LyX
it follows another one.
The idea behind indenting the first line of a paragraph is to distinguish
neighboring paragraphs from one another.
- If there is no previous paragraph---for example, if it follows a figure
- or is the first paragraph in a section---then there is no need for indentation.
+ If there is no previous paragraph—for example, if it follows a figure or
+ is the first paragraph in a section—then there is no need for indentation.
\end_layout
\end_layout
\begin_layout Enumerate
-If you get a bunch of error boxes piled up at the very top of the document---and
+If you get a bunch of error boxes piled up at the very top of the document—and
especially if you see a
\begin_inset Quotes eld
\end_inset
\begin_inset Quotes erd
\end_inset
- error---it means that there are errors in the preamble.
+ error—it means that there are errors in the preamble.
Start debugging your preamble.
\end_layout
\end_layout
\begin_layout Standard
-If all this doesn't help---well, then
+If all this doesn't help—well, then
\emph on
perhaps
\emph default
\end_inset
- (those commands have to be inserted as ERT).
+ (those commands have to be inserted as TeX code).
The bibliography will contain all references which have been cited in the
current
\begin_inset Flex CharStyle:Code
It is important to note that each of these files is a full LyX file which
can be formatted and printed on its own, as well as included in a master
file.
- Each of these files must have the same document class, however---don't
- attempt to mix book classes with article classes.
+ Each of these files must have the same document class, however—don't attempt
+ to mix book classes with article classes.
You may also include LaTeX files; however, these files must not have their
own preamble (i.
\begin_inset space \thinspace{}
really
\emph default
want to have multiple sets of paragraphs with different sets of bullets
- in each, then you're going to have to get your hands dirty with ERT.
+ in each, then you're going to have to get your hands dirty with TeX code.
The bullet selection dialog can help though because it provides you with
the LaTeX code for a wide range of bullet shapes.
To make your own custom paragraphs you have the following options:
status collapsed
\begin_layout Plain Layout
-
-\bar under
-T
-\bar default
-ools\SpecialChar \menuseparator
-
-\bar under
-P
-\bar default
-references
+Tools\SpecialChar \menuseparator
+Preferences
\end_layout
\end_inset
' to create the pipes.
If one of the pipes already exists, LyX will assume that another LyX process
is already running and will not start the server.
- This means that if LyX crashes, or if for some other reason, a
+ If for some other reason, an unused
\begin_inset Quotes eld
\end_inset
\begin_inset Quotes erd
\end_inset
- pipe is left in existence when LyX closes, then LyX will not start the
- server.
- (This is bug 641.) You will need to delete the pipes manually and then restart
- LyX.
+ pipe is left in existence when LyX closes, then LyX will try to delete
+ it.
+ If this fails for some reason, you will need to delete the pipes manually
+ and then restart LyX.
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-Other than this, there are a few points to consider:
-\end_layout
-
-\begin_layout Itemize
-Both server and clients must run on UNIX or OS/2 machines.
- Communications between LyX on UNIX and clients on OS/2 or vice versa is
- not possible right now.
-\end_layout
-
-\begin_layout Itemize
-On OS/2, only one client can connect to LyXServer at a time.
-\end_layout
-
-\begin_layout Itemize
-On OS/2, clients must open the input pipe with
+You can find a complete example client written in C in the source distribution
+ as
\begin_inset Flex CharStyle:Code
status collapsed
\begin_layout Plain Layout
-O_WRONLY
+development/lyxserver/server_monitor.c
\end_layout
\end_inset
- mode.
+.
\end_layout
\begin_layout Standard
-You can find a complete example client written in C in the source distribution
- as
+Another useful tool is command-line based client you will find in
\begin_inset Flex CharStyle:Code
status collapsed
\begin_layout Plain Layout
-development/lyxserver/server_monitor.c
+src/client/lyxclient
\end_layout
\end_inset
\begin_layout Description
clientname is a name that the client can choose arbitrarily.
- Its only use is that LyX will echo it if it sends an answer---so a client
+ Its only use is that LyX will echo it if it sends an answer—so a client
can dispatch results from different requesters.
\end_layout
\family default
in the
\family sans
-\bar under
-D
-\bar default
-ocument\SpecialChar \menuseparator
-
-\bar under
-S
-\bar default
-ettings
+Document\SpecialChar \menuseparator
+Settings
\family default
dialog (OK, that one was obvious).
\end_layout
Just remember that tables should be left-aligned.
For that, select the table and change the alignment in
\family sans
-\bar under
-E
-\bar default
-dit\SpecialChar \menuseparator
-
-\bar under
-P
-\bar default
-aragraph
+Edit\SpecialChar \menuseparator
+Paragraph
\begin_inset space ~
\end_inset
\begin_layout Enumerate
Create a wide figure float:
\family sans
-\bar under
-I
-\bar default
-nsert\SpecialChar \menuseparator
-Flo
-\bar under
-a
-\bar default
-t\SpecialChar \menuseparator
+Insert\SpecialChar \menuseparator
+Float\SpecialChar \menuseparator
Figure
\family default
, then right click in the figure and select
\begin_layout Enumerate
Position the cursor behind the figure and insert a horizontal fill:
\family sans
-\bar under
-I
-\bar default
-nsert\SpecialChar \menuseparator
-
-\bar under
-S
-\bar default
-pecial
+Insert\SpecialChar \menuseparator
+Special
\begin_inset space ~
\end_inset
-Character
-\bar under
-\SpecialChar \menuseparator
-H
-\bar default
-orizontal
+Character\SpecialChar \menuseparator
+Horizontal
\begin_inset space ~
\end_inset
I strongly suggest that you start with the AASTeX template file.
Click on
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
New from
\family default
\family sans
-\bar under
-T
-\bar default
-emplate
+Template
\family default
, enter the new file name, then choose the
\family typewriter
template file.
For commands such as these, the LaTeX code must be entered directly and
marked as such.
- Such commands are referred to as ERT, or Evil Red Text.
- I tried to minimize the amount of ERT needed in an AASTeX document, but
- there is still a bit more required than any of us would like.
+ Such commands are referred to as TeX code, or Evil Red Text.
+ I tried to minimize the amount of TeX code needed in an AASTeX document,
+ but there is still a bit more required than any of us would like.
\end_layout
\begin_layout Subsection
\begin_layout Enumerate
Export your paper as a LaTeX file (
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
-
-\bar under
-E
-\bar default
-xport\SpecialChar \menuseparator
-
-\bar under
-L
-\bar default
-aTeX
+File\SpecialChar \menuseparator
+Export\SpecialChar \menuseparator
+LaTeX
\family default
).
\backslash
email
\family default
- (2.3) -- can only be used
+ (2.3) – can only be used
\begin_inset Quotes eld
\end_inset
\end_inset
, not in the middle of a paragraph.
- Use ERT if you need to embed it.
+ Use TeX code if you need to embed it.
\end_layout
\begin_layout Itemize
\backslash
and
\family default
- (2.3) -- will have extra {} after it.
+ (2.3) – will have extra {} after it.
This should not cause an error.
\end_layout
\backslash
notetoeditor
\family default
- (2.6) -- can only be used
+ (2.6) – can only be used
\begin_inset Quotes eld
\end_inset
\end_inset
, not in the middle of a paragraph.
- Use ERT if you need to embed it.
+ Use TeX code if you need to embed it.
\end_layout
\begin_layout Itemize
\backslash
placetable
\family default
- (2.8) -- can't insert a cross-reference tag, you must type the tag name
- by hand
+ (2.8) – can't insert a cross-reference tag, you must type the tag name by
+ hand
\end_layout
\begin_layout Itemize
\backslash
placefigure
\family default
- (2.8) -- same as for
+ (2.8) – same as for
\family typewriter
\backslash
\backslash
acknowledgements
\family default
- (2.9) -- will have extra {} after it.
+ (2.9) – will have extra {} after it.
This should not cause an error.
\end_layout
\backslash
appendix
\family default
- (2.11) -- will have extra {} after it.
+ (2.11) – will have extra {} after it.
This should not cause an error.
\end_layout
\backslash
figcaption
\family default
- (2.14.2) -- you can insert an optional filename argument by placing the cursor
+ (2.14.2) – you can insert an optional filename argument by placing the cursor
at the beginning of the text and selecting
\family sans
Insert\SpecialChar \menuseparator
\backslash
objectname
\family default
- (2.17.1) -- same as
+ (2.17.1) – same as
\family typewriter
\backslash
\backslash
dataset
\family default
- (2.17.1) -- same as
+ (2.17.1) – same as
\family typewriter
\backslash
\end_layout
\begin_layout Subsubsection
-Things not implemented, use ERT
+Things not implemented, use TeX code
\end_layout
\begin_layout Standard
If you really, really need to use deluxetable, I suggest editing it in
a separate file with a text editor, then using
\family sans
-\bar under
-I
-\bar default
-nsert\SpecialChar \menuseparator
-Chil
-\bar under
-d
-\bar default
-
+Insert\SpecialChar \menuseparator
+Child
\begin_inset space ~
\end_inset
\begin_layout Enumerate
Rerun
\family sans
-\bar under
-T
-\bar default
-ools\SpecialChar \menuseparator
-
-\bar under
-R
-\bar default
-econfigure
+Tools\SpecialChar \menuseparator
+Reconfigure
\family default
in LyX, then restart LyX.
\end_layout
Open a regular new file, not from a template.
Does AASTeX appear in the class list in
\family sans
-\bar under
-D
-\bar default
-ocument\SpecialChar \menuseparator
-
-\bar under
-S
-\bar default
-ettings
+Document\SpecialChar \menuseparator
+Settings
\family default
?
\end_layout
This seems to produce a bad interaction in AASTeX so you should click somewhere
in the caption/title, then select
\family sans
-\bar under
-E
-\bar default
-dit\SpecialChar \menuseparator
-
-\bar under
-P
-\bar default
-aragraph
+Edit\SpecialChar \menuseparator
+Paragraph
\begin_inset space ~
\end_inset
\family default
to
\family sans
-\bar under
-B
-\bar default
-lock
+Block
\family default
.
This took care of it for me.
\begin_inset space ~
\end_inset
-commands as ERT into a Figure Float box if you desire, but I never have
- much luck getting the layout right.
+commands as TeX code into a Figure Float box if you desire, but I never
+ have much luck getting the layout right.
With the standard graphics, LyX will insert a
\family typewriter
\end_layout
\begin_layout Standard
-The following environments---as well as the standard environments, such
- as
+The following environments—as well as the standard environments, such as
+
\begin_inset Flex CharStyle:Noun
status collapsed
\end_inset
----are provided by
+—are provided by
\begin_inset Flex CharStyle:Code
status collapsed
\begin_layout Proof
At the end of this environment, a QED symbol (usually a square, but it can
vary with different styles) is placed.
- If you want to have other environments within this one---for example, Case
- environments---and have the QED symbol appear only after them, then the
- other environments need to be nested within the proof environment.
+ If you want to have other environments within this one—for example, Case
+ environments—and have the QED symbol appear only after them, then the other
+ environments need to be nested within the proof environment.
See the section
\emph on
Nesting Environments
\family typewriter
jgrga.layout
\family default
- --- Martin Vermeer
+ — Martin Vermeer
\end_layout
\begin_layout Standard
.
This can be done in the
\family sans
-layout\SpecialChar \menuseparator
-document
+Layout\SpecialChar \menuseparator
+Document
\family default
or
\family sans
-document\SpecialChar \menuseparator
-settings
+Document\SpecialChar \menuseparator
+Settings
\family default
menu item.
(AGU articles are always in English, right? So
\end_layout
\begin_layout Itemize
-(O.S) --- off screen
+(O.S) — off screen
\end_layout
\begin_layout Itemize
-(V.0) --- voice over
+(V.0) — voice over
\end_layout
\begin_layout Itemize
\end_inset
g.
- --- background
+ — background
\end_layout
\begin_layout Itemize
C.U.
- --- close-up
+ — close-up
\end_layout
\begin_layout Itemize
-PAN --- camera movement
+PAN — camera movement
\end_layout
\begin_layout Itemize
-INSERT --- cut to close-up of
+INSERT — cut to close-up of
\end_layout
\begin_layout Section
As usual, the easiest way to write a paper is to start with a template.
Click on
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
New from
\family default
Before previewing your paper, be sure that the babel package is not used.
To do this, click on
\family sans
-\bar under
-T
-\bar default
-ools\SpecialChar \menuseparator
-
-\bar under
-P
-\bar default
-references
+Tools\SpecialChar \menuseparator
+Preferences
\family default
, select the
\family sans
\family default
tab, deselect the
\family sans
-\bar under
-U
-\bar default
-se babel
+Use babel
\family default
checkbox in the language settings, and click on
\family sans
-\bar under
-A
-\bar default
-pply
+Apply
\family default
(or
\family sans
command to implement table captions.
As a result, a table created by LyX is printed correctly, but its caption
is ignored.
- However, you can use some ERT to overpass this problem, so that captions
+ However, you can use some TeX code to overpass this problem, so that captions
are printed as expected.
To do so, create a float table as usual, remove the caption, and replace
- it with the ERT
+ it with the TeX code
\family typewriter
\backslash
\emph default
}{
\family default
- (sic); you must also the ERT
+ (sic); you must also the TeX code
\family typewriter
}
\family default
\family default
file, then include this file to the LyX document (
\family sans
-\bar under
-I
-\bar default
-nsert\SpecialChar \menuseparator
-Fil
-\bar under
-e
-\bar default
-\SpecialChar \menuseparator
-Chil
-\bar under
-d
-\bar default
-
+Insert\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
+Child
\begin_inset space ~
\end_inset
Before you submit your paper you must export the LyX document as a LaTeX
file (
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
-
-\bar under
-E
-\bar default
-xport\SpecialChar \menuseparator
-
-\bar under
-L
-\bar default
-a
+File\SpecialChar \menuseparator
+Export\SpecialChar \menuseparator
+La
\family default
T
\family sans
\end_layout
\begin_layout Subsection
-Use of ERT
+Use of TeX code
\end_layout
\begin_layout Standard
-The use of ERT is reduced to two commands, which must be placed at the top
- of the document.
+The use of TeX code is reduced to two commands, which must be placed at
+ the top of the document.
If you started writing your paper by using the
\family typewriter
ijmpc.lyx
\family typewriter
ijmpd.lyx
\family default
- template, the ERT needed is already in its place; you usually don't need
- to delete it.
- You may only modify the first ERT to specify the information printed to
- the top of odd and even pages (authors' names and short paper's title,
+ template, the TeX code needed is already in its place; you usually don't
+ need to delete it.
+ You may only modify the first TeX code to specify the information printed
+ to the top of odd and even pages (authors' names and short paper's title,
respectively).
- This ERT must have the form
+ This TeX code must have the form
\family typewriter
\backslash
Article
\family default
which is not directly supported by the LyX.
- This can be used as ERT when your document doesn't fit into one of the
- other title types.
+ This can be used as TeX code when your document doesn't fit into one of
+ the other title types.
\end_layout
\begin_layout Standard
\begin_layout Standard
LyX supports many features of the package but not everything.
- However, the ERT needed is reduced to some
+ However, the TeX code needed is reduced to some
\begin_inset Quotes eld
\end_inset
\begin_inset Quotes eld
\end_inset
-ERT
+TeX code
\begin_inset Quotes erd
\end_inset
\begin_inset space ~
\end_inset
-between two ERT lines (
+between two TeX code lines (
\family typewriter
\backslash
\end_layout
\begin_layout Enumerate
-don't delete the ERT included in the template, and
+don't delete the TeX code included in the template, and
\end_layout
\begin_layout Enumerate
In addition, the appearance of the headings can be modified by using a
number of options (in LyX to be entered in the field
\family sans
-E
-\bar under
-x
-\bar default
-tra
+Extra
\begin_inset space ~
\end_inset
scrlettr
\family default
.
- It has --- on the LaTeX side --- a completely new interface and is not
- compatible with the old class.
+ It has — on the LaTeX side — a completely new interface and is not compatible
+ with the old class.
Therefore, LyX supports both, though it is recommended to use the new class.
\end_layout
, lots will probably never, due to the limitations of LyX's framework.
Of course you can still use all features with the help of some native LaTeX
- commands (ERT
+ commands (TeX code
\begin_inset Foot
status collapsed
\family default
), you can emulate article style.
That is, counters (footnotes, figures, tables etc.) will not be reset on
- new chapters, chapters don't start a new page (but are---in contrary to
-
+ new chapters, chapters don't start a new page (but are—in contrary to
\begin_inset Quotes eld
\end_inset
\begin_inset Quotes erd
\end_inset
- article classes---still allowed), parts, though, use their own page, as
- in book.
+ article classes—still allowed), parts, though, use their own page, as in
+ book.
\end_layout
\begin_layout Description
One is poemtitle, which is a centered title for poems, which will also
be added to the table of contents (verse is the standard environment for
poems.
- Memoir has some enhanced versions of verse, but you need to use ERT, because
- they have to be nested inside regular verse environments, which is not
- possible with LyX).
+ Memoir has some enhanced versions of verse, but you need to use TeX code,
+ because they have to be nested inside regular verse environments, which
+ is not possible with LyX).
\end_layout
\begin_layout Description
\begin_deeper
\begin_layout Description
-rmheadings serif titles --- default,
+rmheadings serif titles — default,
\end_layout
\begin_layout Description
\end_layout
\begin_layout Description
-authortitle on title page first placed is author next title --- default,
+authortitle on title page first placed is author next title — default,
\end_layout
\begin_layout Description
\family typewriter
texhash
\family default
-, as root if necessary --- doesn't LyX take care of this?), reconfigure
- LyX and it should work.
+, as root if necessary — doesn't LyX take care of this?), reconfigure LyX
+ and it should work.
\end_layout
\begin_layout Subsection
\end_layout
\begin_layout Standard
-A large number of theorem-like styles ---
+A large number of theorem-like styles —
\family sans
Claim, Conjecture,
\family default
\family typewriter
svjog.layout
\family default
- --- Martin Vermeer
+ — Martin Vermeer
\end_layout
\begin_layout Itemize
\family typewriter
svprobth.layout
\family default
- --- Jean-Marc Lasgouttes
+ — Jean-Marc Lasgouttes
\end_layout
\begin_layout Standard
VisibleText
\family default
, is a rather long-ish label.
- The text following this label --- ordinarily the contents of the paragraph
- environment --- is utterly irrelevant for
+ The text following this label — ordinarily the contents of the paragraph
+ environment — is utterly irrelevant for
\family sans
Slide
\family default
\family sans
Slide
\family default
- --
+ –
\family sans
Overlay
\family default
- --
+ –
\family sans
Note
\family default
\family default
program installed
\begin_inset Foot
-status open
+status collapsed
\begin_layout Plain Layout
\family typewriter
chktex
\family default
- is not available for Windows.
+ is not yet available when you are using the LaTeX distribution MiKTeX.
\end_layout
\end_inset
\begin_layout Standard
The implementation in LyX assumes a recent version of the GNU RCS or CVS/SVN
- package---no guarantees are made for older versions.
+ package—no guarantees are made for older versions.
+\end_layout
+
+\begin_layout Standard
+For introducing your own external commands consult vc-command in the manual
+ of LyX functions.
\end_layout
\begin_layout Subsection
The following sections describe the RCS commands supported by LyX.
You can find them in the
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
-
-\bar under
-V
-\bar default
-ersion
+File\SpecialChar \menuseparator
+Version
\begin_inset space ~
\end_inset
Control
\family default
submenu.
+ LyX was tested against RCS 5.7.
\end_layout
\begin_layout Subsubsection
in the menu.
And if it is under revision control, the
\family sans
-\bar under
-R
-\bar default
-egister
+Register
\family default
item is not visible.
CVS is now partially supported by LyX.
You can find the commands in the
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
-
-\bar under
-V
-\bar default
-ersion
+File\SpecialChar \menuseparator
+Version
\begin_inset space ~
\end_inset
\begin_layout Standard
CVS command:
\family typewriter
-cvs -q commit -m"<description>" <file-name>
+cvs -q commit -m"<description>" "<file-name>"
\end_layout
\begin_layout Subsubsection
SVN is now partially supported by LyX.
You can find the commands in the
\family sans
-\bar under
-F
-\bar default
-ile\SpecialChar \menuseparator
-
-\bar under
-V
-\bar default
-ersion
+File\SpecialChar \menuseparator
+Version
\begin_inset space ~
\end_inset
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 SVN 1.4 and 1.5.
\end_layout
\begin_layout Subsubsection
\end_layout
\begin_layout Standard
-SVN command:
+SVN command:
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+In case locking is not enabled.
+ See Section
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:SVN-File-Locking"
+
+\end_inset
+
+.
+\end_layout
+
+\end_inset
+
+
\family typewriter
svn commit -q -m"<description>" <file-name>
\end_layout
\end_layout
\begin_layout Standard
-SVN command:
+SVN command:
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+Ditto.
+\end_layout
+
+\end_inset
+
+
\family typewriter
svn update
\begin_inset Quotes eld
is shown in a browser.
\end_layout
+\begin_layout Subsubsection
+File Locking
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:SVN-File-Locking"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+The file exchange through various revision control systems brings the problem
+ of merge conflicts in case two different users try to edit the same (parts
+ of) document.
+ When such conflict happens it needs manual resolving and one reasonable
+ alternative is to provide some kind of locking mechanism, which guarantees
+ that only one user is allowed to edit file at the given time.
+\end_layout
+
+\begin_layout Standard
+SVN has two mechanisms to provide such kind of mutual exclusivity for file
+ access - locks and automatical setting of write permissions based on
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+svn:needs-lock
+\end_layout
+
+\end_inset
+
+ file svn property.
+ In a case this property is detected for a given document LyX starts to
+ use SVN locks for document editing automatically and the whole check-in/out
+ mechanism switches to the same regimen as for RCS.
+ This in particular means there are two different modes how file is used
+ in LyX:
+\end_layout
+
+\begin_layout Itemize
+Unlocked state.
+ The loaded file is in the read-only mode.
+ For editation on needs to check-out.
+
+\emph on
+Check-out
+\emph default
+ consists of update from repository and gaining write lock.
+ If the lock is not possible to obtain, we remain in unlocked state.
+\end_layout
+
+\begin_layout Itemize
+Locked state.
+ The loaded file is in the 'normal' edit mode.
+ No other user is allowed to edit the file.
+
+\emph on
+Check-in
+\emph default
+ consists of commiting changes and releasing write-lock.
+ If no changes have been made to the document, no commit will be produced
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+Don't be puzzled by the fact that you will be asked for commit message anyway.
+\end_layout
+
+\end_inset
+
+ and only the write-lock will be released.
+\end_layout
+
+\begin_layout Standard
+SVN commands:
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+Check-in:
+\family typewriter
+ svn commit -q -m"<description>" "<file-name>"
+\begin_inset Newline newline
+\end_inset
+
+svn unlock "<file-name>"
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+Check-out:
+\family typewriter
+svn update "<file-name>"
+\begin_inset Newline newline
+\end_inset
+
+svn lock "<file-name>"
+\end_layout
+
+\begin_layout Subsection
+SVN and Windows Environment
+\end_layout
+
+\begin_layout Quote
+My inclination is to say that if the user cannot figure out the command
+ line operations on their own fairly quickly, they would be well advised
+ to use TortoiseSVN.
+ ---P.
+ A.
+ Rubin
+\end_layout
+
+\begin_layout Subsubsection
+Preparation
+\end_layout
+
+\begin_layout Standard
+In addition to installing LyX, and having access to a Subversion repository,
+ the user will need to install the Subversion client program.
+ A Windows installer for the client program is available from
+\begin_inset CommandInset href
+LatexCommand href
+name "CollabNet"
+target "http://www.collab.net/nonav/downloads/subversion/"
+
+\end_inset
+
+.
+ The user may also want to install
+\begin_inset CommandInset href
+LatexCommand href
+name "TortoiseSVN"
+target "http://tortoisesvn.tigris.org/"
+
+\end_inset
+
+, which integrates Subversion operations into the context (rightclick) menu
+ of Windows Explorer.
+ Operations done outside LyX will typically be more convenient using the
+ Explorer context menu.
+ Note that TortoiseSVN is not a replacement for the client program, which
+ is what LyX itself will use.
+\end_layout
+
+\begin_layout Subsubsection
+Bringing a document under Subversion control
+\end_layout
+
+\begin_layout Standard
+Before a LyX document can be brought under version control in Subversion,
+ its parent directory needs to be under version control.
+ If the document is being added to a project already in the repository,
+ this is accomplished by checking the project out to the directory where
+ the new document will be placed.
+ If the project itself is not yet under version control (for instance, if
+ this document starts a new project), the directory must be imported into
+ the repository.
+ This is done outside LyX.
+ Both import and checkout are easily accomplished from the Explorer context
+ menu using TortoiseSVN, or alternatively can be done using the command
+ line client at a DOS prompt.
+ The procedure for importing the project using TortoiseSVN is described
+ below, assuming an existing repository and a new project being started
+ in
+\family typewriter
+C:
+\backslash
+new project
+\family default
+.
+ For information on using the Subversion client program, run
+\family typewriter
+svn --help
+\family default
+in a DOS shell.
+\end_layout
+
+\begin_layout Enumerate
+Locate
+\family typewriter
+C:
+\backslash
+new project
+\family default
+in Windows Explorer, right click it, and select
+\family typewriter
+TortoiseSVN > Repo-browser
+\family default
+.
+ If necessary, adjust the URL for the repository, then click OK.
+\end_layout
+
+\begin_layout Enumerate
+Right click the level of the repository under which you want to place the
+ new project folder (typically the top level) and click
+\family typewriter
+Create folder\SpecialChar \ldots{}
+
+\family default
+ Supply a name for the project folder and click OK.
+ Add a message for the log file if desired, then click OK again.
+ The new project folder should appear in the repository.
+ Finally, click OK again to exit the repository browser.
+\end_layout
+
+\begin_layout Enumerate
+Once again right click
+\family typewriter
+C:
+\backslash
+new project
+\family default
+, this time selecting SVN Checkout\SpecialChar \ldots{}
+ Select the URL of the project folder
+ you just created in the repository, and set the checkout directory to
+\family typewriter
+C:
+\backslash
+new project.
+
+\family default
+ Click OK.
+ You will be warned about a non-empty folder; click OK to proceed.
+ You should now have a
+\family typewriter
+.svn
+\family default
+ directory under
+\family typewriter
+C:
+\backslash
+new project.
+\end_layout
+
+\begin_layout Enumerate
+Create or open your document in LyX and click
+\family sans
+\bar under
+F
+\bar default
+ile\SpecialChar \menuseparator
+
+\bar under
+V
+\bar default
+ersion
+\begin_inset space ~
+\end_inset
+
+Control\SpecialChar \menuseparator
+
+\bar under
+R
+\bar default
+egister.
+
+\family default
+Add a log message and click OK to commit the document to version control.
+\end_layout
+
+\begin_layout Standard
+From this point onward, you should have full functionality in the
+\family sans
+\bar under
+F
+\bar default
+ile\SpecialChar \menuseparator
+
+\bar under
+V
+\bar default
+ersion
+\begin_inset space ~
+\end_inset
+
+Control
+\family default
+ menu.
+ You also have the option of checking the document in and out, viewing its
+ history, etc.
+ using the TortoiseSVN context menu in Windows Explorer or the Subversion
+ client program from a command prompt.
+\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 CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+vc-command DS "." "TortoiseProc /command:commit /path:$$p"
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Description
+Revert:
+\begin_inset Flex CharStyle:Code
+status collapsed
+
+\begin_layout Plain Layout
+vc-command DR "." "TortoiseProc /command:revert /path:$$p"
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
\begin_layout Section
Literate Programming
\end_layout
class, and with some code and text on it.
How do I print it? The answer is simple, you select
\family sans
-\bar under
-V
-\bar default
-iew\SpecialChar \menuseparator
-
-\bar under
-D
-\bar default
-VI,
+View\SpecialChar \menuseparator
+DVI,
\family default
etc.
Just like you would do for a plain document.
\begin_layout Standard
All the Literate Programming support is configured by the
\family sans
-\bar under
-T
-\bar default
-ools\SpecialChar \menuseparator
-
-\bar under
-P
-\bar default
-references
+Tools\SpecialChar \menuseparator
+Preferences
\family default
panel in the
\begin_inset Quotes eld
It happens that you can define the editor command line invocation in ddd
by accessing the
\family sans
-\bar under
-E
-\bar default
-dit\SpecialChar \menuseparator
-
-\bar under
-P
-\bar default
-references\SpecialChar \menuseparator
-
-\bar under
-H
-\bar default
-elpers
+Edit\SpecialChar \menuseparator
+Preferences\SpecialChar \menuseparator
+Helpers
\family default
dialog and changing the "Edit Sources" entry.
\end_layout
In my toolbar I like to combine the six short cuts above with two more:
One for
\family sans
-\bar under
-V
-\bar default
-iew
+View
\family default
\SpecialChar \menuseparator
\family sans
-\bar under
-U
-\bar default
-pdate
+Update
\family default
\SpecialChar \menuseparator
\family sans
-\bar under
-D
-\bar default
-VI
+DVI
\family default
and the other for
\family sans
-\bar under
-V
-\bar default
-iew\SpecialChar \menuseparator
-
-\bar under
-D
-\bar default
-VI
+View\SpecialChar \menuseparator
+DVI
\family default
File menu entries.
Here is how it looks like:
examples/multicol.lyx
\family default
.
- --- mer
+ — mer
\end_layout
\end_inset
\begin_layout Standard
\size footnotesize
-The youth moved in the best society--had, so far as was known, no enemies
+The youth moved in the best society–had, so far as was known, no enemies
and no particular vices.
He had been engaged to Miss Edith Woodley, of Carstairs, but the engagement
had been broken off by mutual consent some months before, and there was
\begin_layout Standard
\size footnotesize
-Ronald Adair was fond of cards--playing continually, but never for such
- stakes as would hurt him.
+Ronald Adair was fond of cards–playing continually, but never for such stakes
+ as would hurt him.
He was a member of the Baldwin, the Cavendish, and the Bagatelle card clubs.
It was shown that, after dinner on the day of his death, he had played
a rubber of whist at the latter club.
\size default
\size footnotesize
-The evidence of those who had played with him-- Mr.
- Murray, Sir John Hardy, and Colonel Moran--showed that the game was whist,
+The evidence of those who had played with him– Mr.
+ Murray, Sir John Hardy, and Colonel Moran–showed that the game was whist,
and that there was a fairly equal fall of the cards.
Adair might have lost five pounds, but not more.
His fortune was a considerable one, and such a loss could not in any way
\begin_inset Quotes erd
\end_inset
----those large capital letters which begin each new chapter or section.
+—those large capital letters which begin each new chapter or section.
Implementing them with plain LyX/LaTeX is straightforward (assuming you
know some plain TeX!) but does require a lot of work and many iterations,
as you can see by all the ugly TeX-mode stuff at the beginning of this