From: Pavel Sanda <sanda@lyx.org>
Date: Fri, 25 Aug 2023 18:55:21 +0000 (+0200)
Subject: * Intro.lyx from Dan.
X-Git-Url: https://git.lyx.org/gitweb/?a=commitdiff_plain;h=877582721d47bdb7969145c456aeee4a79ad7efe;p=features.git

* Intro.lyx from Dan.
---

diff --git a/lib/doc/Intro.lyx b/lib/doc/Intro.lyx
index dcbb73719a..e5b2141860 100644
--- a/lib/doc/Intro.lyx
+++ b/lib/doc/Intro.lyx
@@ -1,5 +1,5 @@
 #LyX 2.4 created this file. For more info see https://www.lyx.org/
-\lyxformat 614
+\lyxformat 618
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -88,6 +88,7 @@
 \suppress_date false
 \justification true
 \use_refstyle 0
+\use_formatted_ref 0
 \use_minted 0
 \use_lineno 0
 \index Index
@@ -115,7 +116,9 @@
 \html_be_strict false
 \docbook_table_output 0
 \docbook_mathml_prefix 1
+\author -1463541724 "Daniel" d3vf4n@tutanota.com
 \author -584632292 "Richard Kimberly Heck"
+\author 5863208 "ab"
 \end_header
 
 \begin_body
@@ -203,7 +206,11 @@ What is \SpecialChar LyX
  articles in refereed scientific journals,
  scripts for plays and movies,
  business proposals,
- presentations \SpecialChar ldots
+ presentations
+\change_deleted -1463541724 1692922495
+ 
+\change_unchanged
+\SpecialChar ldots
 
 \end_layout
 
@@ -322,11 +329,20 @@ Suppose you are writing a report.
 \begin_inset Quotes eld
 \end_inset
 
-Introduction\SpecialChar endofsentence
+Introduction
+\change_deleted -1463541724 1692922782
+\SpecialChar endofsentence
+
+\change_unchanged
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692922792
+\SpecialChar endofsentence
+
+\change_unchanged
  So,
  you go into whatever menu it is in your word processor that changes font sizes and decide on a new font size.
  Then you turn on bold face.
@@ -455,10 +471,19 @@ how
 \begin_inset Quotes eld
 \end_inset
 
-What You See Is What You Get,
+What You See Is What You Get
+\change_deleted -1463541724 1692922450
+,
+\change_unchanged
+
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692923936
+,
+
+\change_unchanged
  the \SpecialChar LyX
  model is 
 \begin_inset Quotes eld
@@ -473,13 +498,24 @@ Mean
 \end_inset
 
  or 
+\change_deleted -1463541724 1692923839
+
 \begin_inset Quotes eld
 \end_inset
 
-WYSIWYM.
+
+\change_unchanged
+WYSIWYM
+\change_deleted -1463541724 1692923836
+.
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692923925
+.
+
+\change_unchanged
  It's a powerful idea that greatly simplifies the mechanics of writing documents.
  This is also why \SpecialChar LyX
  isn't so good for creating posters and flyers.
@@ -690,7 +726,11 @@ What is \SpecialChar LaTeX
 
 \begin_layout Standard
 \SpecialChar LaTeX
- is a document preparation system designed by Leslie Lamport in 1985.
+ is a document preparation system designed by 
+\noun on
+Leslie Lamport
+\noun default
+ in 1985.
 \begin_inset Foot
 status collapsed
 
@@ -714,7 +754,11 @@ User's Guide
 
  It was built up from a typesetting language called \SpecialChar TeX
 ,
- created by Donald Knuth in 1984.
+ created by 
+\shape smallcaps
+Donald Knuth
+\shape default
+ in 1984.
  \SpecialChar TeX
  takes a sequence of typesetting commands,
  written in a script in an ASCII file,
@@ -727,11 +771,31 @@ tricks
 \begin_inset Quotes erd
 \end_inset
 
- of the printing trade were modeled by Knuth as computer algorithms and incorporated into \SpecialChar TeX
+ of the printing trade were modeled by 
+\shape smallcaps
+Knuth
+\shape default
+ as computer algorithms and incorporated into \SpecialChar TeX
 ,
  hence its excellent printed appearance.
  What comes directly out of \SpecialChar TeX
- is the portable document format 
+ is the 
+\change_inserted -1463541724 1692922633
+
+\begin_inset Quotes eld
+\end_inset
+
+
+\change_unchanged
+portable document format
+\change_inserted -1463541724 1692922640
+
+\begin_inset Quotes erd
+\end_inset
+
+
+\change_unchanged
+ 
 \emph on
 pdf
 \emph default
@@ -748,7 +812,11 @@ device independent
 dvi
 \emph default
 .
- The dvi format is often used for previews and can later be converted to other formats like PostScript.
+ The 
+\family typewriter
+dvi
+\family default
+ format is often used for previews and can later be converted to other formats like PostScript.
  
 \end_layout
 
@@ -757,8 +825,16 @@ dvi
  isn't only a typesetting engine;
  it also allows you to define macros.
  Most people who use \SpecialChar 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.
+ are actually using a macro package which 
+\noun on
+Knuth
+\noun default
+ created to hide a lot of the typesetting details.
+ This is where 
+\noun on
+Leslie Lamport
+\noun default
+ enters our story.
  He wanted a macro package that was more user- and less typesetter-oriented,
  with a set of commands that consistently typeset things like sections,
  tables or math formulas in a uniform,
@@ -932,7 +1008,19 @@ Hopefully,
 \begin_inset Quotes eld
 \end_inset
 
-Real Jobs
+
+\change_inserted -1463541724 1692917953
+r
+\change_deleted -1463541724 1692917953
+R
+\change_unchanged
+eal 
+\change_inserted -1463541724 1692963264
+j
+\change_deleted -1463541724 1692963263
+J
+\change_unchanged
+obs
 \begin_inset Quotes erd
 \end_inset
 
@@ -967,7 +1055,11 @@ Also,
  is unclear,
  or wrong,
  don't hesitate to let us know!
- You can reach the current document maintainers by emailing 
+ You can reach the current document
+\change_inserted -1463541724 1692963407
+ation
+\change_unchanged
+ maintainers by emailing 
 \begin_inset CommandInset href
 LatexCommand href
 target "lyx-docs@lists.lyx.org"
@@ -977,6 +1069,8 @@ literal "false"
 \end_inset
 
 .
+
+\change_deleted -1463541724 1692922571
  
 \change_inserted -584632292 1610248366
 
@@ -1046,7 +1140,7 @@ Some of you may have printed out the manuals.
  which looks like this:
  
 \begin_inset Graphics
-	filename clipart/footnote.png
+	filename /home/paf/lyx/devel/lib/doc/clipart/footnote.png
 	scale 95
 
 \end_inset
@@ -1075,7 +1169,7 @@ In the printed manuals,
  all cross-references appear as light-grey boxes like the following:
  
 \begin_inset Graphics
-	filename clipart/reference.png
+	filename /home/paf/lyx/devel/lib/doc/clipart/reference.png
 	scale 95
 
 \end_inset
@@ -1122,7 +1216,11 @@ Emphasized Style
 \emph default
  is used for general emphasis,
  generic arguments,
- book titles,
+ book
+\change_inserted -1463541724 1692964248
+ and manual
+\change_unchanged
+ titles,
  names of sections of other manuals,
  and notes from the authors.
 \end_layout
@@ -1143,7 +1241,11 @@ Typewriter
 Sans Serif
 \family default
  is used for menu,
- button,
+ button
+\change_deleted -1463541724 1692964370
+,
+
+\change_unchanged
  or dialog box names,
  and the names of keyboard keys.
 \end_layout
@@ -1154,6 +1256,38 @@ Sans Serif
 Noun Style
 \noun default
  is used for people's names.
+\change_deleted 5863208 1692989367
+
+\begin_inset Note Note
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692964472
+This document has some person names (Leslie Lamport,
+ Donald Knuth) and none of them is typ
+\change_inserted 5863208 1692989355
+e
+\change_inserted -1463541724 1692964472
+set with this font face.
+ Shall we change them?
+\change_inserted 5863208 1692989346
+
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted 5863208 1692989349
+Done.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+
 \end_layout
 
 \begin_layout Itemize
@@ -1163,25 +1297,55 @@ Bold
 \series default
  is used for \SpecialChar LaTeX
  code
+\change_inserted -1463541724 1692842469
+.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
 When we do need to reference keys,
  we'll use the following prefixing convention:
+\change_deleted 5863208 1692989463
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692842873
+Do not think quotation marks are necessary when already using a different font face to differentiate the text.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+
 \end_layout
 
 \begin_layout Itemize
+
+\change_deleted -1463541724 1692842633
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Ctrl+
+\change_deleted -1463541724 1692842626
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  indicates the 
 \family sans
 Control
@@ -1190,17 +1354,25 @@ Control
 \end_layout
 
 \begin_layout Itemize
+
+\change_deleted -1463541724 1692842634
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Shift+
+\change_deleted -1463541724 1692842636
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  indicates the 
 \family sans
 Shift
@@ -1209,17 +1381,25 @@ Shift
 \end_layout
 
 \begin_layout Itemize
+
+\change_deleted -1463541724 1692842640
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Alt+
+\change_deleted -1463541724 1692842639
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  indicates the 
 \family sans
 Alt
@@ -1232,172 +1412,298 @@ Meta
 \end_layout
 
 \begin_layout Itemize
+
+\change_deleted -1463541724 1692842642
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 F1
+\change_deleted -1463541724 1692842642
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  \SpecialChar ldots
  
+\change_deleted -1463541724 1692842644
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 F12
+\change_deleted -1463541724 1692842646
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  are the function keys.
 \end_layout
 
 \begin_layout Itemize
+
+\change_deleted -1463541724 1692842662
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Esc
+\change_deleted -1463541724 1692842663
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  is the escape key.
 \end_layout
 
 \begin_layout Itemize
+
+\change_deleted -1463541724 1692842660
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Left
+\change_deleted -1463541724 1692842658
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692964502
+,
+
+\change_unchanged
  
+\change_deleted -1463541724 1692842658
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Right
+\change_deleted -1463541724 1692842648
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692964504
+,
+
+\change_unchanged
  
+\change_deleted -1463541724 1692842649
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Up
+\change_deleted -1463541724 1692842651
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692964516
+ and
+\change_unchanged
  
+\change_deleted -1463541724 1692842650
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Down
+\change_deleted -1463541724 1692842655
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
 :
  self-explanatory.
 \end_layout
 
 \begin_layout Itemize
 
+\change_deleted -1463541724 1692842666
+
 \family sans
 \begin_inset Quotes eld
 \end_inset
 
+
+\change_unchanged
 Insert
+\change_deleted -1463541724 1692842664
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692964521
+,
+
+\change_unchanged
  
+\change_deleted -1463541724 1692842665
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Delete
+\change_deleted -1463541724 1692842667
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692964524
+,
+
+\change_unchanged
  
+\change_deleted -1463541724 1692842668
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Home
+\change_deleted -1463541724 1692842670
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692964525
+,
+
+\change_unchanged
  
+\change_deleted -1463541724 1692842671
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 End
+\change_deleted -1463541724 1692842672
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692964527
+,
+
+\change_unchanged
  
+\change_deleted -1463541724 1692842673
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 PageUp
+\change_deleted -1463541724 1692842674
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692964535
+ and
+\change_unchanged
  
+\change_deleted -1463541724 1692842675
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 PageDown
+\change_deleted -1463541724 1692842677
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
 :
  these are the 6
 \begin_inset space ~
@@ -1405,53 +1711,85 @@ PageDown
 
 keys that appear above the cursor keys on many PC keyboards.
  
+\change_deleted -1463541724 1692842683
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 PageUp
+\change_deleted -1463541724 1692842681
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  and 
+\change_deleted -1463541724 1692842756
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 PageDown
+\change_deleted -1463541724 1692842758
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  are called 
+\change_deleted -1463541724 1692842752
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Prior
+\change_deleted -1463541724 1692842750
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  and 
+\change_deleted -1463541724 1692842754
+
 \begin_inset Quotes eld
 \end_inset
 
 
+\change_unchanged
+
 \family sans
 Next
+\change_deleted -1463541724 1692842755
+
 \family default
 
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_unchanged
  on some keyboards.
 \end_layout
 
@@ -1473,18 +1811,63 @@ Return
 \begin_inset Quotes eld
 \end_inset
 
-Return,
+Return
+\change_deleted -1463541724 1692842976
+,
+\change_unchanged
+
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692842978
+,
+
+\change_unchanged
  others as 
 \begin_inset Quotes eld
 \end_inset
 
-Enter,
+Enter
+\change_deleted -1463541724 1692842982
+,
+\change_unchanged
+
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692842991
+,
+\change_deleted 5863208 1692989468
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692966623
+Not direct speech,
+ so punctuation goes out of the quoted text.
+ See 
+\begin_inset CommandInset href
+LatexCommand href
+name "Cambridge grammar (punctuation)"
+target "https://dictionary.cambridge.org/grammar/british-grammar/punctuation"
+literal "false"
+
+\end_inset
+
+ or Collins grammar,
+ to name a couple.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
  still others have two keys.
  \SpecialChar LyX
  treats all of them as the same key,
@@ -2091,15 +2474,48 @@ Tutorial
 \emph default
 ,
  starting with the section on 
+\change_deleted -1463541724 1692917771
+
 \begin_inset Quotes eld
 \end_inset
 
+
+\change_unchanged
+
+\emph on
 \SpecialChar LyX
  for \SpecialChar LaTeX
- users.
+ users
+\change_deleted -1463541724 1692917763
+
+\emph default
+.
 \begin_inset Quotes erd
 \end_inset
 
+
+\change_inserted -1463541724 1692917775
+.
+\change_deleted 5863208 1692989483
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692918131
+Again,
+ don't see the point in quoting text already using a different font face.
+ Additionally,
+ was not complying to the use of font faces in the manuals stated in section 2.2.
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
  (Skimming through the rest of the document wouldn't hurt,
  either.)
 \end_layout
@@ -2211,9 +2627,15 @@ some
  information on installation and customization,
  but refers the reader to the 
 \emph on
-Customization Manual
+Customization
 \emph default
- for more information.
+ 
+\change_deleted -1463541724 1692964787
+M
+\change_inserted -1463541724 1692964788
+m
+\change_unchanged
+anual for more information.
 \end_layout
 
 \begin_layout Standard
@@ -2330,12 +2752,61 @@ literal "false"
  Archives of this list are linked from the main \SpecialChar LyX
  website,
  
+\change_deleted 5863208 1692989524
+
 \begin_inset CommandInset href
 LatexCommand href
 target "http://www.lyx.org"
 
 \end_inset
 
+
+\change_inserted 5863208 1692989534
+
+\begin_inset CommandInset href
+LatexCommand href
+target "https://www.lyx.org/MailingLists"
+literal "false"
+
+\end_inset
+
+
+\change_deleted 5863208 1692989524
+
+\begin_inset Note Note
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692966662
+Substitute this link for the more specific 
+\begin_inset CommandInset href
+LatexCommand href
+target "https://www.lyx.org/MailingLists#toc3"
+
+\end_inset
+
+ or maybe just 
+\change_deleted 5863208 1692989514
+
+\begin_inset CommandInset href
+LatexCommand href
+target "https://www.lyx.org/MailingLists"
+literal "false"
+
+\end_inset
+
+
+\change_inserted -1463541724 1692966662
+?
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
 .
 \end_layout
 
@@ -2360,6 +2831,82 @@ config.log
 \family default
 ,
  and mention which compiler you are using.
+
+\change_inserted 5863208 1692989585
+ 
+\begin_inset Quotes eld
+\end_inset
+
+Part of this information can be found in 
+\family sans
+Help\SpecialChar menuseparator
+About
+\family default
+.
+\begin_inset Quotes erd
+\end_inset
+
+
+\change_deleted 5863208 1692989598
+
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692957260
+Shall we mention this information can be found in 
+\family sans
+Help\SpecialChar menuseparator
+About
+\family default
+?
+ For instance:
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692966675
+\begin_inset Quotes eld
+\end_inset
+
+Most of this information can be found in 
+\family sans
+Help\SpecialChar menuseparator
+About
+\family default
+.
+\begin_inset Quotes erd
+\end_inset
+
+ or
+\end_layout
+
+\begin_layout Plain Layout
+
+\change_inserted -1463541724 1692966688
+\begin_inset Quotes eld
+\end_inset
+
+Part of this information can be found in 
+\family sans
+Help\SpecialChar menuseparator
+About
+\family default
+.
+\begin_inset Quotes erd
+\end_inset
+
+
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+
+\change_unchanged
+
 \end_layout
 
 \begin_layout Subsubsection
@@ -2448,7 +2995,12 @@ User's Guide
  and the 
 \emph on
 Tutorial
+\change_inserted -1463541724 1692966436
+
 \emph default
+\SpecialChar endofsentence
+
+\change_unchanged
 
 \begin_inset Newline newline
 \end_inset