OK. I created patches from John's new Intro & Tutorial. The Intro is exactly
what he sent. For the Tutorial, I merged in his new stuff with the current
version. The only change I made was removing a bit (but just a bit)
of the M$-bashing.
Mike/JMarc/whoever, could you apply these?
I guess I still need to do the Reference.lyx patch for the extra spaces...
-Amir
--- CVS/lyxdoc/Intro.lyx Fri Dec 25 09:23:01 1998
+++ JW_Intro.lyx Thu Mar 11 10:06:45 1999
@@ -1,5 +1,5 @@
-#This file was created by <mike> Thu Dec 24 11:44:42 1998
-#LyX 1.0 (C) 1995-1998 Matthias Ettrich and the LyX Team
+#This file was created by <candide> Wed Mar 3 19:54:47 1999
+#LyX 1.0 (C) 1995-1999 Matthias Ettrich and the LyX Team
\lyxformat 2.15
\textclass article
\language default
@@ -56,7 +56,7 @@
\layout Standard
Although LyX now has a version number of 1.0 [or greater], some of the documentat
-ion may be incomplete or a version out of date.
+ion may be incomplete or even a version out of date.
Like the rest of LyX, the manuals are the work of a group of volunteers
who have
\begin_inset Quotes eld
@@ -82,9 +82,9 @@
Also, please do us a favor---if anything in these manuals confuses you,
is unclear, or wrong, don't hesitate to let us know! You can reach the
- current document maintainers by mailing to
+ current document maintainers by mailing to
\family typewriter
- [EMAIL PROTECTED]
[EMAIL PROTECTED]
\family default
.
\layout Section
@@ -116,11 +116,53 @@
\begin_float footnote
\layout Standard
-Hi!
+Hi!
+\layout Standard
+
+To close me, click on the grey box on the right, the one with the word
+\begin_inset Quotes eld
+\end_inset
+
+foot
+\begin_inset Quotes erd
+\end_inset
+
+ in it.
\end_float
click on it with the left mouse button.
\layout Standard
+In the printed manuals, all cross-references appear as the actual numbers
+ for a chapter, section, subsection, and so on.
+ Online, however, all cross-references appear as a grey box like the following:
+
+\begin_inset LatexCommand \ref{sec:Contrib}
+
+\end_inset
+
+.
+ [The printed manuals show a number instead.] If you click on that box with
+ the left mouse button, LyX will take you to that section.
+ Typing
+\family sans
+C-<
+\family default
+ will take you back to your earlier location.
+ [What does
+\begin_inset Quotes eld
+\end_inset
+
+
+\family sans
+C-<
+\family default
+
+\begin_inset Quotes erd
+\end_inset
+
+ mean? See below.]
+\layout Standard
+
Now that we've cleared up some of the differences between the printed and
online versions of this file, we can start looking at the format of this
document.
@@ -190,7 +232,7 @@
C-
\family default
-\begin_inset Quotes eld
+\begin_inset Quotes erd
\end_inset
indicates the
@@ -209,7 +251,7 @@
S-
\family default
-\begin_inset Quotes eld
+\begin_inset Quotes erd
\end_inset
indicates the
@@ -228,7 +270,7 @@
M-
\family default
-\begin_inset Quotes eld
+\begin_inset Quotes erd
\end_inset
indicates the
@@ -564,21 +606,53 @@
\emph default
\newline
-If you are new to LyX, and never used LaTeX before, or never even heard
- of LaTeX, then you should start here.
- If you
+If you are new to LyX, and never used LaTeX before, you should start here.
+ If you think LaTeX is the stuff they make condoms out of, then you definitely
+ need to read the
\emph on
+Tutorial
+\emph default
+.
+ Note that after you read the
+\emph on
+Tutorial
+\emph default
+, you'll probably still think LaTeX is some stretchy substance --- but you
+
+\emph on
+will
+\emph default
+ know how to use LyX.
+\begin_deeper
+\layout Standard
+
+If you
+\emph on
have
\emph default
- used LaTeX before, you should still read the section on
+ used LaTeX before, you should still read the
+\emph on
+Tutorial
+\emph default
+, starting with the section on
\begin_inset Quotes eld
\end_inset
-LyX for LaTeX users
+LyX for LaTeX users.
\begin_inset Quotes erd
\end_inset
- [and skimming the rest of the document wouldn't hurt].
+ [Skimming the rest of the document wouldn't hurt, either.]
+\layout Standard
+
+If, at any time, you find yourself feeling a bit clueless with respect to
+ LyX, try perusing the
+\emph on
+Tutorial
+\emph default
+ before diving into any of the other manuals.
+ It's a good springboard.
+\end_deeper
\layout Description
@@ -597,14 +671,17 @@
most
\emph default
of the basic operation and available features of LyX here.
- The main manual assumes that you have a passing knowledge of LaTeX, or
- that you've read the
+ The main manual assumes that you've read the
\emph on
Tutorial
\emph default
-\latex latex
-\SpecialChar \@.
+.
+\begin_float footnote
+\layout Standard
+\SpecialChar \ldots{}
+or that you have a passing knowledge of LaTeX.
+\end_float
\layout Description
@@ -638,6 +715,11 @@
behavior of LyX\SpecialChar \@.
This includes such things as keybindings, internationalization,
and configuration files.
+ Don't even think of going in here until you read the
+\emph on
+Tutorial
+\emph default
+.
\layout Description
@@ -655,7 +737,11 @@
\emph on
User's Guide
\emph default
- or other manuals.
+, the
+\emph on
+Tutorial
+\emph default
+, or other manuals.
\layout Description
@@ -708,7 +794,7 @@
We'll state again an important point:
\layout Standard
\added_space_top 0.51cm \added_space_bottom 0.51cm \align center
-If you've never used or even heard of LaTeX before, read the
+If you are new to LyX, read the
\emph on
Tutorial
\emph default
@@ -717,7 +803,9 @@
\layout Standard
-Otherwise, LyX will seem byzantine and unusable to you.
+Otherwise, you could needlessly frustrate yourself.
+ LyX does all that you need a word processor to do, but using a different
+ approach.
\layout Section
@@ -769,6 +857,12 @@
Get the latest LyX source code.
Untar it.
+\begin_float footnote
+\layout Standard
+
+The more adventurous can grab the latest source anonymously from the LyX
+ CVS repository.
+\end_float
You will find a directory inside the main tree called
\family typewriter
development
--- ../CVS/lyxdoc/Tutorial.lyx Thu Mar 11 13:22:02 1999
+++ Tutorial.lyx Fri Mar 12 10:51:15 1999
@@ -1,4 +1,4 @@
-#This file was created by <karger> Tue Mar 2 14:59:26 1999
+#This file was created by <karger> Fri Mar 12 10:51:15 1999
#LyX 1.0 (C) 1995-1998 Matthias Ettrich and the LyX Team
\lyxformat 2.15
\textclass book
@@ -377,7 +377,11 @@
\begin_inset Quotes eld
\end_inset
-1.__Introduction
+1.
+\protected_separator
+
+\protected_separator
+Introduction
\begin_inset Quotes erd
\end_inset
@@ -413,7 +417,7 @@
section inside the file.
\layout Standard
-Then there's the problem of consistency.
+Now let's look at the problem of consistency.
Five days later, you reopen your report and start section 4.
However, you forget that you were using 18pt bold instead of 16pt, so you
type in the heading for section 4 in a different font that what you used
@@ -457,7 +461,15 @@
\begin_inset Quotes erd
\end_inset
- (WYSIWYM).
+ or
+\begin_inset Quotes eld
+\end_inset
+
+WYSIWYM.
+\begin_inset Quotes erd
+\end_inset
+
+
\layout Subsection
Differences between LyX and Word Processors
@@ -583,6 +595,44 @@
Okay, we know nothing is perfect, but LaTeX is as close to bug-free as any
computer program can get.
\end_float
+\layout Standard
+
+A final, and most important, difference between LyX and other word processors
+ is stability.
+ Unlike certain commercial word processors, LyX does
+\emph on
+not
+\emph default
+ claim to be stable only to crash every 30 minutes when given a large document.
+ The LyX Team knows we won't catch every single bug, nor do we try to pass
+ off bugs as features.
+ When those bugs [oh, sorry\SpecialChar \ldots{}
+
+\begin_inset Quotes eld
+\end_inset
+
+features
+\begin_inset Quotes erd
+\end_inset
+
+\SpecialChar \ldots{}
+] rear their ugly head, you might think LyX will drag your last 3 pages
+ of creative endeavor into oblivion with it.
+
+\layout Standard
+
+Nope.
+
+\layout Standard
+
+Whenever LyX crashes, it dumps any document in memory to an emergency save
+ file before dying.
+ Upon restart, LyX will notice these emergency saves, specifically when
+ you try and reload the affected file[s].
+ LyX then prompts you, asking whether to load the emergency save file, or
+ the original file, depending on which is newer.
+ Many users have written their doctoral dissertations using LyX.
+ They seldom, if ever, lost a page, despite an occasional crash.
\layout Subsection
What the heck
@@ -680,7 +730,7 @@
Ordinary users
don't work with raw TeX, which are the bare-bones typesetting commands.
People creating new macro-packages do that.
- And here's where Leslie Lamport enters our story.
+ This is where Leslie Lamport enters our story.
He wanted a macro package that was more user-oriented and less typesetter-orien
ted, a set of commands that consistently typeset things like sections or
tables or math formulae in a uniform, consistent fashion with as little
@@ -696,7 +746,7 @@
of course] began to work on LaTeX2e, the current version of LaTeX, during
the late 1980's.
This new version of LaTeX has commands which provide an easier-to-use interface
- to TeX's macro-creating commands [remember TeX?], aid in the using of new
+ to TeX's macro-creating commands [remember TeX?], aid in the use of new
fonts, and so on.
In fact, LaTeX is quite an extensive language in its own right! Users around
the world have been creating their own add-ons for LaTeX beyond the standard
@@ -878,9 +928,10 @@
\layout Standard
Because there's lots of information that we won't be giving you, the
-\series bold
+\emph on
first
\series medium
+\emph default
thing that you need to do is find the
\series default
other
@@ -1288,13 +1339,16 @@
\family default
to get it back.
-\emph on
-Currently, undo is limited to 100 steps.
+\begin_deeper
+\layout Standard
+
+[Currently, undo is limited to 100 steps.
Undo also doesn't work for
-\emph default
-everything
\emph on
-, not for changes to the document layout for instance.
+everything
+\emph default
+, not for changes to the document layout for instance.]
+\end_deeper
\layout Description
Cut/Paste/Copy Use
