]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
Fix default mark (#8454)
[lyx.git] / lib / doc / UserGuide.lyx
index 6f821643d0b253cce79596394a6f2d9393888b9c..08845212b7695063bc177f021753a8b202c503d2 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.4 created this file. For more info see https://www.lyx.org/
-\lyxformat 590
+\lyxformat 598
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -54,7 +54,7 @@ customHeadersFooters
 enumitem
 logicalmkup
 \end_modules
-\maintain_unincluded_children false
+\maintain_unincluded_children no
 \language english
 \language_package default
 \inputencoding utf8
@@ -138,7 +138,7 @@ logicalmkup
 \secnumdepth 3
 \tocdepth 2
 \paragraph_separation skip
-\defskip medskip
+\defskip halfline
 \is_math_indent 0
 \math_numbering_side default
 \quotes_style english
@@ -150,13 +150,19 @@ logicalmkup
 \tracking_changes true
 \output_changes false
 \change_bars false
+\postpone_fragile_content false
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict true
+\docbook_table_output 0
 \author -1402925745 "Günter Milde"
 \author -712698321 "Jürgen Spitzmüller"
+\author -584632292 "Richard Kimberly Heck"
 \author -563046850 "Jean-Marc LASGOUTTES"
+\author -131811572 "Yuriy Skalko"
 \author 5863208 "ab"
+\author 5863344 "Enrico Forestieri"
+\author 1675569489 "Stephan Witt"
 \end_header
 
 \begin_body
@@ -4139,8 +4145,14 @@ Class
 
 \begin_layout Standard
 The drop box 
+\change_deleted -712698321 1597235163
+
 \family sans
 Headings
+\change_inserted -712698321 1597235164
+Page
+\change_unchanged
+
 \begin_inset space ~
 \end_inset
 
@@ -5209,7 +5221,13 @@ Subparagraph
 \SpecialChar LyX
  labels each heading with a series of numbers, separated by periods.
  The numbers describe where in the document you are.
- Unlike the other headings, parts are numbered with Latin letters.
+ Unlike the other headings, parts are numbered with 
+\change_inserted -131811572 1596358186
+Roman numerals
+\change_deleted -131811572 1596358192
+Latin letters
+\change_unchanged
+.
 \end_layout
 
 \begin_layout Standard
@@ -8484,14 +8502,12 @@ Verbatim
 \end_layout
 
 \begin_layout Verbatim
-
 This is Verbatim.
 \end_layout
 
 \begin_layout Verbatim
 \noindent
 \align block
-
 The following 2 lines are empty:
 \end_layout
 
@@ -8504,7 +8520,6 @@ The following 2 lines are empty:
 \end_layout
 
 \begin_layout Verbatim
-
 Almost everything is allowed in Verbatim:"%&$§#~'`
 \backslash
 }][{|
@@ -8528,7 +8543,6 @@ Verbatim
 \end_layout
 
 \begin_layout Verbatim*
-
 This is Verbatim*.
 \end_layout
 
@@ -11029,6 +11043,70 @@ More Spaces
 You can also insert the following space types:
 \end_layout
 
+\begin_layout Description
+
+\change_inserted -712698321 1593161965
+Medium
+\begin_inset space ~
+\end_inset
+
+space 
+\change_unchanged
+A line with a 
+\begin_inset Formula $\to$
+\end_inset
+
+
+\begin_inset space \medspace{}
+\end_inset
+
+
+\begin_inset Formula $\gets$
+\end_inset
+
+\change_deleted -712698321 1593161991
+negative thin
+\change_inserted -712698321 1593161992
+medium
+\change_unchanged
+ space between the arrows.
+\change_inserted -712698321 1593162006
+
+\end_layout
+
+\begin_layout Description
+
+\change_deleted -712698321 1593162010
+Medium
+\change_inserted -712698321 1593162011
+Thick
+\change_unchanged
+
+\begin_inset space ~
+\end_inset
+
+space A line with a 
+\begin_inset Formula $\to$
+\end_inset
+
+
+\begin_inset space \thickspace{}
+\end_inset
+
+
+\begin_inset Formula $\gets$
+\end_inset
+
+\change_deleted -712698321 1593162017
+medium
+\change_inserted -712698321 1593162018
+thick
+\change_unchanged
+ space between the arrows.
+\end_layout
+
 \begin_layout Description
 Negative
 \begin_inset space ~
@@ -11266,7 +11344,7 @@ Width of the different horizontal spaces.
 \begin_layout Plain Layout
 \align center
 \begin_inset Tabular
-<lyxtabular version="3" rows="10" columns="2">
+<lyxtabular version="3" rows="12" columns="2">
 <features tabularvalignment="middle">
 <column alignment="center" valignment="top">
 <column alignment="center" valignment="top">
@@ -11363,6 +11441,62 @@ Thin
 em
 \end_layout
 
+\end_inset
+</cell>
+</row>
+<row change="inserted -712698321 1593161917">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1593161917
+Medium
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1593161917
+4
+\begin_inset space \thinspace{}
+\end_inset
+
+mu
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row change="inserted -712698321 1593161917">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1593161917
+Thick
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1593161917
+5
+\begin_inset space \thinspace{}
+\end_inset
+
+mu
+\end_layout
+
 \end_inset
 </cell>
 </row>
@@ -11696,7 +11830,17 @@ Right arrow:
 \end_layout
 
 \begin_layout Standard
-Up brace: 
+
+\change_deleted -712698321 1593242277
+Up
+\change_inserted -712698321 1593242278
+Down
+\change_unchanged
+ brace
+\change_inserted -712698321 1593242369
+ (= opened downwards)
+\change_unchanged
+: 
 \begin_inset space \downbracefill{}
 \end_inset
 
@@ -11708,7 +11852,17 @@ Up brace:
 \end_layout
 
 \begin_layout Standard
-Down brace: 
+
+\change_deleted -712698321 1593242281
+Down
+\change_inserted -712698321 1593242282
+Up
+\change_unchanged
+ brace
+\change_inserted -712698321 1593242378
+ (= opened upwards)
+\change_unchanged
+: 
 \begin_inset space \upbracefill{}
 \end_inset
 
@@ -11978,6 +12132,25 @@ DefSkip
 MedSkip
 \family default
 .
+\change_inserted -712698321 1593360527
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1593360570
+
+\family sans
+Half line height
+\family default
+ and 
+\family sans
+Line height
+\family default
+ equal to the height, or half the height, of a line in the current font
+ size including line spacing.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard
@@ -14977,6 +15150,8 @@ status open
 
 \change_inserted -712698321 1525607513
 no 
+\change_unchanged
+
 \end_layout
 
 \end_inset
@@ -18232,7 +18407,27 @@ Line breaks after unspaced dashes can be allowed via the menu
 \family sans
 Insert\SpecialChar menuseparator
 Formatting\SpecialChar menuseparator
-Optional line break
+Optional
+\change_deleted 1675569489 1580913043
+\change_inserted 1675569489 1580913043
+
+\begin_inset space ~
+\end_inset
+
+
+\change_unchanged
+line
+\change_deleted 1675569489 1580913068
+\change_inserted 1675569489 1580913068
+
+\begin_inset space ~
+\end_inset
+
+
+\change_unchanged
+break
 \family default
 :
 \end_layout
@@ -28013,7 +28208,7 @@ Typefaces and the corresponding commands.
 \begin_layout Plain Layout
 \align center
 \begin_inset Tabular
-<lyxtabular version="3" rows="9" columns="2">
+<lyxtabular version="3" rows="11" columns="2">
 <features tabularvalignment="middle">
 <column alignment="center" valignment="top" width="0pt">
 <column alignment="center" valignment="top" width="0pt">
@@ -28181,6 +28376,37 @@ mathtt
 mathbb
 \end_layout
 
+\end_inset
+</cell>
+</row>
+<row change="inserted 5863344 1592055455">
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\change_inserted 5863344 1592055455
+\begin_inset Formula $\mathds{DOUBLESTROKE}$
+\end_inset
+
+
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\change_inserted 5863344 1592055455
+
+\series bold
+
+\backslash
+mathds
+\end_layout
+
 \end_inset
 </cell>
 </row>
@@ -28242,6 +28468,44 @@ mathfrak
 mathcal
 \end_layout
 
+\end_inset
+</cell>
+</row>
+<row change="inserted -131811572 1591595416">
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\change_inserted -131811572 1591595416
+
+\shape up
+\size normal
+\emph on
+\bar no
+\noun off
+\color none
+\begin_inset Formula $\mathscr{SCRIPT}$
+\end_inset
+
+
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Plain Layout
+
+\change_inserted -131811572 1591595416
+
+\series bold
+
+\backslash
+mathscr
+\end_layout
+
 \end_inset
 </cell>
 </row>
@@ -28296,8 +28560,20 @@ Note:
  You can only print capital letters in the typefaces 
 \family sans
 Blackboard
+\change_inserted 5863344 1592055666
+, Double stroke
+\change_deleted -131811572 1591595671
+
 \family default
- and 
+\change_inserted -131811572 1591595667
+, 
+\family sans
+Script
+\family default
+\change_unchanged
+and 
 \family sans
 Calligraphic
 \family default
@@ -29839,6 +30115,95 @@ to the field
 Additional options
 \family default
  in the PDF Properties dialog.
+\change_inserted -584632292 1588303457
+
+\end_layout
+
+\begin_layout Section
+
+\change_inserted -584632292 1588303474
+Counters
+\begin_inset Index idx
+status open
+
+\begin_layout Plain Layout
+Counters
+\end_layout
+
+\end_inset
+
+
+\begin_inset CommandInset label
+LatexCommand label
+name "sec:Counters"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -584632292 1588374084
+One powerful feature of \SpecialChar LaTeX
+ is its ability to manage counters.
+ Mostly, this is handled automatically, but there are times one wants to
+ modify counters directly.
+ This can be done in LyX using the counter inset, which is accessible from
+ the Insert menu.
+ This allows one to set a counter's value; to reset it (to zero); to add
+ to the value (or subtract from it, since the value added can be negative);
+ to save it; to restore the saved value; and to print the value.
+ These effects can also be limited to LyX itself.
+ And they will appear in HTML and DocBook output, as well as in LaTeX.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -584632292 1588529162
+There are five commands you can use:
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted -584632292 1588529167
+Set counter: Allows you to assign a specific value to a counter
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted -584632292 1588529177
+Increase counter: Allows you to add some specified amount to a counter (or
+ to subtract, if you choose a negative number)
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted -584632292 1588529180
+Reset to zero: Sets the value of the counter to 0.
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted -584632292 1588529184
+Save value of counter: Saves the value of the counter so that it can later
+ be restored.
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted -584632292 1588529187
+Restore value of counter: Restores the previously saved value.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -584632292 1588374230
+The dialog allows you to choose which counter you wish to modify from all
+ those that are available in the current document class.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Section
@@ -40358,8 +40723,10 @@ Visible
 \begin_inset space ~
 \end_inset
 
-Space Inserts a character representing a single space (the one you get when
- pressing the 
+Space 
+\change_deleted -712698321 1590482504
+Inserts a character representing a single space (the one you get when pressing
+ the 
 \family sans
 Space
 \family default
@@ -40368,6 +40735,49 @@ Space
 \end_inset
 
 
+\change_unchanged
+Inserts a character to visualize that there is or should be a space.
+ This is e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.
+\begin_inset space \space{}
+\end_inset
+
+useful if you need to indicate a space in a command sequence.
+ An example from the \SpecialChar LyX
+\emph on
+Math
+\emph default
+ manual: 
+\begin_inset Quotes eld
+\end_inset
+
+To insert a fraction use the command 
+\series bold
+
+\backslash
+frac
+\begin_inset space \textvisiblespace{}
+\end_inset
+
+A
+\begin_inset Formula $\downarrow$
+\end_inset
+
+B.
+\series default
+
+\begin_inset Quotes erd
+\end_inset
+
+ The visible space is hereby the character before the 
+\series bold
+A
+\series default
+.
 \end_layout
 
 \begin_layout Description
@@ -40539,6 +40949,8 @@ reference "subsec:Thin-Space"
 \end_layout
 
 \begin_layout Description
+
+\change_deleted -712698321 1590482457
 Visible
 \begin_inset space ~
 \end_inset
@@ -40585,6 +40997,8 @@ B.
 A
 \series default
 .
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -40753,8 +41167,11 @@ Justified
 \begin_inset space ~
 \end_inset
 
-Break Inserts a forced line break that right justifies the remaining text
- as described in section
+Break Inserts a forced line break that 
+\change_deleted -712698321 1590482910
+right 
+\change_unchanged
+justifies the remaining text as described in section
 \begin_inset space ~
 \end_inset
 
@@ -41366,7 +41783,11 @@ reference "sec:Floats"
 
 ; captions in multi-page tables are described in the section 
 \emph on
-Multi-page Captions
+Multi-page 
+\change_inserted -712698321 1590482693
+Table 
+\change_unchanged
+Captions
 \emph default
  of the 
 \emph on
@@ -43809,7 +44230,7 @@ Default
 \family sans
 \begin_inset Info
 type  "icon"
-arg   "layout Enumerate"
+arg   "layout-toggle Enumerate"
 \end_inset
 
 
@@ -43836,7 +44257,7 @@ Numbered list
 \family sans
 \begin_inset Info
 type  "icon"
-arg   "layout Itemize"
+arg   "layout-toggle Itemize"
 \end_inset
 
 
@@ -43863,7 +44284,7 @@ Itemized list
 \family sans
 \begin_inset Info
 type  "icon"
-arg   "layout List"
+arg   "layout-toggle List"
 \end_inset
 
 
@@ -43890,7 +44311,7 @@ List
 \family sans
 \begin_inset Info
 type  "icon"
-arg   "layout Description"
+arg   "layout-toggle Description"
 \end_inset
 
 
@@ -45578,6 +45999,8 @@ status collapsed
 \change_inserted -712698321 1557645185
 \SpecialChar LaTeX
  packages ! inputenc
+\change_unchanged
+
 \end_layout
 
 \end_inset
@@ -47725,25 +48148,105 @@ reference "sec:File-Formats"
 \end_layout
 
 \begin_layout Description
+
+\change_inserted -712698321 1578647276
+Allow
+\begin_inset space ~
+\end_inset
+
+running
+\begin_inset space ~
+\end_inset
+
+external
+\begin_inset space ~
+\end_inset
+
+programs If this is switched on, \SpecialChar LaTeX
+ is run with the 
+\family typewriter
+-shell-escape
+\family default
+ option which is needed with some packages.
+ Note that this comes with security risks, so please use this only when
+ really necessary and if you know what you are doing.
+\end_layout
+
+\begin_layout Description
+
+\change_inserted -712698321 1578647006
+LaTeX
+\begin_inset space ~
+\end_inset
+
+Output
+\begin_inset space ~
+\end_inset
+
+Options offers settings for the 
+\family sans
+LaTeX
+\family default
+ export.
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+
+\family sans
 Synchronize
+\change_inserted -712698321 1578646679
+\change_deleted -712698321 1578646679
+
 \begin_inset space ~
 \end_inset
 
+
+\change_unchanged
 with
+\change_deleted -712698321 1578646686
+
 \begin_inset space ~
 \end_inset
 
-Output settings for the menu 
+
+\change_inserted -712698321 1578646686
+\change_unchanged
+Output
+\family default
+\change_inserted -712698321 1578646719
+enables 
+\change_deleted -712698321 1578646729
+settings for the menu 
 \family sans
 Navigate\SpecialChar menuseparator
+
+\change_unchanged
 Forward
 \begin_inset space ~
 \end_inset
 
 search
+\change_inserted -712698321 1578646752
+
 \family default
+ and allows to customize the macro used in this process
+\change_deleted -712698321 1578646757
 .
- For a detailed description see section 
+
+\change_unchanged
+\change_inserted -712698321 1578646759
+(
+\change_deleted -712698321 1578646759
+F
+\change_inserted -712698321 1578646759
+f
+\change_unchanged
+or a detailed description see section 
 \emph on
 Reverse DVI/PDF search
 \emph default
@@ -47755,9 +48258,55 @@ Additional
 
 Features
 \emph default
- manual.
+ manual
+\change_inserted -712698321 1578646762
+)
+\change_unchanged
+.
+\change_inserted -712698321 1578647009
+
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1578647929
+
+\family sans
+Put fragile content out of moving arguments
+\family default
+ determines whether so-called 
+\begin_inset Quotes els
+\end_inset
+
+fragile
+\begin_inset Quotes ers
+\end_inset
+
+ \SpecialChar LaTeX
+ constructs (such as labels or index entries) are placed outside of so-called
+\begin_inset Quotes els
+\end_inset
+
+moving arguments
+\begin_inset Quotes ers
+\end_inset
+
+ in \SpecialChar LaTeX
+ (such as sections or captions), even if the corresponding insets are
+ placed in such context in \SpecialChar LyX
+.
+ This setting is on by default, since it prevents nasty \SpecialChar LaTeX
+ errors.
+ If you rely on labels or index entries being kept inside the problematic
+ macros, you can uncheck this.
+ If you don't know what we are talking about here, worry not: just leave
+ it checked.
+\change_unchanged
+
 \end_layout
 
+\end_deeper
 \begin_layout Description
 XHTML
 \begin_inset space ~
@@ -48793,6 +49342,29 @@ Ctrl+arrow key
 \family default
  the cursor jumps from the end of a word to the end of the next word.
  Normally it jumps from the beginning to the beginning.
+\change_inserted -712698321 1578924606
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1578924785
+The option 
+\family sans
+Keep change tracking markup on copy and paste
+\family default
+ is for users who don't want tracked changes to be dissolved on copy and
+ paste operations (i.
+\begin_inset space \thinspace{}
+\end_inset
+
+e., inserted as new text with the deletions removed).
+ If this is checked, the change-tracked text will be copied and pasted as
+ is, independent if changes are currently tracked or not.
+ This also applies to wrapping to\SpecialChar breakableslash
+dissolving from insets.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Standard