]> git.lyx.org Git - features.git/blobdiff - lib/doc/UserGuide.lyx
UserGuide.lyx: distribute recent changes
[features.git] / lib / doc / UserGuide.lyx
index 962bdf18568026acf557394948194f2757c2d663..b9288ac1647fd9df3f3c209371adf038f36f3960 100644 (file)
@@ -197,8 +197,7 @@ The latest PDF-version of this document can be found here:
 
 
 \series bold
-http://wiki.lyx.org/\SpecialChar LyX
-/DocumentationDevelopment#UserGuide
+https://wiki.lyx.org/LyX/Manuals#UserGuide
 \end_layout
 
 \end_inset
@@ -8336,14 +8335,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
 
@@ -8356,7 +8353,6 @@ The following 2 lines are empty:
 \end_layout
 
 \begin_layout Verbatim
-
 Almost everything is allowed in Verbatim:"%&$§#~'`
 \backslash
 }][{|
@@ -8380,7 +8376,6 @@ Verbatim
 \end_layout
 
 \begin_layout Verbatim*
-
 This is Verbatim*.
 \end_layout
 
@@ -10532,20 +10527,19 @@ enumeration
 To split an existing list into two lists, set the cursor at the end of a
  list item and use the menu 
 \family sans
-Edit\SpecialChar menuseparator
-Start New Environment
+Insert\SpecialChar menuseparator
+Separated <Name> Above
 \family default
-.
- This inserts a plain separator (red line in \SpecialChar LyX
-) and behind it the new list.
- The menu 
+ or
 \family sans
-Edit\SpecialChar menuseparator
-Start New Parent Environment
+ Insert\SpecialChar menuseparator
+Separated <Name> Below
 \family default
- only appears if the item is nested.
- It does not only separate the list but also creates a new one outside the
- nesting.
+.
+ This inserts a plain separator (red line in \SpecialChar LyX
+) and before or behind it the
+ new list.
+ Inside nested environments, it is also possible to split the outer environment.
 \end_layout
 
 \begin_layout Standard
@@ -13373,11 +13367,41 @@ status collapsed
 \end_inset
 
 .
- The option 
+\end_layout
+
+\begin_layout Standard
+The option 
 \family sans
-Output en- and em-dashes as ligatures
+Disallow line breaks after dashes
 \family default
- outputs en- and em-dashes as ligatures (--, ---) instead of a sigle character.
+ outputs en- and em-dashes as literal characters
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+Or \SpecialChar LaTeX
+ macro, if the literal character is not supported by the \SpecialChar LaTeX
+ input encoding.
+\end_layout
+
+\end_inset
+
+ instead of ligatures (--, ---) (see section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Dashes-and-line-breaks"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+).
 \end_layout
 
 \begin_layout Standard
@@ -16328,34 +16352,10 @@ Opt
 \family default
  is the Mac label for the right 
 \family sans
-Alt
-\family default
-\family sans
-/ AltGr 
+Alt 
 \family default
 key).
- Alternatively, dashes can be inserted with 
-\family sans
-Insert\SpecialChar menuseparator
-Special
-\begin_inset space ~
-\end_inset
-
-Character\SpecialChar menuseparator
-Symbols
-\family default
- or with the 
-\begin_inset Quotes eld
-\end_inset
-
-unicode-insert
-\begin_inset Quotes erd
-\end_inset
-
- \SpecialChar LyX
- function with the Unicode code point as argument (2013 for the em dash
- and 2014 for the en dash).
 \end_layout
 
 \end_inset
@@ -16481,16 +16481,13 @@ Special
 Character\SpecialChar menuseparator
 Symbols
 \family default
- or the 
-\begin_inset Quotes eld
-\end_inset
-
+ or using the 
+\family typewriter
 unicode-insert
-\begin_inset Quotes erd
-\end_inset
-
+\family default
  \SpecialChar LyX
- function.
+ function with the Unicode code point as argument (2013 for the em dash
+ and 2014 for the en dash).
 \end_layout
 
 \begin_layout Standard
@@ -16512,7 +16509,7 @@ hyphen
 \end_layout
 
 \begin_layout Enumerate
-From A–Z; pages
+A–Z; pages
 \begin_inset space ~
 \end_inset
 
@@ -16568,7 +16565,7 @@ literal "false"
 \end_layout
 
 \begin_layout Subsection
-Dashes and line breaks
+Dashes and Line Breaks
 \begin_inset CommandInset label
 LatexCommand label
 name "subsec:Dashes-and-line-breaks"
@@ -16579,12 +16576,17 @@ name "subsec:Dashes-and-line-breaks"
 \end_layout
 
 \begin_layout Standard
-Whether line breaks around dashes are allowed depends on the use case and
- locale:
+Whether line breaks before or after dashes are allowed depends on the use
+ case and locale, e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g.:
 \end_layout
 
 \begin_layout Itemize
-No line breaks are allowed in ranges of values like A–Z or 1975–1982.
+In English, line breaks are generally allowed after the dash, but no line
+ break should occur if only a single character follows the dash (as in A–Z).
 \end_layout
 
 \begin_layout Itemize
@@ -16598,74 +16600,39 @@ In French and Spanish, dashes around parenthetical statements are treated
 \end_layout
 
 \begin_layout Standard
-When using spaced en dashes
-\begin_inset space ~
+By default, dashes are output by \SpecialChar LyX
+ to \SpecialChar LaTeX
+ as 
+\begin_inset Quotes eld
 \end_inset
 
-- common in British English
-\begin_inset space ~
+ligature dashes
+\begin_inset Quotes erd
 \end_inset
 
-- line breaks before the dash can be prevented with protected spaces.
-\end_layout
-
-\begin_layout Standard
-When using em dashes without spaces—\SpecialChar allowbreak
-common in American English—\SpecialChar allowbreak
-one can insert
- optional line breaks with the menu 
-\family sans
-Insert\SpecialChar menuseparator
-Formatting\SpecialChar menuseparator
-Optional line break
-\family default
-.
+ (-- and ---).
+ \SpecialChar LaTeX
+ allows line breaks after hyphens, en-dashes and em-dashes.
 \end_layout
 
-\begin_layout Standard
-For documents containing many em dashes, you may consider to select the
- option 
-\family sans
-Document\SpecialChar menuseparator
-Settings\SpecialChar menuseparator
-Fonts\SpecialChar menuseparator
-Output en- and em-dashes as ligatures.
-\family default
-This forces the output of dashes as 
-\begin_inset Quotes eld
-\end_inset
-
---
-\begin_inset Quotes erd
+\begin_layout Enumerate
+Line breaks before spaced en dashes
+\begin_inset space ~
 \end_inset
 
- and 
-\begin_inset Quotes eld
-\end_inset
+– common in British English and generally recommended by 
+\emph on
+The Elements of Typographic Style
+\emph default
 
----
-\begin_inset Quotes erd
+\begin_inset space ~
 \end_inset
 
- when exporting to \SpecialChar LaTeX
-.
- The \SpecialChar TeX
- font ligature mechanism converts them to dash characters followed
- by an optional line break.
-\end_layout
-
-\begin_layout Standard
-Caution:
+– can be prevented using protected spaces.
 \end_layout
 
 \begin_layout Enumerate
-This results in optional line breaks after 
-\series bold
-all
-\series default
- en and em dashes.
- Incorrect line breaks must be prevented by wrapping in a makebox
+Unwanted line breaks after dashes can be prevented by wrapping in a makebox
 \begin_inset Foot
 status collapsed
 
@@ -16724,7 +16691,7 @@ backgroundcolor "none"
 status open
 
 \begin_layout Plain Layout
-369–378
+36–39
 \end_layout
 
 \end_inset
@@ -16792,6 +16759,7 @@ nobreakdash
 —un inciso con rayas— se escribe así.
 \end_layout
 
+\end_deeper
 \begin_layout Standard
 An incorrect line break is easily overlooked because
 \begin_inset space ~
@@ -16805,155 +16773,235 @@ An incorrect line break is easily overlooked because
  log.
 \end_layout
 
-\end_deeper
-\begin_layout Enumerate
-The setting is ignored for documents using non-\SpecialChar TeX
- fonts.
-\begin_inset Foot
-status collapsed
-
-\begin_layout Plain Layout
-Xe\SpecialChar TeX
- provides the 
-\series bold
-
-\backslash
-XeTeXdashbreakstate
-\series default
- setting.
- The default causes dashes to behave like ligature dashes.
- The usual behaviour of literal dashes can be achieved by inserting 
-\family typewriter
-\series bold
-
-\backslash
-XeTeXdashbreakstate=0
+\begin_layout Standard
+If you want to globally disable line breaks after dashes, you can select
+ the option 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Fonts\SpecialChar menuseparator
+Disallow line breaks after dashes
 \family default
-\series default
- into the \SpecialChar LaTeX
- preamble.
+:
 \end_layout
 
+\begin_layout Enumerate
+Line breaks are still allowed after spaced dashes.
+ They can be prevented using protected spaces (without need for a makebox
+ or \SpecialChar TeX
+ code).
+ Example:
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+
+\lang french
+Les incises –
+\begin_inset space ~
 \end_inset
 
+même si tout le monde ne les aime pas
+\begin_inset space ~
+\end_inset
 
+– sont très utiles.
 \end_layout
 
+\end_deeper
 \begin_layout Enumerate
-Em dashes in 
-\family typewriter
-typewriter
-\family default
- fonts become 
-\family typewriter
-–-
-\family default
- or 
-\family typewriter
----
+Line breaks after unspaced dashes can be allowed via the menu
+\begin_inset Newline newline
+\end_inset
+
+
+\family sans
+Insert\SpecialChar menuseparator
+Formatting\SpecialChar menuseparator
+Optional line break
 \family default
- in the output.
+:
 \end_layout
 
-\begin_layout Enumerate
-Hyphenation is suppressed in words adjacent to hyphens and ligature dashes.
+\begin_deeper
+\begin_layout Itemize
+Em-dashes without spaces—\SpecialChar allowbreak
+common in American English—\SpecialChar allowbreak
+should be followed by
+ a line break opportunity.
 \end_layout
 
 \begin_layout Standard
-Since \SpecialChar LyX
-
+This also allows hyphenation of the word following the dash (see section
 \begin_inset space ~
 \end_inset
 
-2.2, -- and --- are exported to LaTeX as -{}- and -{}-{}- to prevent ligation
- to dashes.
-\begin_inset Foot
-status collapsed
 
-\begin_layout Plain Layout
-Up to \SpecialChar LyX
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Hyphenation"
+plural "false"
+caps "false"
+noprefix "false"
 
-\begin_inset space ~
 \end_inset
 
-2.1, -- and --- was output unchanged which led to different look in \SpecialChar LyX
-, text
- export, HTML export and the PDF export.
+).
 \end_layout
 
+\end_deeper
+\begin_layout Enumerate
+With this setting, \SpecialChar LaTeX
+ hyphenates words also if immediately followed by em
+ or en dashes (see section
+\begin_inset space ~
 \end_inset
 
- Occurrences in older documents are converted to literal Unicode dashes.
- This led to different line breaks in some documents.
- \SpecialChar LyX
 
-\begin_inset space ~
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Hyphenation"
+plural "false"
+caps "false"
+noprefix "false"
+
 \end_inset
 
-2.3 provides the option 
-\family sans
-Output en- and em-dashes as ligatures
-\family default
- in the menu 
-\family sans
-Document\SpecialChar menuseparator
-Settings\SpecialChar menuseparator
-Fonts.
+).
+\end_layout
 
-\family default
- It is on by default but unselected when opening documents edited with \SpecialChar LyX
+\begin_layout Subsubsection
+Changes and backwards compatibility
+\end_layout
+
+\begin_layout Standard
+Up to \SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-2.2.
-\begin_inset Newline newline
+2.1, consecutive hyphen characters (-- and ---) in the LyX source were merged
+ to en or em dashes by LaTeX.
+ These 
+\begin_inset Quotes eld
+\end_inset
+
+ligature dashes
+\begin_inset Quotes erd
 \end_inset
 
-Note the following side-effects of the changes in \SpecialChar LyX
-'s dash handling:
+ retain the line-break properties of hyphens while literal dash characters
+ are regarded by \SpecialChar LaTeX
+ as 
+\emph on
+non-breakable
+\emph default
+.
 \end_layout
 
-\begin_layout Itemize
-If you used literal em- and en dashes in pre-\SpecialChar LyX
+\begin_layout Standard
+Since \SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-2.2 documents, you must manually unselect 
-\family sans
-Output en- and em-dashes as ligatures
+2.2, consecutive hyphens in the LyX source are exported to \SpecialChar LaTeX
+ in a way that
+ prevents ligation to dashes.
+\begin_inset Quotes eld
+\end_inset
+
+Ligature dashes
+\begin_inset Quotes erd
+\end_inset
+
+ in documents from earlier versions are converted to literal dash characters
+ (except in 
+\family typewriter
+typewriter
+\family default
+ font); typed in consecutive hyphens are merged to dash characters immediately
+ after the input (unless the current text font is 
+\family typewriter
+type
 \family default
- to ensure unchanged behavior.
+writer).
+\begin_inset Foot
+status open
+
+\begin_layout Plain Layout
+The behavior was changed since 
+\begin_inset Quotes eld
+\end_inset
+
+lyx --help
+\begin_inset Quotes erd
+\end_inset
+
+ became 
+\begin_inset Quotes eld
+\end_inset
+
+lyx –help
+\begin_inset Quotes erd
+\end_inset
+
+ in PDF, Postscript, and DVI output.
+ An unintended consequence of these changes was that all dashes were output
+ as non-breakable dashes.
+ This also resulted in changed line breaks in some older documents.
  
 \end_layout
 
-\begin_layout Itemize
-If you used both, literal and ligature dashes in pre-\SpecialChar LyX
-
-\begin_inset space ~
 \end_inset
 
-2.2 documents, you may need to enable or prevent individual line breaks as
- shown above to restore the correct line breaking behaviour.
+
 \end_layout
 
-\begin_layout Itemize
-Zero-width space (ZWSP) characters in older \SpecialChar LyX
- documents that follow literal
- em- and en-dashes are removed during the conversion to the format of \SpecialChar LyX
+\begin_layout Standard
+\SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+2.3 outputs 
+\emph on
+breakable
+\emph default
+ dashes by default.
+ When opening documents edited with \SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-2.3.
- If you used them as optional line breaks after dashes, convert them to
- space insets before opening your document with \SpecialChar LyX
+2.2 or earlier and containing literal dash characters not followed by whitespace,
+ the setting 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Fonts\SpecialChar menuseparator
+Disallow line breaks after dashes
+\family default
+ is active to prevent changes to the line breaks.
+\series bold
+Warning:
+\series default
+ If you used both literal and 
+\begin_inset Quotes eld
+\end_inset
+
+ligature
+\begin_inset Quotes erd
+\end_inset
+
+ dashes in pre-\SpecialChar LyX
 
 \begin_inset space ~
 \end_inset
 
-2.3 or the optional line breaks will be lost.
+2.2 documents, you may need to enable or prevent individual line breaks as
+ shown above to restore the correct line breaking behavior.
 \end_layout
 
 \begin_layout Subsection
@@ -16997,6 +17045,12 @@ status collapsed
 \end_inset
 
  following the rules of the document language.
+ \SpecialChar LaTeX
+ does not hyphenate text in the 
+\family sans
+typewriter
+\family default
+ font and words immediately preceded or followed by hyphens or dashes.
 \end_layout
 
 \begin_layout Standard
@@ -17054,10 +17108,10 @@ A-b c
 \begin_inset Quotes erd
 \end_inset
 
- as a hyphenation possibility.
Hyphenating at this point would look ugly.
- To prevent the shortcut from being hyphenated, you can use a protected
hyphen (
+ as a line break possibility.
A line break at this point would look ugly.
+ To prevent the shortcut from being broken, you can use a protected hyphen
+ (
 \family sans
 Insert\SpecialChar menuseparator
 Formatting\SpecialChar menuseparator
@@ -28102,7 +28156,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.lyx.org
+https://www.lyx.org
 \end_layout
 
 \end_inset
@@ -28177,7 +28231,7 @@ Name
 \begin_inset CommandInset href
 LatexCommand href
 name "LyX's homepage"
-target "http://www.lyx.org"
+target "https://www.lyx.org"
 literal "false"
 
 \end_inset
@@ -28234,7 +28288,7 @@ Hyperlinks will automatically be hyphenated if necessary in the PDF output,
 \begin_inset CommandInset href
 LatexCommand href
 name "LyX's homepage"
-target "http://www.lyx.org"
+target "https://www.lyx.org"
 literal "false"
 
 \end_inset
@@ -28791,7 +28845,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/BibTeX/Programs
+https://wiki.lyx.org/BibTeX/Programs
 \end_layout
 
 \end_inset
@@ -28979,7 +29033,7 @@ For information on how this is done, have a look at
 
 \begin_inset CommandInset href
 LatexCommand href
-target "http://mirrors.ctan.org/biblio/bibtex/contrib/doc/btxhak.pdf"
+target "https://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/btxhak.pdf"
 literal "false"
 
 \end_inset
@@ -31273,36 +31327,18 @@ If the characters |
 \begin_inset space \space{}
 \end_inset
 
-should appear in nomenclature entries they need to be escaped by adding
- a quote character in front of them.
+should appear in nomenclature entries containing \SpecialChar TeX
+ code they need to be escaped
+ by adding a quote character in front of them.
 \begin_inset CommandInset nomenclature
 LatexCommand nomenclature
 symbol "\"@, \"|, \"!, \"\""
-description "The quote sign is output by writing ' \"\" '"
+description "The quote sign in TeX code is output by writing ' \"\" '."
 literal "true"
 
 \end_inset
 
 
-\begin_inset Note Note
-status open
-
-\begin_layout Plain Layout
-Update description when bug 
-\begin_inset CommandInset href
-LatexCommand href
-name "10825"
-target "http://www.lyx.org/trac/ticket/10825"
-literal "false"
-
-\end_inset
-
- is fixed.
-\end_layout
-
-\end_inset
-
-
 \end_layout
 
 \begin_layout Subsection
@@ -31457,6 +31493,13 @@ Nomenclature ! Options
 \end_inset
 
 
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Nomenclature-Options"
+
+\end_inset
+
+
 \end_layout
 
 \begin_layout Standard
@@ -31615,9 +31658,9 @@ page
 \begin_inset Quotes erd
 \end_inset
 
- are automatically translated for some document languages.
- If not, add these lines to your \SpecialChar LaTeX
preamble:
+ are automatically translated for most document languages.
+ If not, add these lines in front of the nomenclature list as \SpecialChar TeX
code:
 \end_layout
 
 \begin_layout Standard
@@ -31626,9 +31669,32 @@ page
 \series bold
 
 \backslash
-renewcommand{
+renewcommand*{
+\backslash
+eqdeclaration}[1]{
+\begin_inset Newline newline
+\end_inset
+
+
+\size small
+
+\begin_inset Phantom HPhantom
+status open
+
+\begin_layout Plain Layout
+\begin_inset space ~
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\size default
+
 \backslash
-eqdeclaration}[1]{, see equation
+unskip, see equation
 \backslash
 nobreakspace(#1)}
 \begin_inset Newline newline
@@ -31636,33 +31702,118 @@ nobreakspace(#1)}
 
 
 \backslash
-renewcommand{
+renewcommand*{
 \backslash
-pagedeclaration}[1]{, page
+pagedeclaration}[1]{
+\begin_inset Newline newline
+\end_inset
+
+
+\size small
+
+\begin_inset Phantom HPhantom
+status open
+
+\begin_layout Plain Layout
+\begin_inset space ~
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\size default
+
+\backslash
+unskip, page
 \backslash
 nobreakspace{}#1}
-\series default
+\end_layout
+
+\begin_layout Standard
+If the numbers should be hyperlinks, assure that you use 
+\family sans
+Hyperref
+\begin_inset space ~
+\end_inset
+
+Support
+\family default
+ in the document settings under 
+\family sans
+PDF
+\begin_inset space ~
+\end_inset
 
+Properties
+\family default
+ and use instead:
+\end_layout
+
+\begin_layout Standard
+
+\series bold
+
+\backslash
+renewcommand*{
+\backslash
+eqdeclaration}[1]{
 \begin_inset Newline newline
 \end_inset
 
-and replace 
-\begin_inset Quotes eld
+
+\begin_inset Phantom HPhantom
+status open
+
+\begin_layout Plain Layout
+\begin_inset space ~
 \end_inset
 
-see equation
-\begin_inset Quotes erd
+
+\end_layout
+
 \end_inset
 
- and 
-\begin_inset Quotes eld
+
+\backslash
+unskip, see 
+\backslash
+hyperlink{equation.#1}{equation
+\backslash
+nobreakspace{}(#1)}}
+\begin_inset Newline newline
 \end_inset
 
-page
-\begin_inset Quotes erd
+
+\backslash
+renewcommand*{
+\backslash
+pagedeclaration}[1]{
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Phantom HPhantom
+status open
+
+\begin_layout Plain Layout
+\begin_inset space ~
 \end_inset
 
- by their translation.
+
+\end_layout
+
+\end_inset
+
+
+\backslash
+unskip, 
+\backslash
+hyperlink{page.#1}{page
+\backslash
+nobreakspace{}#1}}
 \end_layout
 
 \begin_layout Subsection
@@ -34978,7 +35129,7 @@ A good explanation of regular expressions is given in this Wikipedia entry:
  
 \begin_inset CommandInset href
 LatexCommand href
-target "http://en.wikipedia.org/wiki/Regular_expression"
+target "https://en.wikipedia.org/wiki/Regular_expression"
 literal "false"
 
 \end_inset
@@ -35241,7 +35392,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://sourceforge.net/projects/lyxwininstaller/files/hunspell/
+https://sourceforge.net/projects/lyxwininstaller/files/hunspell/
 \end_layout
 
 \end_inset
@@ -35322,10 +35473,6 @@ engine Select the library \SpecialChar LyX
  should use for spell checking.
  Depending on your platform, 
 \family typewriter
-aspell
-\family default
-, 
-\family typewriter
 hunspell
 \family default
  or 
@@ -35472,7 +35619,7 @@ status collapsed
 \begin_layout Plain Layout
 \begin_inset CommandInset href
 LatexCommand href
-target "http://lingucomponent.openoffice.org/thesaurus.html"
+target "https://lingucomponent.openoffice.org/thesaurus.html"
 literal "false"
 
 \end_inset
@@ -35625,15 +35772,16 @@ user
 If you want to install new\SpecialChar breakableslash
 further thesaurus dictionaries, you can downloaded
  them from here:
-\end_layout
+\begin_inset Newline newline
+\end_inset
+
 
-\begin_layout Itemize
 \begin_inset Flex URL
-status open
+status collapsed
 
 \begin_layout Plain Layout
 
-http://www.lyx.org/trac/browser/lyxsvn/dictionaries/trunk/thes/
+https://sourceforge.net/projects/lyxwininstaller/files/thesaurus/
 \end_layout
 
 \end_inset
@@ -37901,29 +38049,6 @@ reference "subsec:Numbering-depth"
 .
 \end_layout
 
-\begin_layout Subsection
-
-\family sans
-Start New Environment/Start New Parent Environment
-\end_layout
-
-\begin_layout Standard
-These menus are only visible if it is possible to have two consecutive environme
-nts of the same type.
- See section
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Separate-Nestings"
-
-\end_inset
-
- for an explanation.
-\end_layout
-
 \begin_layout Section
 The View Menu
 \begin_inset Index idx
@@ -38054,7 +38179,8 @@ Toolbar
 \end_layout
 
 \begin_layout Standard
-In this menu entry you can set the appearance of the different toolbars.
+In this menu entry you can set the icon size and the appearance of the different
+ toolbars.
  All toolbars and the 
 \family sans
 Command
@@ -39468,6 +39594,29 @@ reference "sec:Marginal-Notes"
 .
 \end_layout
 
+\begin_layout Subsection
+
+\family sans
+Separate <Name> (Above/Below)
+\end_layout
+
+\begin_layout Standard
+These menu items are only visible if it is possible to have two consecutive
+ environments of the same type.
+ See section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Separate-Nestings"
+
+\end_inset
+
+ for an explanation.
+\end_layout
+
 \begin_layout Subsection
 Short Title
 \end_layout
@@ -42870,7 +43019,7 @@ Driver support
  in 
 \begin_inset CommandInset href
 LatexCommand href
-target "http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/required/graphics/grfguide.pdf"
 literal "false"
 
 \end_inset
@@ -45581,7 +45730,7 @@ Set
 \begin_inset CommandInset href
 LatexCommand href
 name "this image"
-target "http://wiki.lyx.org/uploads/LyX/NewInLyX20/themes.png"
+target "https://wiki.lyx.org/uploads/LyX/NewInLyX20/themes.png"
 literal "false"
 
 \end_inset
@@ -47165,7 +47314,7 @@ language Here you can select the language for \SpecialChar LyX
  You can find its actual translation status here: 
 \begin_inset CommandInset href
 LatexCommand href
-target "http://www.lyx.org/I18n"
+target "https://www.lyx.org/I18n"
 literal "false"
 
 \end_inset
@@ -48952,137 +49101,6 @@ textwidth
 \end_inset
 
 
-\end_layout
-
-\begin_layout Chapter
-Credits
-\begin_inset CommandInset label
-LatexCommand label
-name "chap:Credits"
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Standard
-The documentation is a collaborative effort between many different people
- (and we would encourage people to contribute!).
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Alejandro Aguilar Sierra
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Amir Karger
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-David Johnson
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Hartmut Haase
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Ignacio García
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Ivan Schreter
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-John Raithel
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-John Weiss
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Lars Gullik Bjønnes
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Matthias Ettrich
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Matthias Zenker
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Rich Fields
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Pascal André
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Paul Evans
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Paul Russel
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Robin Socha
-\end_layout
-
-\begin_layout Itemize
-
-\noun on
-Uwe Stöhr
-\end_layout
-
-\begin_layout Itemize
-The \SpecialChar LyX
- Team: 
-\begin_inset CommandInset citation
-LatexCommand cite
-key "lyxcredit"
-literal "true"
-
-\end_inset
-
-
 \end_layout
 
 \begin_layout Standard
@@ -49110,7 +49128,7 @@ The \SpecialChar LyX
 \begin_inset CommandInset href
 LatexCommand href
 name "Credits"
-target "http://www.lyx.org/Credits"
+target "https://www.lyx.org/Credits"
 literal "false"
 
 \end_inset
@@ -49125,7 +49143,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.lyx.org/Credits
+https://www.lyx.org/Credits
 \end_layout
 
 \end_inset
@@ -49223,7 +49241,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/help/Catalogue/bytopic.html
+http://texcatalogue.ctan.org/bytopic.html
 \end_layout
 
 \end_inset
@@ -49270,7 +49288,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/biblio/bibtex/contrib/doc/btxdoc.pdf"
+target "https://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/btxdoc.pdf"
 literal "false"
 
 \end_inset
@@ -49290,7 +49308,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/biblio/bibtex/contrib/doc/btxdoc.pdf
+https://www.ctan.org/tex-archive/biblio/bibtex/contrib/doc/btxdoc.pdf
 \end_layout
 
 \end_inset
@@ -49310,7 +49328,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf"
+target "https://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf"
 literal "false"
 
 \end_inset
@@ -49330,7 +49348,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf
+https://www.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf
 \end_layout
 
 \end_inset
@@ -49350,7 +49368,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/doc/biblatex.pdf"
 literal "false"
 
 \end_inset
@@ -49381,7 +49399,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/doc/biblatex.pdf
 \end_layout
 
 \end_inset
@@ -49401,7 +49419,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/biblio/biber/documentation/biber.pdf"
+target "https://www.ctan.org/tex-archive/biblio/biber/documentation/biber.pdf"
 literal "false"
 
 \end_inset
@@ -49432,7 +49450,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/biblio/biber/documentation/biber.pdf
+https://www.ctan.org/tex-archive/biblio/biber/documentation/biber.pdf
 \end_layout
 
 \end_inset
@@ -49452,7 +49470,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/indexing/makeindex/doc/makeindex.pdf"
+target "https://www.ctan.org/tex-archive/indexing/makeindex/doc/makeindex.pdf"
 literal "false"
 
 \end_inset
@@ -49471,7 +49489,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/indexing/makeindex/doc/makeindex.pdf
+https://www.ctan.org/tex-archive/indexing/makeindex/doc/makeindex.pdf
 \end_layout
 
 \end_inset
@@ -49491,7 +49509,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Options"
-target "http://mirrors.ctan.org/indexing/makeindex/doc/manpages.dvi"
+target "https://www.ctan.org/tex-archive/indexing/makeindex/doc/manpages.dvi"
 literal "false"
 
 \end_inset
@@ -49510,7 +49528,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/indexing/makeindex/doc/manpages.dvi
+https://www.ctan.org/tex-archive/indexing/makeindex/doc/manpages.dvi
 \end_layout
 
 \end_inset
@@ -49569,7 +49587,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ams.org/publications/authors/tex/amslatex"
+target "https://www.ams.org/publications/authors/tex/amslatex"
 literal "false"
 
 \end_inset
@@ -49585,7 +49603,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ams.org/publications/authors/tex/amslatex
+https://www.ams.org/publications/authors/tex/amslatex
 \end_layout
 
 \end_inset
@@ -49605,7 +49623,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/caption/caption-eng.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/caption/caption-eng.pdf"
 literal "false"
 
 \end_inset
@@ -49636,7 +49654,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/caption/caption-eng.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/caption/caption-eng.pdf
 \end_layout
 
 \end_inset
@@ -49656,7 +49674,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/enumitem/enumitem.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/enumitem/enumitem.pdf"
 literal "false"
 
 \end_inset
@@ -49687,7 +49705,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/enumitem/enumitem.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/enumitem/enumitem.pdf
 \end_layout
 
 \end_inset
@@ -49707,7 +49725,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/fancyhdr/fancyhdr.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/fancyhdr/fancyhdr.pdf"
 literal "false"
 
 \end_inset
@@ -49738,7 +49756,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/fancyhdr/fancyhdr.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/fancyhdr/fancyhdr.pdf
 \end_layout
 
 \end_inset
@@ -49758,7 +49776,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/pkg/hyperref"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/doc/manual.pdf"
 literal "false"
 
 \end_inset
@@ -49789,7 +49807,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ctan.org/pkg/hyperref
+https://www.ctan.org/tex-archive/macros/latex/contrib/hyperref/doc/manual.pdf
 \end_layout
 
 \end_inset
@@ -49809,7 +49827,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/microtype/microtype.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/microtype/microtype.pdf"
 literal "false"
 
 \end_inset
@@ -49840,7 +49858,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/microtype/microtype.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/microtype/microtype.pdf
 \end_layout
 
 \end_inset
@@ -49860,7 +49878,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://mirrors.ctan.org/macros/latex/contrib/nomencl/nomencl.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/nomencl/nomencl.pdf"
 literal "false"
 
 \end_inset
@@ -49891,7 +49909,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://mirrors.ctan.org/macros/latex/contrib/nomencl/nomencl.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/nomencl/nomencl.pdf
 \end_layout
 
 \end_inset
@@ -49911,7 +49929,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf"
 literal "false"
 
 \end_inset
@@ -49942,7 +49960,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/prettyref/prettyref.pdf
 \end_layout
 
 \end_inset
@@ -49962,7 +49980,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Documentation"
-target "http://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf"
+target "https://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf"
 literal "false"
 
 \end_inset
@@ -49993,7 +50011,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf
+https://www.ctan.org/tex-archive/macros/latex/contrib/refstyle/refstyle.pdf
 \end_layout
 
 \end_inset
@@ -50013,7 +50031,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Arabic"
+target "https://wiki.lyx.org/Windows/Arabic"
 literal "false"
 
 \end_inset
@@ -50029,7 +50047,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Arabic
+https://wiki.lyx.org/Windows/Arabic
 \end_layout
 
 \end_inset
@@ -50049,7 +50067,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Armenian"
+target "https://wiki.lyx.org/Windows/Armenian"
 literal "false"
 
 \end_inset
@@ -50065,7 +50083,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Armenian
+https://wiki.lyx.org/Windows/Armenian
 \end_layout
 
 \end_inset
@@ -50085,7 +50103,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Cyrillic"
+target "https://wiki.lyx.org/Windows/Cyrillic"
 literal "false"
 
 \end_inset
@@ -50101,7 +50119,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Cyrillic
+https://wiki.lyx.org/Windows/Cyrillic
 \end_layout
 
 \end_inset
@@ -50121,7 +50139,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Farsi"
+target "https://wiki.lyx.org/Windows/Farsi"
 literal "false"
 
 \end_inset
@@ -50137,7 +50155,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Farsi
+https://wiki.lyx.org/Windows/Farsi
 \end_layout
 
 \end_inset
@@ -50157,7 +50175,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Hebrew"
+target "https://wiki.lyx.org/Windows/Hebrew"
 literal "false"
 
 \end_inset
@@ -50173,7 +50191,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Hebrew
+https://wiki.lyx.org/Windows/Hebrew
 \end_layout
 
 \end_inset
@@ -50193,7 +50211,7 @@ literal "true"
 \begin_inset CommandInset href
 LatexCommand href
 name "Wiki-page"
-target "http://wiki.lyx.org/Windows/Japanese"
+target "https://wiki.lyx.org/Windows/Japanese"
 literal "false"
 
 \end_inset
@@ -50209,7 +50227,7 @@ status collapsed
 
 \begin_layout Plain Layout
 
-http://wiki.lyx.org/Windows/Japanese
+https://wiki.lyx.org/Windows/Japanese
 \end_layout
 
 \end_inset
@@ -50296,31 +50314,20 @@ status collapsed
 
 
 \backslash
-def
-\backslash
-eqdeclaration#1{, see equation
+renewcommand*{
 \backslash
-nobreakspace(#1)}
+pagedeclaration}[1]{
 \end_layout
 
 \begin_layout Plain Layout
 
-
 \backslash
-def
+unskip, 
 \backslash
-pagedeclaration#1{, page
+hyperlink{page.#1}{page
 \backslash
-nobreakspace#1}
-\end_layout
-
-\begin_layout Plain Layout
-
-
-\backslash
-renewcommand{
-\backslash
-nomname}{Nomenclature}
+nobreakspace{}#1}}
 \end_layout
 
 \end_inset
@@ -50330,28 +50337,26 @@ nomname}{Nomenclature}
 status collapsed
 
 \begin_layout Plain Layout
-The name of the nomenclature has to be redefined to English because a bug
- in the 
-\series bold
-nomencl
-\series default
- package takes the last used language for the title that is not the document
- language.
- See 
-\begin_inset CommandInset href
-LatexCommand href
-name "this"
-target "https://tex.stackexchange.com/questions/65913/why-nomenclature-text-is-not-english-when-loading-additional-languages-in-docume"
-literal "false"
+This command makes the page number a clickable hyperlink, see sec.
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Nomenclature-Options"
 
 \end_inset
 
- for a detailed explanation of the bug.
+ for more info.
 \end_layout
 
 \end_inset
 
 
+\end_layout
+
+\begin_layout Standard
 \begin_inset CommandInset nomencl_print
 LatexCommand printnomenclature
 set_width "auto"