]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/Intro.lyx
Intro.lyx: some typographic issues and a typo spotted by JR Hudson
[lyx.git] / lib / doc / Intro.lyx
index 457910e55aa882631900194c9fa02605d1731035..6b0c6c1263288517d897bba02350391a129065bc 100644 (file)
@@ -1,5 +1,5 @@
-#LyX 1.6.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 344
+#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
+\lyxformat 404
 \begin_document
 \begin_header
 \textclass article
 % redefine the \LyX macro for PDF bookmarks
 \def\LyX{\texorpdfstring{%
   L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@}
-  {LyX }}
+  {LyX}}
 \end_preamble
 \use_default_options false
+\maintain_unincluded_children false
 \language english
 \inputencoding auto
+\fontencoding global
 \font_roman default
 \font_sans default
 \font_typewriter default
 \font_default_family default
+\use_xetex false
 \font_sc false
 \font_osf false
 \font_sf_scale 100
 \font_tt_scale 100
 
 \graphics default
+\default_output_format default
+\output_sync 0
+\bibtex_command default
+\index_command default
 \paperfontsize 12
 \spacing single
 \use_hyperref true
 \use_geometry false
 \use_amsmath 1
 \use_esint 0
+\use_mhchem 1
+\use_mathdots 1
 \cite_engine basic
 \use_bibtopic false
+\use_indices false
 \paperorientation portrait
+\suppress_date false
+\use_refstyle 0
+\index Index
+\shortcut idx
+\color #008000
+\end_index
 \secnumdepth 3
 \tocdepth 2
 \paragraph_separation indent
-\defskip medskip
+\paragraph_indentation default
 \quotes_language english
 \papercolumns 1
 \papersides 1
 \paperpagestyle default
 \tracking_changes false
 \output_changes false
-\author "" 
-\author "" 
+\html_math_output 0
+\html_be_strict false
 \end_header
 
 \begin_body
@@ -139,7 +155,7 @@ LyX is a document preparation system.
  It excels at letting you create complex technical and scientific articles
  with mathematics, cross-references, bibliographies, indices, etc.
  It is very good at documents of any length in which the usual processing
- abilities are required: automatic sectioning and pagination, spellchecking,
+ abilities are required: automatic sectioning and pagination, spell checking,
  and so forth.
  It can also be used to write a letter to your mom, though granted, there
  are probably simpler programs available for that.
@@ -168,7 +184,7 @@ typewriter concept
  It is designed for authors who want professional output quickly with a
  minimum of effort without becoming specialists in typesetting.
  The job of typesetting is done mostly by the computer, not the author;
- with LyX, the author can concentrate on the contents of her writing.
+ with LyX, the author can concentrate on the contents of his writing.
 \end_layout
 
 \begin_layout Standard
@@ -304,7 +320,7 @@ Introduction\SpecialChar \@.
 
 \begin_layout Standard
 Yes, that's all.
- If you cut and paste the section, it will automatically be renumbered ---
+ If you cut and paste the section, it will automatically be renumbered 
  everywhere.
  And if you enter references to that section correctly (by inserting cross-refer
 ence tags), LyX will automatically update them all throughout the file so
@@ -318,12 +334,19 @@ Now let's look at the problem of consistency.
 \end_inset
 
 4.
- However, you forget that you were using 18pt bold instead of 16pt, so you
- type in the heading for Section
+ However, you forget that you were using 18
+\begin_inset space \thinspace{}
+\end_inset
+
+pt bold instead of 16
+\begin_inset space \thinspace{}
+\end_inset
+
+pt, so you type in the heading for Section
 \begin_inset space ~
 \end_inset
 
-4 in a different font that what you used for Section
+4 in a different font from the one you used for Section
 \begin_inset space ~
 \end_inset
 
@@ -385,21 +408,21 @@ WYSIWYM.
 \end_inset
 
  It's a powerful idea that greatly simplifies the mechanics of writing documents.
- This is also why LyX isn't so good for creating posters and flyers---in
- this case, you 
+ This is also why LyX isn't so good for creating posters and flyers.
In this case, you 
 \emph on
 do
 \emph default
  want to specify exactly where everything goes, because there are no functional
  units like paragraphs, sections, etc.
  This doesn't mean LyX is missing some cool function.
- It simply means that it isn't the right tool for the job --- you don't
use a screwdriver to drive in nails.
+ It simply means that it isn't the right tool for the job — you don't use
+ a screwdriver to drive in nails.
 \end_layout
 
 \begin_layout Subsection
 Differences between LyX and Other Word Processors
-\begin_inset OptArg
+\begin_inset Argument
 status collapsed
 
 \begin_layout Plain Layout
@@ -447,7 +470,11 @@ Tab stops
 \end_layout
 
 \begin_layout Itemize
-Extra whitespace (i.e.
+Extra whitespace (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
 \begin_inset space \space{}
 \end_inset
 
@@ -485,7 +512,11 @@ Page breaks
 \end_layout
 
 \begin_layout Itemize
-Line spacing (i.e.
+Line spacing (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
 \begin_inset space \space{}
 \end_inset
 
@@ -645,7 +676,7 @@ dvi
 \end_layout
 
 \begin_layout Standard
-TeX isn't only a typesetting engine, it also allows you to define macros.
+TeX isn't only a typesetting engine; it also allows you to define macros.
  Most people who use TeX are actually using a macro package which Knuth
  created to hide a lot of the typesetting details.
  This is where Leslie Lamport enters our story.
@@ -752,7 +783,7 @@ Navigating the Documentation
 To make it easier to answer your questions and describe all of the features
  of LyX, the documentation has been split up into several different files.
  Each one has its own purpose, as described below.
- Before you go plowing into any of those files, however, you should read
+ Before you go ploughing into any of those files, however, you should read
  this chapter thoroughly first, since it contains a lot of useful information
  and commentary that can save you some time.
 \end_layout
@@ -785,7 +816,7 @@ reference "sec:Contrib"
 \end_layout
 
 \begin_layout Standard
-Also, please do us a favor -- if anything in these manuals confuses you,
+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 
 \begin_inset CommandInset href
@@ -851,15 +882,6 @@ In the printed manuals, all cross-references appear as the actual numbers
 .
  If you click on that box with the left mouse button, a dialog box will
  appear containing a list of all the cross-references in the document.
- This introduction has only two, the first one is named 
-\begin_inset Quotes eld
-\end_inset
-
-sec:Contrib
-\begin_inset Quotes erd
-\end_inset
-
-.
  You can go to the referred section by right-clicking on the box or by clicking
  the button 
 \family sans
@@ -877,7 +899,11 @@ Label
  Going back to where you came from is just as easy.
  Clicking on 
 \family sans
-Go back
+Go
+\begin_inset space ~
+\end_inset
+
+Back
 \family default
  to go back to your earlier location.
 \end_layout
@@ -932,30 +958,7 @@ Bold
 \end_layout
 
 \begin_layout Standard
-For menu accelerator keys and keybindings, you'll probably get referred
- to the 
-\emph on
-Key Bindings
-\emph default
- section of the 
-\begin_inset Quotes eld
-\end_inset
-
-
-\emph on
-Addtional Features Manual
-\emph default
-
-\begin_inset Quotes erd
-\end_inset
-
- (the file 
-\family typewriter
-Extended.lyx
-\family default
-).
- When we do need to reference keys, we'll use the following prefixing convention
-:
+When we do need to reference keys, we'll use the following prefixing convention:
 \end_layout
 
 \begin_layout Itemize
@@ -964,7 +967,7 @@ Extended.lyx
 
 
 \family sans
-C-
+Ctrl-
 \family default
 
 \begin_inset Quotes erd
@@ -972,7 +975,7 @@ C-
 
  indicates the 
 \family sans
-Control-
+Control
 \family default
  key.
 \end_layout
@@ -983,7 +986,7 @@ Control-
 
 
 \family sans
-S-
+Shift-
 \family default
 
 \begin_inset Quotes erd
@@ -991,7 +994,7 @@ S-
 
  indicates the 
 \family sans
-Shift-
+Shift
 \family default
  key.
 \end_layout
@@ -1002,7 +1005,7 @@ Shift-
 
 
 \family sans
-M-
+Alt-
 \family default
 
 \begin_inset Quotes erd
@@ -1010,13 +1013,13 @@ M-
 
  indicates the 
 \family sans
-Meta-
+Alt
 \family default
- key, which on some keyboards will be the 
+ (
 \family sans
-Alt-
+Meta
 \family default
- key.
+) key.
 \end_layout
 
 \begin_layout Itemize
@@ -1280,72 +1283,15 @@ Enter
 \end_layout
 
 \begin_layout Standard
-You'll also see something like 
-\begin_inset Quotes eld
-\end_inset
-
-(See 
-\emph on
-
-\begin_inset Quotes els
-\end_inset
-
-Extended
-\emph default
-
-\begin_inset Quotes ers
-\end_inset
-
-)
-\begin_inset Quotes erd
-\end_inset
-
- from time to time.
- We've listed the possible default keybindings for a function in its entry
- in the 
-\begin_inset Quotes eld
-\end_inset
-
-
-\emph on
-Additional Features Manual
-\emph default
-,
-\begin_inset Quotes erd
-\end_inset
-
- so check there, too.
- Note that there are two different keybinding maps in common use in the
- LyX community: the 
-\begin_inset Quotes eld
-\end_inset
-
-CUA
-\begin_inset Quotes erd
-\end_inset
-
- style which is the default and familiar to those coming from the PC world,
- and the 
-\begin_inset Quotes eld
-\end_inset
-
-emacs
-\begin_inset Quotes erd
-\end_inset
-
- style, which is common with those who 
-\begin_inset Quotes eld
-\end_inset
-
-grew up
-\begin_inset Quotes erd
-\end_inset
-
- on Unix systems and use the Emacs editor.
- Unless specifically noted, the keybindings in the documentation are from
- the default CUA map.
- If you like Emacs, you should be smart enough to read the documentation
- and figure out the bindings on your own.
+The list with the currently set shortcuts can be found in the 
+\family sans
+Help
+\family default
+ menu under 
+\family sans
+Shortcuts
+\family default
+.
 \end_layout
 
 \begin_layout Subsection
@@ -1403,7 +1349,7 @@ Units
 \align center
 \begin_inset Tabular
 <lyxtabular version="3" rows="20" columns="2">
-<features>
+<features tabularvalignment="middle">
 <column alignment="center" valignment="top" width="0">
 <column alignment="center" valignment="top" width="0">
 <row>
@@ -1891,8 +1837,12 @@ The Manuals
 \end_layout
 
 \begin_layout Standard
-The following list describes the contents of each of the files in the documentat
-ion:
+The following list describes the contents of the basic documentation files
+ that you find in the 
+\family sans
+Help
+\family default
+ menu:
 \end_layout
 
 \begin_layout Description
@@ -1945,12 +1895,22 @@ Objects Extension of the
 User's Guide
 \emph default
 .
- Documents in detail how to use tables, graphics, floats, notes, and boxes.
+ Documents in detail how to use tables, graphics, floats, notes, program
+ listings, and boxes.
  It also includes many tricks of the LaTeX masters.
 \end_layout
 
 \begin_layout Description
-Extended
+Math Extension of the 
+\emph on
+User's Guide
+\emph default
+.
+ Documents in detail how to typeset any kind of formulas.
+\end_layout
+
+\begin_layout Description
+Additional
 \begin_inset space ~
 \end_inset
 
@@ -1968,6 +1928,12 @@ Customization A description of advanced LyX features, including how to customize
  the overall behavior of LyX\SpecialChar \@.
  This includes such things as keybindings, internati
 onalization, and configuration files.
+ It also includes information about layout files, which are needed to get
+ LyX to support LaTeX classes or packages.
+\end_layout
+
+\begin_layout Description
+Shortcuts Tables with the currently defined LyX shortcuts.
 \end_layout
 
 \begin_layout Description
@@ -2029,8 +1995,6 @@ Tutorial
 
 \begin_layout Standard
 Otherwise, you could needlessly frustrate yourself.
- LyX does all that you need a word processor to do, but using a different
- approach.
 \end_layout
 
 \begin_layout Section
@@ -2075,7 +2039,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://bugzilla.lyx.org/
+http://www.lyx.org/trac/wiki/BugTrackerHome
 \end_layout
 
 \end_inset
@@ -2199,15 +2163,6 @@ http://www.lyx.org/trac/browser/lyx-devel/trunk/lib/doc
 \end_inset
 
  
-\begin_inset Newline newline
-\end_inset
-
-Inside that directory is a file called 
-\family typewriter
-DocStyle.lyx
-\family default
-.
- Read it; it's the style sheet for the documentation.
 \end_layout
 
 \begin_layout Enumerate