]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/UserGuide.lyx
UserGuide.lyx: next revision step
[lyx.git] / lib / doc / UserGuide.lyx
index 41dd4619146b0ada6f19c10fe57d4d40b939b4df..cb7e1d49f0bbc5c4455357e2490e7795792ba1b0 100644 (file)
@@ -4678,7 +4678,7 @@ s
 
 \begin_layout Standard
 \begin_inset Note Greyedout
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -4855,7 +4855,7 @@ Section headings ! Short titles
 \end_inset
 
 
-\begin_inset Argument status
+\begin_inset Argument 1
 status collapsed
 
 \begin_layout Plain Layout
@@ -4999,6 +4999,10 @@ Return
 Standard
 \family default
  environment yourself.
+\end_layout
+
+\begin_layout Subsubsection
+
 \family sans
 Quote
 \family default
@@ -5490,7 +5494,7 @@ These are the default labels for an
 Itemize
 \family default
  list.
- You can customize these labels in the 
+ You can customize how these labels are displayed in the output in the 
 \family sans
 Document\SpecialChar \menuseparator
 Settings
@@ -5500,8 +5504,6 @@ Settings
 Bullets
 \family default
 .
-\family sans
-
 \begin_inset Index idx
 status collapsed
 
@@ -5511,7 +5513,7 @@ Document ! Settings
 
 \end_inset
 
-
+ These customizations are not displayed in LyX.
 \end_layout
 
 \begin_layout Standard
@@ -5679,18 +5681,23 @@ Back to the outermost level.
 \end_layout
 
 \begin_layout Standard
-Once again, you can customize the type of numbering used in the 
+You can customize the type of numbering used in the 
 \family sans
 Enumerate
 \family default
- environment.
- It involves adding commands to the LaTeX preamble (see the 
-\emph on
-Additional Features
-\emph default
- manual).
- As stated earlier, such customization only shows up in the printed version,
- not in LyX.
+ environment, see section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:Customized-Lists"
+
+\end_inset
+
+.
+ Such customization only shows up in the printed version, not in LyX.
 \end_layout
 
 \begin_layout Standard
@@ -5771,21 +5778,21 @@ word
 \begin_inset Quotes erd
 \end_inset
 
- it is meant that the first hit of the 
+ it is meant that the first usage of the 
 \family sans
 Space
 \family default
  key ends the label if you are at the beginning of the first line of an
  item.
- If you need to use more than one word in the label use a 
+ If you need to use more than one word in a label use a 
 \family sans
-Protected Blank
+Protected Space
 \family default
 .
  (Use either 
 \begin_inset Info
 type  "shortcut"
-arg   "space-insert protected"
+arg   "command-alternatives space-insert protected ; math-space"
 \end_inset
 
  or the menu 
@@ -5798,7 +5805,7 @@ Protected
 
 Space
 \family default
-, see section
+; see section
 \begin_inset space ~
 \end_inset
 
@@ -5809,7 +5816,7 @@ reference "sub:Protected-Space"
 
 \end_inset
 
- for more info.) Here is an example:
+ for more information.) Here is an example:
 \end_layout
 
 \begin_layout Description
@@ -5823,7 +5830,7 @@ Protected
 \begin_inset space ~
 \end_inset
 
-Blank
+Space
 \family default
  in the label of a 
 \family sans
@@ -5931,7 +5938,7 @@ Space
 \family default
  after the beginning of the first line of an item marks the end of the label.
  If you need to use more than one word in an item label, use a protected
blank as described above.
space as described above.
 \end_layout
 
 \begin_layout Labeling
@@ -6015,7 +6022,7 @@ M
 \end_inset
 
  multiple times instead.
The M is the widest character and is a standard unit of widths in LaTeX.
+ M is the widest character and is a standard unit of widths in LaTeX.
  By using 
 \begin_inset Quotes eld
 \end_inset
@@ -6165,6 +6172,13 @@ HFill
 
 \begin_layout Subsection
 Customized Lists
+\begin_inset CommandInset label
+LatexCommand label
+name "sub:Customized-Lists"
+
+\end_inset
+
+
 \begin_inset Index idx
 status collapsed
 
@@ -6178,13 +6192,12 @@ Lists ! Customized
 \end_layout
 
 \begin_layout Standard
-To use the features described in this section, you must load the module
+The features described in this section require that the module 
 \family sans
 Customisable Lists (enumitem)
 \family default
- in the document settings.
- This loads the features of the LaTeX-package 
+ is loaded in the document settings.
+ The module uses the LaTeX-package 
 \series bold
 enumitem
 \series default
@@ -6267,27 +6280,27 @@ reference "sec:TeX-Code"
 \emph on
  enumi
 \emph default
- is hereby the counter of the enumeration in the first level.
+ is hereby the first level counter of the enumeration.
  The command 
 \series bold
 
 \backslash
 roman
 \series default
- outputs the counter as small Roman numeral.
- For capital Roman numerals replace in the command above 
+ outputs the counter as small Roman numeral.
+ For capital Roman numerals replace 
 \series bold
 
 \backslash
 roman
 \series default
- by 
+ with 
 \series bold
 
 \backslash
 Roman
 \series default
-.
+ in the command above.
  For Arabic numerals use 
 \series bold
 
@@ -6321,7 +6334,7 @@ alph
 \begin_layout Standard
 \noindent
 \begin_inset Note Greyedout
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6346,16 +6359,16 @@ To change the numbering for the list sublevels, replace the 'i' in the command
 \end_layout
 
 \begin_layout Standard
-As example a list with custom numbering:
+Here is a list with custom numbering:
 \end_layout
 
 \begin_layout Enumerate
 \begin_inset Argument 1
-status collapsed
+status open
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6381,11 +6394,11 @@ Level 1
 \begin_deeper
 \begin_layout Enumerate
 \begin_inset Argument 1
-status collapsed
+status open
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6413,11 +6426,11 @@ Level 2
 \begin_deeper
 \begin_layout Enumerate
 \begin_inset Argument 1
-status collapsed
+status open
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6441,11 +6454,11 @@ Level 3
 \begin_deeper
 \begin_layout Enumerate
 \begin_inset Argument 1
-status collapsed
+status open
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6528,14 +6541,14 @@ bf{}
 
 \begin_layout Standard
 \begin_inset Note Greyedout
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
 \series bold
 Note:
 \series default
- When you changed the label of a list level, it will be used for all following
+ When you change the label of a list level, it will be used for all following
  lists until you change the definition.
 \end_layout
 
@@ -6564,11 +6577,11 @@ Enumerations can be resumed after intermediate paragraphs:
 
 \begin_layout Enumerate
 \begin_inset Argument 1
-status collapsed
+status open
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6586,7 +6599,7 @@ arabic{enumi}.
 
 first
 \begin_inset Note Note
-status collapsed
+status open
 
 \begin_layout Plain Layout
 goes back to default numbering
@@ -6621,7 +6634,7 @@ Enumerate-Resume
 
 \begin_layout Standard
 \begin_inset Note Greyedout
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6637,7 +6650,7 @@ Note:
 \end_layout
 
 \begin_layout Standard
-Perhaps you might want to resume the list with a different number than the
+Perhaps you might want to resume the list with a different number from the
  next one.
  Or you want to start a new enumeration with a defined number.
  This is possible by adding an optional argument to the first list item
@@ -6678,7 +6691,7 @@ status open
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6739,7 +6752,7 @@ status open
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6781,7 +6794,7 @@ LaTeX-packages ! enumitem
 \end_inset
 
 .
- For more info see its documentation, 
+ For more information see its documentation, 
 \begin_inset CommandInset citation
 LatexCommand cite
 key "enumitem"
@@ -6808,7 +6821,7 @@ status open
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6897,7 +6910,7 @@ status collapsed
 
 \begin_layout Plain Layout
 \begin_inset ERT
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -6945,7 +6958,7 @@ LaTeX-packages ! enumitem
 \end_inset
 
 .
- For more info see its documentation, 
+ For more information see its documentation 
 \begin_inset CommandInset citation
 LatexCommand cite
 key "enumitem"
@@ -7137,7 +7150,7 @@ Right
 Address
 \family default
  add extra space between themselves and the next paragraph.
- If you hit 
+ If you enter 
 \family sans
 Return
 \family default
@@ -7168,22 +7181,19 @@ arg   "newline-insert newline"
 
  or 
 \family sans
-Formatting
+Insert\SpecialChar \menuseparator
+Formatting\SpecialChar \menuseparator
+Ragged
 \begin_inset space ~
 \end_inset
 
-Character\SpecialChar \menuseparator
 Line
 \begin_inset space ~
 \end_inset
 
 Break
 \family default
- from the 
-\family sans
-Insert
-\family default
- menu) to start a new line in an 
+) to start a new line in an 
 \family sans
 Address
 \family default
@@ -7236,7 +7246,11 @@ Abstract
 \family sans
 Abstract
 \family default
- in anything else or vice versa.
+ in anything else or 
+\emph on
+vice versa
+\emph default
+.
  It will not work.
  The 
 \family sans
@@ -7275,11 +7289,12 @@ Abstract
  Lastly, it adds a bit of extra vertical space between the abstract and
  the subsequent text.
  Well, that's how it will appear on the LyX screen.
- The appearance in the output depends on the used article or report class.
+ The actual appearance in the output depends on the document class you are
+ using.
 \end_layout
 
 \begin_layout Standard
-Starting a new paragraph by hitting 
+Starting a new paragraph by entering 
 \family sans
 Return
 \family default
@@ -7297,7 +7312,7 @@ Abstract
 \begin_inset Float figure
 wide false
 sideways false
-status collapsed
+status open
 
 \begin_layout Plain Layout
 \align center
@@ -7337,7 +7352,7 @@ Abstract
 \end_layout
 
 \begin_layout Standard
-We'd love to give you directly an example of the 
+We would love to demonstrate the 
 \family sans
 Abstract
 \family default
@@ -7362,7 +7377,7 @@ reference "fig:Paragraph-in-the"
 \end_inset
 
 .
- If you've never heard of an 
+ If you have never heard of an 
 \begin_inset Quotes eld
 \end_inset
 
@@ -7410,7 +7425,11 @@ Bibliography
 \family sans
 Bibliography
 \family default
- in anything else or vice versa will not work.
+ in anything else or 
+\emph on
+vice versa
+\emph default
+ will not work.
 \end_layout
 
 \begin_layout Standard
@@ -7441,7 +7460,7 @@ References,
 Bibliography
 \family default
  environment is a bibliography entry.
- Thus, hitting 
+ Thus, entering 
 \family sans
 Return
 \family default
@@ -7628,7 +7647,7 @@ Space
 Or: use 
 \begin_inset Info
 type  "shortcut"
-arg   "space-insert protected"
+arg   "command-alternatives space-insert protected ; math-space"
 \end_inset
 
  instead.
@@ -7815,6 +7834,7 @@ three
 You put a list inside a list by nesting one list inside the other.
  Nesting an environment is quite simple: Select 
 \family sans
+Edit\SpecialChar \menuseparator
 Increase
 \begin_inset space ~
 \end_inset
@@ -7837,12 +7857,8 @@ List
 
 Depth
 \family default
- from the 
-\family sans
-Edit
-\family default
- menu to change the nesting depth of the current paragraph (the status bar
- will tell you how far you are nested).
+ to change the nesting depth (the status bar will tell you how far you are
+ nested).
  Instead of the menu, you can also use the toolbar buttons 
 \begin_inset Info
 type  "icon"
@@ -7855,13 +7871,13 @@ type  "icon"
 arg   "depth-decrement"
 \end_inset
 
- or the convenient key bindings 
+ or the key bindings 
 \family sans
 Tab
 \family default
  and 
 \family sans
-Shift-Tab
+Shift+Tab
 \family default
  or 
 \begin_inset Info
@@ -7875,15 +7891,15 @@ type  "shortcut"
 arg   "depth-decrement"
 \end_inset
 
- to change the nesting level.
- The change will work on the current selection if you have made one (allowing
+.
+ The change will work on the current selection, if you have made one (allowing
  you to change the nesting of several paragraphs at once), or the current
  paragraph.
 \end_layout
 
 \begin_layout Standard
 Note that LyX only changes the nesting depth if it can.
- If it's invalid to do so, nothing happens if you try to change the depth.
+ If it is invalid to do so, nothing happens if you try to change the depth.
  Additionally, if you change the depth of one paragraph, it affects the
  depth of every paragraph nested inside of it.
 \end_layout
@@ -7905,8 +7921,8 @@ Before we fire a list of paragraph environments at you, we need to tell
 \end_layout
 
 \begin_layout Standard
-The question if nesting a paragraph environment is possible, is a bit more
complicated than a simple yes or no.
+The question of nesting a paragraph environment is a bit more complicated
+ than a simple yes or no.
  There are three types of paragraph environments:
 \end_layout
 
@@ -8128,14 +8144,15 @@ Address
 \end_deeper
 \begin_layout Standard
 \begin_inset Note Greyedout
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
 \series bold
 Note:
 \series default
- Although it is possible to nest numbered section headings like 
+ Although it is possible, for example, to nest numbered section headings
+ like 
 \family sans
 Chapter
 \family default
@@ -8147,17 +8164,9 @@ Section
 \begin_inset space ~
 \end_inset
 
-into e.
-\begin_inset space \thinspace{}
-\end_inset
-
-g.
-\begin_inset space \space{}
-\end_inset
-
-lists, it is highly recommended not to do this because the aim is to create
- well-structured documents following typesetting guidelines whereas nested
- section headings violate this.
+into lists, it is highly recommended not to do this because the aim is to
+ create well-structured documents following typesetting guidelines whereas
+ nested section headings violate this.
 \end_layout
 
 \end_inset
@@ -8200,7 +8209,7 @@ figures
 \begin_layout Standard
 (
 \begin_inset Note Greyedout
-status collapsed
+status open
 
 \begin_layout Plain Layout
 
@@ -8811,7 +8820,7 @@ arg   "depth-increment"
 \begin_layout Labeling
 \labelwidthstring MMM
 #3-a This is level #3.
- This time, we just hit 
+ This time, we just enter 
 \family sans
 Return
 \family default
@@ -8823,7 +8832,7 @@ arg   "depth-increment"
 
  twice in a row.
  We could have also created it the same way as we did the previous level,
- by hitting 
+ by entering 
 \begin_inset Info
 type  "shortcut"
 arg   "break-paragraph inverse"
@@ -8854,7 +8863,7 @@ Standard
 
 .
  So, it's at level #4.
- We did this by hitting 
+ We did this by entering 
 \begin_inset Info
 type  "shortcut"
 arg   "break-paragraph inverse"
@@ -8904,7 +8913,7 @@ arg   "break-paragraph inverse"
 \begin_layout Labeling
 \labelwidthstring MMM
 #4-a This is level #4.
- We hit 
+ We enter 
 \begin_inset Info
 type  "shortcut"
 arg   "break-paragraph inverse"
@@ -8954,7 +8963,7 @@ and this is level #6.
 \begin_layout Labeling
 \labelwidthstring MMM
 #5-b Back to level #5.
- Just hit 
+ Just enter 
 \begin_inset Info
 type  "shortcut"
 arg   "break-paragraph inverse"
@@ -9005,7 +9014,7 @@ arg   "depth-decrement"
 \begin_layout Labeling
 \labelwidthstring MMM
 #1-b And last, back to the outermost level, #1.
- After this sentence, we will hit 
+ After this sentence, we will enter 
 \family sans
 Return
 \family default
@@ -9051,7 +9060,7 @@ This is the LyX-Code environment, at level #1, the outermost
 
 \begin_layout LyX-Code
 level.
-  Now we will hit 
+  Now we will enter 
 \family sans
 Return
 \family default
@@ -9061,7 +9070,11 @@ type  "shortcut"
 arg   "depth-increment"
 \end_inset
 
-, after which, we will change to the 
+, after
+\begin_inset Newline newline
+\end_inset
+
+which, we will change to the 
 \family sans
 Enumerate
 \family default
@@ -9091,7 +9104,7 @@ LyX-Code
 
 \end_deeper
 \begin_layout Standard
-We ended this example by hitting 
+We ended this example by entering 
 \family sans
 Return
 \family default
@@ -9236,12 +9249,7 @@ thirdfold
 \family sans
 Enumerate
 \family default
- environment (i.
-\begin_inset space \thinspace{}
-\end_inset
-
-g.
- it is an 
+ environment (that is, it is an 
 \family sans
 Enumerate
 \family default
@@ -9358,7 +9366,7 @@ type  "shortcut"
 arg   "depth-decrement"
 \end_inset
 
-sequence and return to level #1, the outermost level.
+ sequence and return to level #1, the outermost level.
 \end_layout
 
 \begin_layout Standard