Additional manual - Rest of fixes from John Hudson

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/branches/BRANCH_1_6_X@35785 a592a061-630c-0410-9148-cb99ea01b6c8
This commit is contained in:
Pavel Sanda 2010-10-22 18:46:31 +00:00
parent cb6c51b1ea
commit d8d8084ddf

View File

@ -18177,7 +18177,7 @@ Show History
\end_layout
\begin_layout Standard
This show the complete history of the RCS document.
This shows the complete history of the RCS document.
The output of
\family typewriter
rlog <file-name>
@ -18660,7 +18660,7 @@ Show History
\end_layout
\begin_layout Standard
This show the complete history of the SVN document.
This shows the complete history of the SVN document.
The output of
\family typewriter
svn log
@ -18691,14 +18691,14 @@ name "subsec:SVN-File-Locking"
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
When such a 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 (see sec.
SVN has two such mechanisms to provide mutual exclusivity for file access
- locks and automatic setting of write permissions (see sec.
\begin_inset CommandInset ref
LatexCommand ref
@ -18727,22 +18727,21 @@ http://svnbook.red-bean.com/en/1.2/svn.advanced.locking.html
\end_inset
.
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:
If 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 of file use 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.
For editing on needs to check-out.
\emph on
Check-out
\emph default
consists of update from repository and gaining write lock.
consists of updating from the repository and gaining write lock.
If the lock is not possible to obtain, we remain in unlocked state.
\end_layout
@ -18805,12 +18804,12 @@ name "subsec:Automatical-Locking-Property"
\family default
Automatical Locking Property
Automatic Locking Property
\end_layout
\begin_layout Standard
The above mentioned automatical setting of write permissions of the .lyx
file can be set through
The above mentioned automatic setting of write permissions of the .lyx file
can be set through
\family sans
\bar under
F
@ -18865,8 +18864,7 @@ Revision Information in Documents
\end_layout
\begin_layout Standard
Currently there is no way how to provide such kind of information directly
from LyX.
Currently there is no way to provide such information directly from LyX.
There are possibilities how to activate it with the help of svn features,
but each has its own drawbacks.
\end_layout
@ -19200,16 +19198,17 @@ SSH tunel used with SVN under Windows
\end_layout
\begin_layout Standard
Compared to linux setting svn client to communicate over ssh under Windows
is rather troublesome task.
We will at least make some hints how to setup client side but former knowledge
about ssh and Windows command line is needed, also be prepared for a great
deal of frustration...
Compared with Linux setting up svn client to communicate over ssh under
Windows is a rather troublesome task.
We will at least offer some hints how to setup the client side but prior
knowledge about ssh and the Windows command line is needed, also be prepared
for a great deal of frustration\SpecialChar \ldots{}
\end_layout
\begin_layout Enumerate
Get svn client for windows, as described in previous sections.
When it is fresh install run some svn command (e.g.
Get a svn client for windows, as described in the previous sections.
When it is a fresh install run some svn command (e.g.
\begin_inset Flex CharStyle:Code
status collapsed
@ -19220,12 +19219,12 @@ svn --version
\end_inset
) to have created config files, which you will need to change later on.
) to create config files, which you will need to change later on.
\end_layout
\begin_layout Enumerate
Choose ssh client for Windows.
There are more possibilities, we will use the one from Putty tools
Choose a ssh client for Windows.
There are several possibilities, we will use the one from Putty tools
\begin_inset Foot
status collapsed
@ -19246,8 +19245,8 @@ http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
\end_inset
.
You will need to automatize connection, so client doesn't ask for any password
from you.
You will need to set the connection up so that the client doesn't ask for
any password from you.
To keep things easy we will use only keys without any additional password
protection etc.
\end_layout
@ -19266,9 +19265,9 @@ puttygen
.
Save your private .ppk key file and put the public one on the server side.
In case the SVN server runs on linux, note that the format of the public
key is not compatible with linux openssh and you will need to direcly copy-past
e the key from the “
If SVN server runs on Linux, note that the format of the public key is
not compatible with Linux openssh and you will need to direcly copy-paste
the key from the “
\emph on
Public key for pasting into OpenSSH authorized_keys file:
\emph default
@ -19402,8 +19401,8 @@ End-of-Line Conversions
\begin_layout Standard
When the collaborators are mixing Linux and Windows environments, LyX will
use different line endings inside the .lyx files.
This is not problem as far as LyX functionality is concerned, but the commit
diffs will be huge and merge-conflicts prone.
This is not a problem as far as LyX functionality is concerned, but the
commit diffs will be huge and merge-conflicts prone.
Fortunately SVN itself knows
\begin_inset Foot
status collapsed
@ -19526,9 +19525,8 @@ Introduction
\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
literate programming, where it is assumed that you are familiar with this
programming technique, and know what
\begin_inset Quotes eld
\end_inset
@ -19578,7 +19576,7 @@ Literate programming is the combination of documentation and source together
\begin_inset space \thinspace{}
\end_inset
g.
E.
Knuth during the development of his TeX typesetting software.
\end_layout
@ -19631,7 +19629,7 @@ status collapsed
\begin_layout Plain Layout
http://shelob.ce.ttu.edu/daves/lpfaq/faq.html
http://www.literateprogramming.com/lpfaq.pdf
\end_layout
\end_inset
@ -20875,7 +20873,7 @@ Do try this at home
\begin_layout Standard
Most ideas in this section require less common files in your LaTeX installation.
If you have a system like teTeX, most will already be available.
If you have a system like TeXLive, most will already be available.
A few, however, will need to be downloaded from one of the CTAN archives.
Often, there are several ways to do something, or several LaTeX style files
which do the same thing.
@ -21675,7 +21673,7 @@ dropcaps
dropping
\family default
) package from CTAN allows a simple way to add such letters to your documents.
Since this package is not a standard part of teTeX, I can't demonstrate
Since this package is not a standard part of TeXLive, I can't demonstrate
it within this document, but if you copy this paragraph to a new document,
delete the
\begin_inset Quotes eld