summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/source-doc/english
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-10-14 03:00:58 +0000
committerNorbert Preining <norbert@preining.info>2019-10-14 03:00:58 +0000
commit370853b6ba0be6e880b2f320268d4fefbd6aeef6 (patch)
tree6d5fc61b99808ac12a520651d0b2f9c59d2b0a94 /macros/latex/contrib/koma-script/source-doc/english
parent3afcae17b4a1a6dffbaa749a6fd0b6406c4d34a9 (diff)
CTAN sync 201910140300
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc/english')
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-lists.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex4
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-options.tex22
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex7
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-titles.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/guide-english.tex27
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/htmlsetup22
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/introduction.tex4
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/japanlco.tex9
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/preface.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scraddr.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrbase.tex352
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex295
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex65
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrextend.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrhack.tex52
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrjura.tex51
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex31
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex30
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex50
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex45
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex338
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex8
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/typearea.tex4
41 files changed, 1182 insertions, 410 deletions
diff --git a/macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex b/macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex
index 75b9b8f392..deb207aa32 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/adrconvnote.tex
@@ -1,6 +1,6 @@
% ======================================================================
% adrconvnote.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% adrconvnote.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,13 +46,13 @@
% ======================================================================
\KOMAProvidesFile{adrconvnote.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: adrconv)]
\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and
Karl Hagen}
-% Date of the translated German file: 2018-01-29
+% Date of the translated German file: 2019-10-10
\chapter{Creating Address Files from an Address Database}%
\labelbase{addrconv}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex b/macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex
index bed043d8d3..e1f7d4471c 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-compatibility.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-compatibility.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-compatibility.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{common-compatibility.tex}
- [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs)]
\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2018-01-30
+% Date of the translated German file: 2019-10-10
\section{Compatibility with Earlier Versions of \KOMAScript}
\seclabel{compatibilityOptions}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex b/macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex
index 5dff550ac7..682ca39163 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-dictum.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-dictum.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-dictum.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-dictum.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
Karl Hagen}
-% Date of the translated German file: 2018-01-29
+% Date of the translated German file: 2019-10-10
\section{Dicta}
\seclabel{dictum}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex b/macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex
index 383c9236c5..e693714e39 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-draftmode.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-draftmode.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-draftmode.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-draftmode.tex}
- [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs)]
\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and
Karl Hagen}
-% Date of the translated German file: 2018-01-30
+% Date of the translated German file: 2019-10-10
\section{Draft Mode}
\seclabel{draft}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex b/macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex
index 843f9482f2..ed37da5934 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-fontsize.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-fontsize.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-fontsize.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{common-fontsize.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs: fontsize)]
\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2017-12-13
+% Date of the translated German file: 2019-10-09
\section{Choosing the Document Font Size}
\seclabel{fontOptions}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex b/macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex
index c08b203b29..3eb44965c1 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-footnotes.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-footnotes.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-footnotes.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{common-footnotes.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs: Footnotes)]
\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2018-01-29
+% Date of the translated German file: 2019-10-10
\section{Footnotes}
\seclabel{footnotes}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex b/macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex
index 8f9fcbb946..2e39697578 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-headfootheight.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-headfootheight.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-headfootheight.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ============================================================================
\KOMAProvidesFile{common-headfootheight.tex}
- [$Date: 2018-02-28 13:23:23 +0100 (Wed, 28 Feb 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraph: Head and Foot Height)]
\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne\and Karl Hagen}
-% Date of the translated German file: 2018-01-16
+% Date of the translated German file: 2019-10-10
\section{Header and Footer Height}
\seclabel{height}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex b/macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex
index 36f9fb4ae4..0f1fe6a0d6 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-interleafpage.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-interleafpage.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-interleafpage.tex
-% Copyright (c) Markus Kohm, 2001-2017
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-interleafpage.tex}%
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs: Interleaf Pages)]
\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and
Karl Hagen}
-% Date of the translated German file: 2017-12-07
+% Date of the translated German file: 2019-10-09
\section{Interleaf Pages}
\seclabel{emptypage}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-lists.tex b/macros/latex/contrib/koma-script/source-doc/english/common-lists.tex
index 79a0a697fd..9b18e0551e 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-lists.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-lists.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-lists.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-lists.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-lists.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
Karl Hagen}
-% Date of the translated German file: 2018-02-06
+% Date of the translated German file: 2019-10-10
\section{Lists}
\seclabel{lists}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex b/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex
index 05e2bdd1f3..22669838cb 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-marginpar.tex
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{common-marginpar.tex}
- [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-01-29
+% Date of the translated German file: 2019-10-10
\section{Marginal Notes}
\seclabel{marginNotes}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex b/macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex
index 04ff2b91ac..8617a74e52 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-oddorevenpage.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-oddorevenpage.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-oddorevenpage.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-oddorevenpage.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraph: Detection of Odd and
Even Pages)]
\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2018-01-30
+% Date of the translated German file: 2019-10-10
\section{Detecting Odd and Even Pages}
\seclabel{oddOrEven}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-options.tex b/macros/latex/contrib/koma-script/source-doc/english/common-options.tex
index fff22502bb..b8c4d5fb70 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-options.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-options.tex
@@ -50,7 +50,7 @@
KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2018-10-23
+% Date of the translated German file: 2019-10-09
\section{Early or Late Selection of Options}
\seclabel{options}
@@ -140,18 +140,14 @@ described in \cite{latex:usrguide} or any introduction to \LaTeX, for example
\par
}{}
-% Umbruchoptimierung!!!
-\IfThisCommonLabelBase{typearea}{Setting the options with
- \Macro{documentclass} has one\textnote{Attention!} major disadvantage: %
-}{%
- Note that \Macro{documentclass} has one drawback when using the option
- interface described bellow\textnote{Attention!}: %
-}%
-unlike the interface described below, the options in \Macro{documentclass} are
-not robust. So commands, lengths, counters, and such constructs may break
-inside the optional argument of this command. For example, with many
-non-\KOMAScript{} classes, using a \LaTeX{} length in the value of an option
-results in an error%
+% The alternative text for wrapping optimization was redundant and, as
+% it's not required for the English version, has been deleted.
+Setting the options with \Macro{documentclass} has one\textnote{Attention!}
+major disadvantage: unlike the interface described below, the options in
+\Macro{documentclass} are not robust. So commands, lengths, counters, and
+similar constructs may break inside the optional argument of this command.
+For example, with many non-\KOMAScript{} classes, using a \LaTeX{} length
+in the value of an option results in an error%
\IfThisCommonLabelBaseNotOneOf{maincls,scrlttr2}{ before the value is passed
to a \KOMAScript{} package and it can take control of the option
execution}{}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex b/macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex
index 3a3933167d..3814320ed6 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-pagestylemanipulation.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-pagestylemanipulation.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-pagestylemanipulation.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -51,7 +51,7 @@
Setting up defined page styles)]
\translator{Markus Kohm\and Jana Schubert\and Karl Hagen}
-% Date version of the translated file: 2018-02-05
+% Date version of the translated file: 2019-10-09
\section{Manipulating Page Styles}
\seclabel{pagestyle.content}
@@ -1031,7 +1031,6 @@
%%% Local Variables:
%%% mode: latex
%%% mode: flyspell
-%%% coding: iso-latin-1
%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide.tex"
%%% TeX-PDF-mode: t
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex b/macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex
index 647d09dde3..4f6ca3c703 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-parmarkup.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-parmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-parmarkup.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-parmarkup.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraph: Paragraph Markup)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
Karl Hagen}
-% Date of the translated German file: 2018-01-31
+% Date of the translated German file: 2019-10-10
\section{Marking Paragraphs}
\seclabel{parmarkup}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex b/macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex
index 49cbe456ed..61e26626b1 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-textmarkup.tex
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{common-textmarkup.tex}
- [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
Karl Hagen}
-% Date of the translated German file: 2018-07-20
+% Date of the translated German file: 2019-10-09
\section{Text Markup}
\seclabel{textmarkup}%
@@ -782,13 +782,13 @@ size and the baseline skip.%
\IfThisCommonLabelBase{scrjura}{%
\par%
However, the misuse of the font settings is strongly discouraged (see
- \autoref{sec:maincls-experts.experts},
+ \autoref{sec:maincls-experts.fonts},
\DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist})!%
}{%
\par%
However, you should not take these commands as legitimizing the insertion
of arbitrary commands in an element's font setting. To do so can lead
- quickly to errors (see \autoref{sec:maincls-experts.experts},
+ quickly to errors (see \autoref{sec:maincls-experts.fonts},
\DescPageRef{maincls-experts.cmd.addtokomafontrelaxlist}).%
}%
}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex b/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex
index e061743806..3baf017cb6 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-titles.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-titles.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-titles.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,13 +46,13 @@
% ======================================================================
\KOMAProvidesFile{common-titles.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi\and
Karl Hagen}
-% Date of the translated German file: 2018-01-30
+% Date of the translated German file: 2019-10-10
\section{Document Titles}
\seclabel{titlepage}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex b/macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex
index 30b89d0331..587513ee0d 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/common-typearea.tex
@@ -1,6 +1,6 @@
% ======================================================================
% common-typearea.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-typearea.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{common-typearea.tex}
- [$Date: 2018-03-30 09:37:06 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (common paragraphs: typearea)]
\translator{Markus Kohm\and Krickette Murabayashi\and Karl Hagen}
-% Date of the translated German file: 2018-02-01
+% Date of the translated German file: 2019-10-10
\section{Page Layout}
\seclabel{typearea}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/guide-english.tex b/macros/latex/contrib/koma-script/source-doc/english/guide-english.tex
index edebaee2b9..6e16884217 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/guide-english.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/guide-english.tex
@@ -1,6 +1,6 @@
% ======================================================================
% guide-english.tex
-% Copyright (c) Markus Kohm, 2002-2018
+% Copyright (c) Markus Kohm, 2002-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% guide-english.tex
-% Copyright (c) Markus Kohm, 2002-2018
+% Copyright (c) Markus Kohm, 2002-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,7 +46,7 @@
% ======================================================================
%
\KOMAProvidesFile{guide-english.tex}
- [$Date: 2018-03-21 10:37:34 +0100 (Wed, 21 Mar 2018) $
+ [$Date: 2019-02-20 12:41:53 +0100 (Wed, 20 Feb 2019) $
KOMA-Script guide language dependencies]
%
% \section{Extra Packages}
@@ -303,7 +303,7 @@
% \begin{macro}{\GuideVariable}
% \begin{macro}{\GuideVariableIndexCategory}
% \begin{macro}{\GuideVariableIndexCategoryExpanded}
-% The termo ``variable''.
+% The term ``variable''.
% \begin{macrocode}
\newcommand*{\GuideVariable}{variable}
\newcommand*{\GuideVariableIndexCategory}{variables}
@@ -313,6 +313,19 @@
% \end{macro}
% \end{macro}
%
+% \begin{macro}{\GuideHook}
+% \begin{macro}{\GuideHookIndexCategory}
+% \begin{macro}{\GuideHookIndexCategoryEpanded}
+% The term ``hook''.
+% \begin{macrocode}
+\newcommand*{\GuideHook}{hook}
+\newcommand*{\GuideHookIndexCategory}{hooks}
+\let\GuideHookIndexCategoryExpanded\GuideHookIndexCategory
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
% \begin{macro}{\GuideAnd}
% The ``and'' at a list of two.
% \begin{macrocode}
@@ -351,6 +364,8 @@
% \begin{macro}{\GuidefilIndexShort}
% \begin{macro}{\GuideoptIndex}
% \begin{macro}{\GuideoptIndexShort}
+% \begin{macro}{\GuidehokIndex}
+% \begin{macro}{\GuidehokIndexShort}
% The titles and short titles of each single index.
\newcommand*{\GuidegenIndex}{General Index}%
\newcommand*{\GuidecmdIndex}{Index of Commands, Environments, and Variables}%
@@ -364,6 +379,10 @@
\newcommand*{\GuidefilIndexShort}{Index of Files, etc.}%
\newcommand*{\GuideoptIndex}{Index of Class and Package Options}%
\newcommand*{\GuideoptIndexShort}{Index of Options}%
+\newcommand*{\GuidehokIndex}{Index of Do-Hooks}
+\let\GuidehokIndexShort\GuidehokIndex
+% \end{macro}
+% \end{macro}
% \end{macro}
% \end{macro}
% \end{macro}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/htmlsetup b/macros/latex/contrib/koma-script/source-doc/english/htmlsetup
index 8c30c6ed56..7364ac8bce 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/htmlsetup
+++ b/macros/latex/contrib/koma-script/source-doc/english/htmlsetup
@@ -1,6 +1,6 @@
# ======================================================================
# htmlsetup
-# Copyright (c) Markus Kohm, 2002-2013
+# Copyright (c) Markus Kohm, 2002-2019
#
# This file is part of the LaTeX2e KOMA-Script bundle.
#
@@ -18,7 +18,7 @@
# This work consists of all files listed in manifest.txt.
# ----------------------------------------------------------------------
# htmlsetup
-# Copyright (c) Markus Kohm, 2002-2013
+# Copyright (c) Markus Kohm, 2002-2019
#
# Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
# Version 1.3c, verteilt und/oder veraendert werden.
@@ -39,18 +39,17 @@ $baselink="scrguien.pdf";
$htmlhead="<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.0//EN\">
<html>
<head><title>Index</title>
-<meta http-equiv=\"content-type\" content=\"text/html; charset=utf-8\">
+ <meta http-equiv=\"content-type\" content=\"text/html; charset=utf-8\">
</head>
<body>
-<h1>Index of the KOMA-Script Guide</h1>
-<p>This is an index of the elements defined at KOMA-Script. This index is related to the <a href=\"scrguien.pdf\">KOMA-Script guide</a>. To improve the survey this index has serveral functional sections:</p>
+ <h1>Index of the KOMA-Script Guide</h1>
+ <p>This is an index of the elements defined at KOMA-Script. This index is related to the <a href=\"scrguien.pdf\">KOMA-Script guide</a>. To improve the survey this index has serveral functional sections:</p>
";
-$htmlend="<p>
-<a href=\"http://validator.w3.org/check?uri=referer\"><img
+$htmlend=" <p><a href=\"http://validator.w3.org/check?uri=referer\"><img
src=\"http://www.w3.org/Icons/valid-html40\"
-alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a>
-</p>
-</body></html>";
+alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a></p>
+</body>
+</html>";
%titles=( "option" => "Options",
"macro" => "Commands",
"environment" => "Environments",
@@ -60,6 +59,7 @@ alt=\"Valid HTML 4.0 Strict\" height=\"31\" width=\"88\"></a>
"pagestyle" => "Page Styles",
"counter" => "Counter",
"floatstyle" => "Styles for the float Package",
- "fontelement" => "Elements (Font May Be Changed)" );
+ "fontelement" => "Elements (Font May Be Changed)",
+ "dohook" => "Do-Hooks for Low-Level Manipulation" );
# end of file
diff --git a/macros/latex/contrib/koma-script/source-doc/english/introduction.tex b/macros/latex/contrib/koma-script/source-doc/english/introduction.tex
index 9331720287..610cef80df 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/introduction.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/introduction.tex
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{introduction.tex}
- [$Date: 2019-01-15 08:39:58 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide introduction]
\translator{Kevin Pfeiffer\and Gernot Hassenpflug\and
Krickette Murabayashi\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-02-05
+% Date of the translated German file: 2019-10-10
\chapter{Introduction}
\labelbase{introduction}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/japanlco.tex b/macros/latex/contrib/koma-script/source-doc/english/japanlco.tex
index 6503afae06..0a7bdcb757 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/japanlco.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/japanlco.tex
@@ -1,6 +1,6 @@
% ======================================================================
% japanlco.tex
-% Copyright (c) Gernot Hassenpflug and Markus Kohm, 2001-2018
+% Copyright (c) Gernot Hassenpflug and Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% japanlco.tex
-% Copyright (c) Gernot Hassenpflug und Markus Kohm, 2001-2018
+% Copyright (c) Gernot Hassenpflug und Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -40,7 +40,7 @@
%
% ----------------------------------------------------------------------
%
-% Kapitel ueber japanische Papierformate, Umschläge und Briefe
+% Kapitel ueber japanische Papierformate, Umschlaege und Briefe
% Verwaltet von Gernot Hassenplug (mit Unterstuetzung von Markus Kohm)
%
% ======================================================================
@@ -50,7 +50,7 @@
%
\KOMAProvidesFile{japanlco.tex}
- [$Date: 2018-03-21 10:37:34 +0100 (Wed, 21 Mar 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (appendix: japanlco)]
\appendix
@@ -596,6 +596,5 @@ fit the required envelope.
%%% Local Variables:
%%% mode: latex
-%%% coding: iso-latin-1
%%% TeX-master: t
%%% End:
diff --git a/macros/latex/contrib/koma-script/source-doc/english/preface.tex b/macros/latex/contrib/koma-script/source-doc/english/preface.tex
index 873f303987..3c83ac1ff1 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/preface.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/preface.tex
@@ -1,6 +1,6 @@
% ======================================================================
% preface.tex
-% Copyright (c) Markus Kohm, 2008-2018
+% Copyright (c) Markus Kohm, 2008-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% preface.tex
-% Copyright (c) Markus Kohm, 2008-2018
+% Copyright (c) Markus Kohm, 2008-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -36,11 +36,11 @@
% ======================================================================
\KOMAProvidesFile{preface.tex}
- [$Date: 2018-03-28 11:44:09 +0200 (Wed, 28 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
Preface to version 3.25]
\translator{Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-03-12
+% Date of the translated German file: 2019-10-10
\addchap{Preface to \KOMAScript~3.25}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scraddr.tex b/macros/latex/contrib/koma-script/source-doc/english/scraddr.tex
index ac5ef90a5e..50543b2b4b 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scraddr.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scraddr.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scraddr.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scraddr.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{scraddr.tex}
- [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scraddr)]
\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and Karl
Hagen}
-% Date of the translated German file: 2018-02-05
+% Date of the translated German file: 2019-10-10
\chapter{Accessing Address Files with \Package{scraddr}}%
\labelbase{scraddr}%
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrbase.tex b/macros/latex/contrib/koma-script/source-doc/english/scrbase.tex
index 80ed5b2b03..2b7fadda1a 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrbase.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrbase.tex
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{scrbase.tex}
- [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script package scrbase]
\translator{Markus Kohm\and Melvin Hendrix\and Karl Hagen}
-% Date of the translated German file: 2018-08-27
+% Date of the translated German file: 2019-10-09
\chapter{Basic Functions in the \Package{scrbase} Package}
\labelbase{scrbase}
@@ -85,7 +85,7 @@ The options provided by \Package{scrbase} also use \Package{keyval} syntax:
\PName{key}\texttt{=}\PName{value}.
-\section{Keys as Attributes of Families and their Members}
+\section{Keys as Attributes of Families and Their Members}
\seclabel{keyvalue}
As already mentioned in \autoref{sec:scrbase.loadit}, \Package{scrbase} uses
@@ -238,8 +238,8 @@ predefined states should be sufficient.
If the key is used later, one of the permitted values, or no value, must be
used. In the second case, the default \PName{true} value will be used.
- The definitions for the other packages are similar. Only ``\texttt{salami}''
- has to be replaced by the respective names.
+ The definitions for the other packages are nearly identical. Only the string
+ ``\texttt{salami}'' has to be replaced.
\end{Example}
%
\EndIndexGroup
@@ -373,9 +373,10 @@ If\ChangedAt{v3.20}{\Package{scrbase}} you call \Macro{FamilyExecuteOptions}
with an unknown option inside the \PName{options list}, you will get an error.
An exception to this rule occurs when the \PName{member} has an option called
\Option{@else@}. In this case, the \Option{@else@} option will be used instead
-of the unknown option. \KOMAScript{} itself uses this feature, for example
-inside the definition of sectioning commands, to evaluate the style option
-before all other attributes.
+of the unknown one. The value passed to the \Option{@else@} option is the
+unknown option with the value specified in the call. \KOMAScript{} itself uses
+this feature, for example inside the definition of sectioning commands,
+to evaluate the style option before all other attributes.
You can also use this command inside the code executed when processing the
option.%
@@ -451,9 +452,17 @@ members returns an error through \DescRef{\LabelBase.cmd.FamilyKeyState}.
ensures that its own \Option{coldcuts} option has already been redefined.
This avoids endless recursion.
\end{Example}
-%
+
+Like\ChangedAt{v3.27}{\Package{scrbase}}
+\DescRef{\LabelBase.cmd.FamilyExecuteOptions}, \Macro{FamilyOptions} offers
+special handling for an option named
+\Option{@else@}\important{\Option{@else@}}. If a family member has such an
+option, it will be executed whenever an option in the \PName{option list} is
+unrecognized by the member. If the family itself defines an option
+\Option{@else@}, it will only be called if neither the family nor any of its
+members were able to fully process the given option by executing
+\DescRef{\LabelBase.cmd.FamilyKeyStateProcessed}.%
\EndIndexGroup
-\vskip-\ht\strutbox% Umbruchkorrektur wegen Beispiel am Ende
\begin{Declaration}
@@ -499,7 +508,9 @@ described for \DescRef{\LabelBase.cmd.FamilyOptions}.
{ingredient}{onions,gherkins}
\end{lstcode}
\end{Example}
-%
+
+An\ChangedAt{v3.27}{\Package{scrbase}} \Option{@else@} option is processed
+in the same manner as with \DescRef{\LabelBase.cmd.FamilyOptions}.%
\EndIndexGroup
@@ -615,8 +626,24 @@ message about an unknown value assignment is printed if necessary (see also
\Macro{ifx} at this point. Fully expanding tests like \Macro{ifstr} should
be avoided here. Depending on the current status and the comparison status,
they can lead to different error messages as well as incorrect results.
-\end{Example}
-%
+\end{Example}%
+\EndIndexGroup
+
+\begin{Declaration}
+ \Macro{FamilyInverseBoolKey}\OParameter{member}\Parameter{family}
+ \Parameter{key}\Parameter{switch name}
+ \Macro{FamilySetInverseBool}\Parameter{family}
+ \Parameter{key}\Parameter{switch name}
+ \Parameter{value}
+\end{Declaration}
+These\ChangedAt{v3.27}{\Package{scrbase}} two commands differ from
+\DescRef{\LabelBase.cmd.FamilyBoolKey} and
+\DescRef{\LabelBase.cmd.FamilySetBool}, respectively, only in that the
+logic is inverted. This means that the values \PValue{true}, \PValue{yes}, and
+\PValue{on} set the boolean switch given by \PName{switch name} to
+\Macro{iffalse} and therefore deactivate it. The values \PValue{false},
+\PValue{no}, and \PValue{off} set the boolean switch to \Macro{iftrue} and
+therefore activate it.%
\EndIndexGroup
@@ -763,13 +790,13 @@ is called applies.%
\OParameter{default}\Parameter{macro}
\Macro{FamilySetLengthMacro}\Parameter{family}
\Parameter{key}\Parameter{macro}
- \Parameter{value}%
+ \Parameter{value}
\Macro{FamilyUseLengthMacroKey}\OParameter{member}\Parameter{family}
\Parameter{key}
\OParameter{default}\Parameter{macro}
\Macro{FamilySetUseLengthMacro}\Parameter{family}
\Parameter{key}\Parameter{macro}
- \Parameter{value}%
+ \Parameter{value}
\end{Declaration}
With\ChangedAt{v3.12}{\Package{scrbase}} \Macro{FamilyLengthKey}, you can
define a \PName{key} that represents a \PName{length}. It does not matter
@@ -1313,6 +1340,67 @@ corresponding internal command.%
\EndIndexGroup
+\begin{Declaration}
+ \Macro{IfActiveMkBoth}\Parameter{then code}\Parameter{else code}
+\end{Declaration}
+The\ChangedAt{v3.27}{\Package{scrbase}} \LaTeX{} kernel uses
+\DescRef{scrlayer.cmd.@mkboth}\important{\Macro{@mkboth}}\IndexCmd{@mkboth} to
+distinguish between automatic and manual running heads. Usually, it sets both
+marks with automatic running heads. With manual running heads, it does not set
+any mark. To determine whether automatic running heads are active, many
+packages compare \DescRef{scrlayer.cmd.@mkboth} with either
+\DescRef{maincls.cmd.markboth}\IndexCmd{markboth} or \Macro{@gobbletwo}. But
+this does not account for all cases in which \DescRef{scrlayer.cmd.@mkboth}
+may be redefined. Therefore \Macro{IfActiveMkBoth} tests if
+\DescRef{scrlayer.cmd.@mkboth} would actually set a mark, even when
+\Macro{marks} appears in the definition of \DescRef{scrlayer.cmd.@mkboth}. If
+such an active \DescRef{scrlayer.cmd.@mkboth} is detected, the
+\PName{then code} is executed. In all other cases, the \PName{else code} is
+used.%
+\begin{Example}
+ For example, suppose you want to set the right mark if and only if
+ automatic running heads are used, e.\,g., the pagestyle
+ \PageStyle{headings}\IndexPagestyle{headings}. For a first attempt,
+ you might use:
+\begin{lstcode}
+ \ifx\@mkboth\markboth \markright{running head}\fi
+\end{lstcode}
+ Later you discover that some package does not use the usual
+\begin{lstcode}
+ \let\@mkboth\markboth
+\end{lstcode}
+ but
+\begin{lstcode}
+ \renewcommand{\@mkboth}{\markboth}
+\end{lstcode}
+ to activate automatic running heads. Because of this, your comparison always
+ fails and never calls \DescRef{maincls.cmd.markright}. To solve this, you
+ try the following change:
+\begin{lstcode}
+ \ifx\@mkboth\@gobbletwo\else \markright{running head}\fi
+\end{lstcode}
+ Unfortunately, now \DescRef{maincls.cmd.markright} is also called for
+ manual running heads, because someone has defined
+\begin{lstcode}
+ \renewcommand{\@mkboth}[2]{%
+ \typeout{DEBUG: ignoring running head setting}%
+ }
+\end{lstcode}
+ for this case.
+
+ Fortunately, both problems are easy to solve with \Package{scrbase}:
+\begin{lstcode}
+ \IfActiveMKBoth{\markright{Kolumnentitel}}{}
+\end{lstcode}%
+\end{Example}
+By the way, an even simpler solution for the problem in the example
+would be to use \DescRef{scrlayer.cmd.@mkright} from package
+\hyperref[cha:scrlayer]{\Package{scrlayer}} (see
+\autoref{sec:scrlayer.pagestyle.content},
+\DescPageRef{scrlayer.cmd.@mkright}).%
+\EndIndexGroup
+
+
\section{Defining Language-Dependent Terms}
\seclabel{languageSupport}
\BeginIndexGroup
@@ -1628,10 +1716,9 @@ correctly. Sometimes additional operators would be useful.
\Macro{XdivY}\Parameter{dividend}\Parameter{divisor}%
\Macro{XmodY}\Parameter{dividend}\Parameter{divisor}%
\end{Declaration}%
-The command\ChangedAt{v3.05a}{\Package{scrbase}}
-\Macro{XdivY} returns the value of the integer quotient, with command
-\Macro{XmodY} giving the value of the remainder. This type of of division is
-defined by the equation
+The\ChangedAt{v3.05a}{\Package{scrbase}} \Macro{XdivY} command returns the
+value of the integer quotient, with the \Macro{XmodY} command giving the value
+of the remainder. This type of of division is defined by the equation
\[
\textit{dividend} = \textit{divisor} \cdot
\textit{integer quotient} + \textit{remainder}
@@ -1645,9 +1732,236 @@ using \Macro{numexpr}. To output the value as an Arabic number, you must
prefix it with \Macro{the}.%
%
\EndIndexGroup
+
+
+\section[{General Mechanism for Multi-Level Hooks}]
+{General Mechanism for Multi-Level
+ Hooks\ChangedAt[2019/01]{v3.27}{\Package{scrbase}}}
+\seclabel{hooks}
+
+\BeginIndexGroup
+\BeginIndex{}{Hooks}
+The \LaTeX{} kernel provides a few \emph{hooks} in the processing of
+a document where additional code can be inserted. Class and package authors
+should be very familiar with \Macro{AtBeginDocument} and
+\Macro{AtEndDocument}. \KOMAScript{} offers similar features in some places,
+for example to hook code into the execution of
+\hyperref[sec:maincls.structure]{sectioning commands}. Over the years, there
+have been two problems:
+\begin{itemize}
+ \item There are never enough hooks.
+ \item There is some code that should only be executed once, as if it almost
+ drops off the hook, as well as code that must be executed each time the
+ hook is encountered, thus remaining permanently on the hook.
+\end{itemize}
+Usually, to define a single hook you must define a command that collects the
+code for each hook. This code is then stored in another internal macro, which
+must be inserted at the point where the collected code is executed. The more
+hooks you insert, the more such commands there are. To allow for both
+single-use code and permanent code may even require two hooks, and therefore
+twice the number of commands to be defined.
+
+The example of sectioning commands shows that the first problem can sometimes
+be exacerbated by having only a single point for code execution. One package
+author may need only one way to execute the same code for all sectioning
+commands. Another package author would prefer to execute different code for
+certain sectioning commands only. Meeting both these demands would require a
+general hook as well as a hook for each sectioning command. These requirements
+are doubled again because of the second problem.
+
+\KOMAScript{} therefore offers a generalized hook mechanism in
+\Package{scrbase} that provides multi-level hooks for both single-use and
+persistent code. These hooks are named \emph{do-hooks} because of their
+implementation. From this also comes the names of the instructions by which
+they are controlled.
+
+\begin{Declaration}
+ \Macro{ExecuteDoHook}\Parameter{specifier}
+\end{Declaration}
+Hooks\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} are implemented with this
+command. The \PName{specifier} determines the name or names of the hook. The
+\PName{specifier} is always completely expanded for analysis.
+
+The \PName{specifier} generally consists of strings separated by forward
+slashes (``/''). Initially, \Macro{ExecuteDoHook} divides the string at the
+first slash. The first part is the name. The remainder (without the slash) is
+the argument. Then the code for the hook with this name is executed. Next the
+first part of the remaining string is divided again from the remainder,
+combined with a slash after the name to form a new name, and the code with
+this name is executed. This process continues until the code for the hook with
+the name \PName{specifier} has been executed and the argument is empty.
+
+In the simplest case, the \PName{specifier} consists of a single name. In this
+case, the persistent code is executed first, with an empty argument, for
+exactly one hook specified by this name.
+
+At each stage of execution, single-use code is also executed after the hook's
+persistent code, and then the single-use code is globally removed from the
+hook.
+
+\begin{Example}
+ By inserting \DescRef{\LabelBase.cmd.ExecuteDoHook}%
+ \PParameter{heading/begingroup/\PName{name}} into the execution of each
+ sectioning command defined with
+ \DescRef{maincls-experts.cmd.DeclareSectionCommand}, the \KOMAScript{}
+ classes ultimately have six hooks inserted at that code-point, executed in
+ this order:
+ \begin{enumerate}
+ \item \PValue{heading} with the argument \PValue{begingroup/}\PName{name}
+ for persistent code,
+ \item \PValue{heading} with the argument \PValue{begingroup/}\PName{name}
+ for single-use code,
+ \item \PValue{heading/begingroup} with the argument \PName{name} for
+ persistent code,
+ \item \PValue{heading/begingroup} with the argument \PName{name} for
+ single-use code,
+ \item \PValue{heading/begingroup/}\PName{name} with an empty argument for
+ persistent code,
+ \item \PValue{heading/begingroup/}\PName{name} with an empty argument for
+ single-use code.
+ \end{enumerate}
+ The \PName{name} is the name of section level specified in
+ \DescRef{maincls-experts.cmd.DeclareSectionCommand},
+ \DescRef{maincls-experts.cmd.DeclareNewSectionCommand} or
+ \DescRef{maincls-experts.cmd.ProvideSectionCommand}, or the sectioning
+ command specified by it, for example \PValue{chapter} or
+ \PValue{subparagraph}. Looking at the list above, and considering that there
+ are various sectioning commands, it becomes clear that the \PValue{heading}
+ and \PValue{heading/begingroup} hooks will be called multiple times for each
+ sectioning command.%
+\end{Example}%
%
\EndIndexGroup
+\begin{Declaration}
+ \Macro{AddtoDoHook}\Parameter{name}\Parameter{command}
+ \Macro{AddtoOneTimeDoHook}\Parameter{name}\Parameter{command}
+\end{Declaration}
+\Macro{AddtoDoHook}\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} appends
+persistent code to the hook named \PName{name}. The code to be added is the
+\PName{command}, to which the argument mentioned in the description of
+\DescRef{\LabelBase.cmd.ExecuteDoHook} is appended as a parameter.
+\begin{Example}
+ Suppose you want to count how many times the \Macro{section} command is
+ executed. This would be simple, continuing the previous example:
+\begin{lstcode}
+ \newcounter{sectionCounter}
+ \AddtoDoHook{heading/begingroup/section}
+ {\stepcounter{sectionCounter}}
+\end{lstcode}
+ However, in reality, \Macro{stepcounter}\PParameter{sectionCounter}%
+ \PParameter{} would be executed. Remember that an argument is always appended
+ as a parameter. In the case of the hook named
+ \PValue{heading/begingroup/section}, this argument is empty. Since an empty
+ parameter becomes an empty group here, it is better to consume this empty
+ parameter:
+\begin{lstcode}
+ \newcommand*{\stepcountergobble}[2]{%
+ \stepcounter{#1}%
+ }
+ \AddtoDoHook{heading/begingroup/section}
+ {\stepcountergobble{sectionCounter}}
+\end{lstcode}
+ Here, the appended, empty parameter of \Macro{stepcountergobble} is read but
+ not used.
+
+ If instead of \Macro{section}, you want to count all sectioning commands, you
+ only need to change the hook name:
+\begin{lstcode}
+ \AddtoDoHook{heading/begingroup}
+ {\stepcountergobble{sectionCounter}}
+\end{lstcode}
+ By the way, the appended parameter is not empty in this case but contains the
+ name of the sectioning level or sectioning command. If you wanted to count
+ the sectioning commands individually, you could just use this:
+\begin{lstcode}
+ \newcommand*{\stepCounter}[1]{%
+ \stepcounter{#1Counter}%
+ }
+ \AddtoDoHook{heading/begingroup}
+ {\stepCounter}
+\end{lstcode}
+ Of course, you must also define the counters \Counter{partCounter},
+ \Counter{chapterCounter} down to \Counter{subparagraphCounter}.
+\end{Example}
+
+The \Macro{AddtoOneTimeDoHook} command works similarly but adds the
+\PName{command} to the single-use code. This code will be globally removed
+after the first execution.%
+\EndIndexGroup
+
+\begin{Declaration}
+ \Macro{ForDoHook}\Parameter{specification}\Parameter{command}
+\end{Declaration}
+While\ChangedAt[2019/01]{v3.27}{\Package{scrbase}}
+\DescRef{\LabelBase.cmd.ExecuteDoHook} executes the commands previously stored
+with \DescRef{\LabelBase.cmd.AddtoDoHook} or
+\DescRef{\LabelBase.cmd.AddtoOneTimeDoHook} for the hook given by the
+\PName{specifier}, this macro executes the \PName{command} immediately. There
+are two parameters added to the \PName{command}. The first is the hook's name;
+the second, the hook's argument.
+
+This command is a byproduct of the implementation of
+\DescRef{\LabelBase.cmd.ExecuteDoHook}. Normally, neither end users nor package
+authors should need this command.%
+\EndIndexGroup
+
+\begin{Declaration}
+ \Macro{SplitDoHook}\Parameter{specifier}\Parameter{head macro}
+ \Parameter{remainder macro}
+\end{Declaration}
+As\ChangedAt[2019/01]{v3.27}{\Package{scrbase}} can be seen from the preceding
+explanations, the parameter of a \PName{command} added with
+\DescRef{\LabelBase.cmd.AddtoDoHook} or
+\DescRef{\LabelBase.cmd.AddtoOneTimeDoHook} can also be a multi-part
+\PName{specifier}. You can use \Macro{SplitDoHook} to divide a
+\PName{specifier} into the front element and the remainder. The
+\PName{head macro} will be set to the front element. The \PName{remainder
+macro} will be set to the rest. If there is no remainder left, the
+\PName{remainder macro} is set to empty. If the \PName{specifier} was already
+empty, a warning is issued and both the \PName{head macro} and the
+\PName{remainder macro} are set to empty.
+
+\begin{Example}
+ If you want to increase a counter at the start of a group in which a heading
+ is issued but decrease it at the end, you can do this with two hooks:
+\begin{lstcode}
+ \AddtoDoHook{heading/begingroup}
+ {\stepCounter}
+ \newcommand*{\restepCounter}[1]{%
+ \addtocounter{#1Counter}{-1}%
+ }
+ \AddtoDoHook{heading/endgroup}
+ {\restepCounter}
+\end{lstcode}
+ But you could also use a single hook and split its parameters:
+\begin{lstcode}
+ \newcommand*{\changeCounter}[1]{%
+ \SplitDoHook{#1}{\Group}{\Level}%
+ \ifstr{\Group}{begingroup}{%
+ \stepcounter{\Level Counter}%
+ }{%
+ \ifstr{\Group}{endgroup}{%
+ \addtocounter{\Level Counter}{-1}%
+ }{}%
+ }%
+ }
+ \AddtoDoHook{heading}
+ {\changeCounter}
+\end{lstcode}
+ As you can see, the first solution is much simpler. In addition, it would
+ be easy to overlook including the empty group for the second false-case in
+ the second example. That would be fatal, however, as there make be other
+ hooks with named \PValue{heading} but with different arguments.
+\end{Example}
+
+Strictly speaking, this command is a byproduct of the implementation of
+\DescRef{\LabelBase.cmd.ForDoHook}.%
+\EndIndexGroup
+%
+\EndIndexGroup
+\EndIndexGroup
+
\endinput
%%% Local Variables:
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex
index 1629f29923..247aaf6f02 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle-experts.tex
@@ -48,13 +48,13 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle-experts.tex}
- [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-09 16:34:25 +0200 (Wed, 09 Oct 2019) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for
experts)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-10-14
+% Date of the translated German file: 2019-10-09
\chapter[{Additional Information about the Main Classes and
\Package{scrextend}}]{Additional Information about the Main Classes
@@ -62,7 +62,8 @@
\Class{scrreprt}, and \Class{scrartcl} as well as the Package
\Package{scrextend}}
\labelbase{maincls-experts}
-\BeginIndexGroup
+
+\BeginIndexGroup%
\BeginIndex{Class}{scrartcl}%
\BeginIndex{Class}{scrbook}%
\BeginIndex{Class}{scrreprt}%
@@ -74,12 +75,14 @@ are also available in \Package{scrextend}. \iffree{Some parts of the chapter
should not be a problem because the}{The} average user, who only wants to
use the classes, will seldom need this information. Some of this information
is addressed to users with non-standard requirements or who want to write
-their own classes based on a \KOMAScript{} class. Other parts describe
-features that exist only for the sake of compatibility with the standard
-classes or earlier versions of \KOMAScript{}. Portions that describe features
-that exist only for reasons of compatibility with earlier versions of
-\KOMAScript{} are printed in sans serif font. You should not use them any
-longer.
+their own classes based on a \KOMAScript{} class. Because such descriptions
+are not addressed to beginners, they are condensed and require deeper
+knowledge of \LaTeX. Other parts describe features that exist only for the
+sake of compatibility with the standard classes or earlier versions of
+\KOMAScript{}.\iffree{}{
+ Portions that describe features that exist only for reasons of compatibility
+ with earlier versions of \KOMAScript{} are printed in sans serif font. You
+ should not use them any longer.}
\LoadNonFree{scrbookreportarticle-experts}{0}
@@ -95,15 +98,14 @@ longer.
\LoadNonFree{scrbookreportarticle-experts}{2}
-\section{Expert Commands}
-\seclabel{experts}
-
-This sections describes commands that are of little or no interest to the
-average user. These commands offer additional features for experts. Because
-the information is addressed to experts, it is condensed.
+\section{Detection of \KOMAScript{} Classes}
+\seclabel{identify}
-% \subsection{Identification}
-% \seclabel{identification}
+Package authors sometimes need to detect a \KOMAScript{} class. Mostly this is
+of little or no interest to the average user. To identify the version of
+\KOMAScript{} that is being used, refer to
+\DescRef{scrbase.cmd.KOMAScriptVersion} in \autoref{sec:scrbase.identify},
+\DescPageRef{scrbase.cmd.KOMAScriptVersion}.
\begin{Declaration}
\Macro{KOMAClassName}%
@@ -122,8 +124,14 @@ the \KOMAScript{} label using this name.%
%
\EndIndexGroup
-% \subsection{Entries to the Table of Contents}
-% \seclabel{toc}
+\section{Entries to the Table of Contents}
+\seclabel{toc}
+
+\KOMAScript{} classes provide advanced methods for generating and
+manipulating entries in the table of contents. Some of these are based on
+the \Package{tocbasic} package (see \autoref{sec:tocbasic.tocstyle} starting
+on \autopageref{sec:tocbasic.tocstyle}). Other are implemented directly in the
+classes.
\begin{Declaration}
\Macro{addtocentrydefault}\Parameter{level}\Parameter{number}%
@@ -236,9 +244,12 @@ rather than attempting to set the attribute for specific entry levels.%
\EndIndexGroup
-% \subsection{Font Settings}
-% \seclabel{fonts}
+\section{Font Settings}
+\seclabel{fonts}
+\KOMAScript{} classes not only provide an extended selection of basic font
+sizes, but they also let you define, manipulate, and apply elements with
+their own font settings.
\begin{Declaration}
\Macro{@fontsizefilebase}%
@@ -387,8 +398,14 @@ undefined elements as well as for elements defined with
\PName{else code}.%
\EndIndexGroup
-% \subsubsection{Paragraph Indention or Gap}
-% \seclabel{parskip}
+\section{Paragraph Indention or Gap}
+\seclabel{parskip}
+
+Because the \KOMAScript{} classes offer extended features for setting the
+paragraph indention or gap, direct changes of the standard lengths
+\Length{parskip}\IndexLength{parskip}, \Length{parindent}\IndexLength{parskip}
+and \Length{parfillskip}\IndexLength{parskip} are not only unnecessary but
+mostly inadvisable.
\begin{Declaration}
\Macro{setparsizes}\Parameter{indent}\Parameter{distance}
@@ -428,13 +445,17 @@ disables this recalculation.%
%
\EndIndexGroup
-% \subsection{Counters}
-% \seclabel{counter}
+\section{Counters}
+\seclabel{counter}
\LoadNonFree{scrbookreportarticle-experts}{3}
-% \subsubsection{Sections}
-% \seclabel{sections}
+\section{Sections}
+\seclabel{sections}
+
+The \KOMAScript{} classes provide a wide range of options for modifying
+sectioning levels and their corresponding headings. You can even define new
+levels.
\begin{Declaration}
\Macro{DeclareSectionCommand}\OParameter{attributes}\Parameter{name}%
@@ -526,9 +547,9 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or
the value of \PName{counter name}, the value of the counter of this
heading is reset to 0. In addition, \Macro{the\PName{counter name}} is
prefixed with a dot when this counter is output.\\
+ \PValue{counterwithout}%
\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- \PValue{counterwithout}
& \PName{counter name}
& Cancels a prior \PValue{counterwithin} setting. Therefore it makes sense
only if you redefine an existing sectioning command.\\
@@ -1128,8 +1149,21 @@ the \PName{list of names}. For all other sectioning command in the \PName{list
of names}, the values of \PValue{level} and \PValue{toclevel} are successively
increased by the value of \PValue{increaselevel}. If the
\PValue{increaselevel} attribute is used without assigning a value, 1 is
-assumed.
-%
+assumed.%
+\EndIndexGroup
+
+
+\begin{Declaration}
+ \Macro{IfSectionCommandStyleIs}\Parameter{name}\Parameter{style}
+ \Parameter{then code}\Parameter{else code}
+\end{Declaration}
+In\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
+rare cases, it is useful to be able to test whether a sectioning command
+belongs to a specific \PName{style}. If \KOMAScript{} has defined the
+sectioning command \Macro{\PName{name}} using the given \PName{style}, the
+\PName{then code} will be used. Otherwise the \PName{else code} will be
+executed. An error is reported if \Macro{\PName{name}} is undefined or if it
+is not a \KOMAScript{} sectioning command.%
\EndIndexGroup
@@ -1533,6 +1567,87 @@ same style \PValue{section}.%
\begin{Declaration}
+\DoHook{heading/preinit/\PName{name}}%
+\DoHook{heading/postinit/\PName{name}}%
+\DoHook{heading/branch/star/\PName{name}}%
+\DoHook{heading/branch/nostar/\PName{name}}%
+\DoHook{heading/begingroup/\PName{name}}%
+\DoHook{heading/endgroup/\PName{name}}%
+\end{Declaration}
+\BeginIndex{}{hooks}%
+In\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} addition to all their attributes,
+\DescRef{\LabelBase.cmd.DeclareSectionCommand},
+\DescRef{\LabelBase.cmd.DeclareNewSectionCommand},
+\DescRef{\LabelBase.cmd.ProvideSectionCommand} and
+\DescRef{\LabelBase.cmd.RedeclareSectionCommand} provide several hooks in
+sectioning commands that can be manipulated using
+\DescRef{scrbase.cmd.AddtoDoHook}. For information about the functionality of
+these \emph{do-hooks} see \autoref{sec:scrbase.hooks},
+\autopageref{sec:scrbase.hooks}. The last element of the specifier is the
+\PName{name} of the sectioning command, as it is for the declaration commands
+mentioned above.
+
+It is important\important{Attention!} to avoid adding code to these hooks that
+would affect the page breaking or the position of the heading. Therefore only
+advanced users should use these hooks. In case of doubt, refer to the class's
+source code for information about exactly when a hook is executed. These hooks
+serve as a fallback before you indeed would need to resort to redefining
+a section command without using \KOMAScript{} features.
+
+The\textnote{\DoHHook{\dits/preinit/\dots}} hook
+\DoHook{heading/preinit/\PName{name}} is executed immediately before the
+sectioning command is initialised. At this point, no settings have been
+initialised. Even the paragraph that precedes the heading is not
+necessarily finished yet.
+
+The\textnote{\DoHook{\dots/postinit/\dots}} hook
+\DoHook{heading/postinit/\PName{name}} is executed somewhat later. At this
+point, some settings have been initialised and the previous paragraph has
+already ended.
+
+Only\textnote{\DoHook{\dots/branch/\dots}} one of the hooks
+\DoHook{heading/branch/nostar/\PName{name}} or
+\DoHook{heading/branch/star/\PName{name}} is executed, after determining
+whether the starred or normal variant of the section command is used. At this
+point, the vertical gap above the heading has already been inserted.
+
+The\textnote{\DoHook{\dots/begingroup/\dots}} hook
+\DoHook{heading/begingroup/\PName{name}} is executed at the beginning of
+the group used to process the heading. This is also the last opportunity to
+intervene before the heading is printed.
+
+Similarly\textnote{\DoHook{\dots/begingroup/\dots}}, the hook
+\DoHook{heading/begingroup/\PName{name}} will be executed at the end of the
+group used to process the heading. Currently this is the last hook inside
+a section command.
+
+Note\textnote{\DescRef{maincls.cmd.minisec}} that
+\DescRef{maincls.cmd.minisec} is not a real sectioning command and therefore
+these hooks are not available for it.%
+\EndIndexGroup
+
+\begin{Declaration}
+ \Macro{IfUseNumber}\Parameter{then code}\Parameter{else code}
+\end{Declaration}
+Strictly\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} speaking, this is an internal command. It is defined
+inside sectioning commands only between the \DoHook{\dots/begingroup/\dots}
+and \DoHook{\dots/endroup/\dots} hooks. In this case, the
+\Parameter{then code} is executed if the sectioning heading uses the non-star
+variant and should be numbered according to the value of
+\DescRef{maincls.counter.secnumdepth}. If the heading should not be numbered
+because the sectioning command uses the star variant or because of the value
+of \DescRef{maincls.counter.secnumdepth}, the \PName{else code} is executed.
+Headings in the \PValue{chapter} style also take into account whether
+the headings appears in the main matter.
+
+If you use the command outside a sectioning command, the result is
+unspecified. In this case, it will usually result in an error message and
+execute neither the \PName{then code} nor the \PName{else code}.%
+\EndIndexGroup
+
+\begin{Declaration}
\Macro{SecDef}\Parameter{star command}\Parameter{command}%
\Macro{scr@startsection}\Parameter{name}\Parameter{level}\Parameter{indent}%
\Parameter{beforeskip}\Parameter{afterskip}%
@@ -1544,65 +1659,77 @@ same style \PValue{section}.%
\Parameter{style commands}%
\PValue{*}\Parameter{heading}%
\labelsuffix%
- \Macro{At@startsection}\Parameter{code}%
- \Macro{Before@ssect}\Parameter{code}%
- \Macro{Before@sect}\Parameter{code}
\end{Declaration}
As\ChangedAt[2014/09]{v3.15}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}} already explained in \autoref{sec:maincls.structure} in the
description of the sectioning commands beginning with
\DescPageRef{maincls.cmd.chapter}, \KOMAScript{} provides additional features
for the optional argument of those commands. To achieve this, it was necessary
-to replace some \LaTeX{} kernel commands, especially
-\Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}} and
-\Macro{@startsection}\IndexCmd{@startsection}%
-\important{\Macro{@startsection}}. The meaning of the parameters of these
-commands can be found in the \LaTeX{} kernel manual \cite{latex:source2e}.
-
-However, these commands are often completely redefined by other packages in a
-way that clashes with the functionality of \KOMAScript. So \KOMAScript{} not
-only changes the definition of these commands but also defines the additional,
-alternative commands \Macro{SecDef} and \Macro{scr@startsection}. Package
-authors can use these commands as they would use the corresponding \LaTeX{}
-kernel commands and therefore gain access to the additional features of
-\KOMAScript. However, these commands should not be redefined, as they may
+to replace some \LaTeX{} kernel commands:
+\begin{itemize}
+\item Instead of
+ \Macro{@startsection}\IndexCmd{@startsection}\important{\Macro{@startsection}}
+ \KOMAScript{} uses \Macro{scr@startsection}. However, the definition of
+ \Macro{@startsection} is checked. If the implementation differs from the
+ expected one, a warning is issued, several features of \KOMAScript{}
+ are deactivated, and \Macro{scr@startsection} uses a copy of
+ \Macro{@startsection} while \Macro{@startsection} is redefined to use
+ \Macro{scr@startsection}.
+\item Instead of \Macro{@dblarg}\IndexCmd{@dblarg}\important{\Macro{@dblarg}}
+ \KOMAScript{} uses an internal command to define sectioning commands.
+\item Instead of \Macro{secdef}\IndexCmd{secdef}\important{\Macro{secdef}},
+ \KOMAScript{} uses \Macro{SecDef} to change \Macro{@dblarg} as
+ mentioned above. If the implementation of \Macro{secdef} differs from the
+ expected one, a warning is issued.
+\item \Macro{@sect}\IndexCmd{@sect}\important{\Macro{@sect}} is redefined to
+ implement various extensions of \KOMAScript.
+\item \Macro{@ssect}\IndexCmd{@ssect}\important{\Macro{@ssect}} is redefined
+ to implement various extensions of \KOMAScript.
+\item \Macro{@xsect}\IndexCmd{@xsect}\important{\Macro{@xsect}} is redefined
+ to implement various extensions of \KOMAScript.
+\end{itemize}
+In future versions of \KOMAScript{}, consideration is being given to avoid
+changing the \LaTeX{} kernel commands mentioned above and to replace them
+completely with custom, internal commands. Loading truly incompatible
+sectioning packages would automatically disable \KOMAScript{} extensions
+and transfer the responsibility for the sectioning commands entirely
+to these packages. On the other hand, extra effort would be required
+to maintain compatibility with other packages.
+
+Package authors can use these commands as they would use the corresponding
+\LaTeX{} kernel commands and therefore gain access to the additional features
+of \KOMAScript. However, these commands should not be redefined, as they may
changed at any time, and then this redefinition could compromise
-\KOMAScript{}'s functionality.
-
-\KOMAScript{} itself uses \Macro{SecDef} and \Macro{scr@startsection} instead
-of \Macro{secdef} and \Macro{@startsection}, for example to define sectioning
-commands with \DescRef{\LabelBase.cmd.DeclareSectionCommand}. So later
-redefinitions of \Macro{secdef} or \Macro{@startsection} will not influence
-the sectioning commands of \KOMAScript.
-
-As an alternative to redefining such commands, \KOMAScript{} offers the
-possibility to add additional \PName{code} at several points in
-\KOMAScript{}'s own replacements. The \PName{code} of all calls to
-\Macro{At@startsection}\important{\Macro{At@startsection}\\
- \Macro{Before@sect}\\
- \Macro{Before@sect}}, \Macro{Before@sect} and \Macro{Before@sect} is
-collected separately for each command. There is no provision for removing
-\PName{code} once it has been inserted.
-
-The \PName{code} of the \Macro{At@startsection}%
- \important{\Macro{At@startsection}\\
- \Macro{scr@startsection}} macro is used in the \Macro{scr@startsection}
-command immediately after evaluating \PName{beforeskip} and calculating the
-resulting \Length{@tempskipa} but before adding the vertical skip itself. So
-you can still change the value of \Length{@tempskipa}.
-
-The \PName{code} of \Macro{Before@sect} or \Macro{Before@ssect} is executed
-within \Macro{scr@startsection} just before calling \Macro{@sect} or
-\Macro{@ssect}, respectively. At this point, the vertical skip of
-\Length{@tempskipa} has already been added using \Macro{addvspace}.
-
-These three commands, \Macro{At@startsection}, \Macro{Before@sect}, and
-\Macro{Before@ssect}, are designed as an interface for package authors and
-released for them to use.%
-%
+\KOMAScript{}'s functionality. The meaning of the parameters for these
+commands can be found in the \LaTeX{} kernel manual \cite{latex:source2e}.
+As\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} an alternative to redefining such commands, \KOMAScript{}
+offers the hooks described previously.%
\EndIndexGroup
-% \subsection{Appendix}
+\begin{Explain}
+ \begin{Declaration}
+ \Macro{At@startsection}\Parameter{code}
+ \Macro{Before@ssect}\Parameter{code}
+ \Macro{Before@sect}\Parameter{code}
+ \end{Declaration}
+ Until\ChangedAt[2019/01]{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}} \KOMAScript~v3.26b, these commands were available as an
+ alternative to redefine \DescRef{\LabelBase.cmd.scr@startsection} or
+ \DescRef{\LabelBase.cmd.SecDef}. Since\textnote{outdated \KOMAScript{}
+ command} \KOMAScript~v3.27, these commands are deprecated.
+
+ Internally \Macro{At@startsection} is now implemented with the
+ \DescRef{\LabelBase.dohook.heading/postinit} hook. \Macro{Before@ssect} is
+ implemented with \DescRef{\LabelBase.dohook.heading/branch/star}, and
+ \Macro{Before@sect} uses
+ \DescRef{\LabelBase.dohook.heading/branch/nostar}. The \PName{code} is added
+ using \DescRef{scrbase.cmd.AddtoDoHook}. There are no provisions to remove
+ this code once it has been added.%
+ \EndIndexGroup
+\end{Explain}
+
+% \section{Appendix}
% \seclabel{appendix}
@@ -1671,8 +1798,12 @@ realising it.
\EndIndexGroup
-% \subsection{Literaturverzeichnis}
-% \seclabel{bibliography}
+\section{Bibliography}
+\seclabel{bibliography}
+
+The information in this section is less important if you use packages like
+\Package{biblatex}. In that case, the extensive features of such packages
+will supersede the extensions of the \KOMAScript{} classes described here.
\begin{Declaration}
\Macro{newbibstyle}\OParameter{parent style}\Parameter{name}%^^A
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex
index b20b18726b..881f61b7a1 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex
@@ -46,13 +46,13 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle.tex}
- [$Date: 2019-01-14 14:29:39 +0100 (Mon, 14 Jan 2019) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)]
\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and
Krickette Murabayashi\and Jana Schubert\and Jens H\"uhne\and Karl Hagen}
-% Date of the translated German file: 2019-01-14
+% Date of the translated German file: 2019-10-09
\chapter{The Main Classes: \Class{scrbook}, \Class{scrreprt}, and
\Class{scrartcl}}
@@ -279,7 +279,7 @@ tables and figures, after the table of contents (see
\DescRef{maincls-experts.cmd.DeclareNewSectionCommand},
\DescRef{maincls-experts.cmd.RedeclareSectionCommand}, and
\DescRef{maincls-experts.cmd.ProvideSectionCommand} can also affect the
- table of contents. See \autoref{sec:maincls-experts.experts},
+ table of contents. See \autoref{sec:maincls-experts.sections},
\DescPageRef{maincls-experts.cmd.DeclareSectionCommand}.%
\else%
In addition to the options documented in this section, the
@@ -299,7 +299,7 @@ tables and figures, after the table of contents (see
\IndexCmd{DeclareNewSectionCommand} and
\DescRef{maincls-experts.cmd.RedeclareSectionCommand}%
\IndexCmd{RedeclareSectionCommand} documented in
- \autoref{sec:maincls-experts.experts},
+ \autoref{sec:maincls-experts.sections},
\DescPageRef{maincls-experts.cmd.DeclareSectionCommand} can also affect the
table of contents.%
\fi
@@ -1002,9 +1002,10 @@ You can redefine the page styles with the \Macro{renewcommand} macro.
example. Of course, you can also use a user-defined page style.
Suppose you have defined your own page style for initial chapter pages with
- the \hyperref[cha:scrlayer]{\Package{scrlayer}} (see \autoref{cha:scrlayer})
- or the \hyperref[cha:scrlayer-scrpage-experts]{\Package{scrlayer-scrpage}}
- package (see \autoref{cha:scrlayer-scrpage-experts}). You have given this
+ the \hyperref[cha:scrlayer]{\Package{scrlayer}} (see
+ \autoref{sec:scrlayer.pagestyles}) or the
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} package (see
+ \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs}). You have given this
page style the fitting name of \PValue{chapter}. To actually use this style,
you must redefine \Macro{chapterpagestyle} in this way:
\begin{lstcode}
@@ -1414,7 +1415,7 @@ You can find additional settings for chapter headings in the explanation for
\DescRef{maincls-experts.cmd.RedeclareSectionCommand} and the commands
\DescRef{maincls-experts.cmd.chapterlineswithprefixformat} and
\DescRef{maincls-experts.cmd.chapterlinesformat} in
-\autoref{sec:maincls-experts.experts}, \autoref{part:forExperts}.%
+\autoref{sec:maincls-experts.sections}, \autoref{part:forExperts}.%
\EndIndexGroup
@@ -1782,25 +1783,28 @@ extended interpretation of the optional argument \PName{short version}, which
is not active by default.
The \ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} extended interpretation of the optional argument
-checks to see if there is an equals sign in \PName{short version}. If so,
-the optional argument will be interpreted as an \PName{option list}.
+ \Class{scrartcl}} extended interpretation of the optional argument checks to
+see if there is an equals sign in \PName{short version}. If so, the optional
+argument will be interpreted as an \PName{option list}.
Three options\,---\,\OptionVName{head}{running head}\important{\Option{head}\\
\Option{tocentry}\\
- \Option{reference}}, \OptionVName{tocentry}{table of contents entry}, and
+ \Option{reference}\\
+ \Option{nonumber}}, \OptionVName{tocentry}{table of contents entry},
\OptionVName{reference}{reference title}%
-\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-\,---\,are supported with this format. To use commas or equals signs
-within the values of those options, you must enclose them in braces.
+\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}},
+and \OptionVName{nonumber}{simple switch}\ChangedAt{v3.27}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}\,---\,are supported with this
+format. To use commas or equals signs within the values of those options, you
+must enclose them in braces.
Please\textnote{Attention!} note that this mechanism only works as long as
\KOMAScript{} controls the sectioning commands. If you use package that
redefines the \KOMAScript{}'s or the internal \LaTeX{} kernel's sectioning
commands, \KOMAScript{} can no longer provide this extended mechanism. This
-also applies to a \KOMAScript{} that is always active: sectioning commands
-with no heading text\textnote{empty headings} do not create entries in the
-table of contents. If you really want an entry with empty heading text, you
-can use an invisible entry like \lstinline|\mbox{}|.
+also applies to a \KOMAScript{} extension that is always active: sectioning
+commands with no heading text\textnote{empty headings} do not create entries
+in the table of contents. If you really want an entry with empty heading text,
+you can use an invisible entry like \lstinline|\mbox{}|.
\begin{Example}
Suppose you have a document with very long chapter headings. These headings
@@ -1888,6 +1892,18 @@ option, or setting the title of a table-of-contents entry with the
performance is poor compared to the other two, and it is not fully compatible
with \Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}}.
+You can deactivate the numbering using
+\OptionValue{nonumber}{true}\important{\Option{nonumber}}%
+\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
+in the extended optional argument. In contrast to the
+\hyperref[desc:maincls.cmd.part*]{starred versions of the sectioning commands}
+explained below, the titles will still be added to the table of contents and,
+if applicable, used for the running head. For \Macro{part}, \Macro{chapter},
+and \Macro{section}, using \OptionValue{nonumber}{true} this essentially
+corresponds to the \DescRef{\LabelBase.cmd.addpart},
+\DescRef{\LabelBase.cmd.addchap}, and \DescRef{\LabelBase.cmd.addsec}
+commands, which are explained on \DescPageRef{\LabelBase.cmd.addpart}.
+
The part-level title\important{\Macro{part}} (\Macro{part}) differs from other
sectioning levels by being numbered independently. This means that the chapter
level (in \Class{scrbook} or \Class{scrreprt}), or the section level (in
@@ -2160,7 +2176,10 @@ similar to the standard commands \DescRef{\LabelBase.cmd.part}\IndexCmd{part}%
\DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} and
\DescRef{\LabelBase.cmd.section}\IndexCmd{section} except that they are
unnumbered. They thus produce both a running head and an entry in the table of
-contents.
+contents which take into account the \DescRef{\LabelBase.option.headings}%
+\important{\DescRef{\LabelBase.option.headings}} option settings, especially
+the handling of the optional argument. However, enabling or disabling the
+\Option{nonumber} switch will have no effect.
The starred variants \Macro{addchap*} and \Macro{addsec*} are similar to the
standard commands \DescRef{\LabelBase.cmd.chapter*} and
@@ -2553,7 +2572,7 @@ as well as
\DescRef{maincls-experts.cmd.sectionlinesformat}\IndexCmd{sectionlinesformat}
and its \DescRef{maincls-experts.cmd.sectioncatchphraseformat}%
\IndexCmd{sectioncatchphraseformat} format in
-\autoref{sec:maincls-experts.experts}, starting from
+\autoref{sec:maincls-experts.sections}, starting from
\DescPageRef{maincls-experts.cmd.partlineswithprefixformat}.%
\EndIndexGroup
@@ -2837,7 +2856,7 @@ heading will not be moved down. You are therefore responsible for ensuring
that the \PName{preamble} is not too large and that the space above the
heading is sufficient. See also the \Option{beforeskip} setting for
\DescRef{maincls-experts.cmd.RedeclareSectionCommand} in
-\autoref{sec:maincls-experts.experts},
+\autoref{sec:maincls-experts.sections},
\autoref{tab:maincls-experts.declarechapterstyle.keys},
\autopageref{tab:maincls-experts.declarechapterstyle.keys}.
%
@@ -4355,7 +4374,7 @@ modern and open kind of bibliography. The name comes from the fact that the
bibliography entries appear more structured. They are less compact and seem
more relaxed or open. Information about defining new bibliography styles can
be found in the description of the \DescRef{maincls-experts.cmd.newbibstyle}
-command in \autoref{sec:maincls-experts.experts},
+command in \autoref{sec:maincls-experts.bibliography},
\DescPageRef{maincls-experts.cmd.newbibstyle}.
In addition to the formatting style, you can select one more feature using
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex b/macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex
index 7acd9f2bf7..e5cd194493 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrdatetime.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrdatetime.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ============================================================================
\KOMAProvidesFile{scrdatetime.tex}
- [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrdate, scrtime)]
\translator{Markus Kohm\and Gernot Hassenpflug\and Karl Hagen}
-% Date of the translated German file: 2018-02-05
+% Date of the translated German file: 2019-10-10
\chapter{The Day of the Week with \Package{scrdate}}
\labelbase{scrdate}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrextend.tex b/macros/latex/contrib/koma-script/source-doc/english/scrextend.tex
index 5504ee4b0d..28ba228390 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrextend.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrextend.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2018
+% Copyright (c) Markus Kohm, 2002-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrextend.tex
-% Copyright (c) Markus Kohm, 2002-2018
+% Copyright (c) Markus Kohm, 2002-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{scrextend.tex}
- [$Date: 2018-04-09 10:14:11 +0200 (Mon, 09 Apr 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script package scrextend]
\translator{Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-01-24
+% Date of the translated German file: 2019-10-10
\chapter[{\KOMAScript{} Features for Other Classes with \Package{scrextend}}]
{Using Basic Features of the \KOMAScript{} Classes in Other Classes with the
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex b/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex
index a7dfac605c..5a7fc200a1 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrhack.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,12 @@
% ============================================================================
\KOMAProvidesFile{scrhack.tex}
- [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrhack)]
\translator{Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-02-05
+% Date of the translated German file: 2019-10-09
+
\chapter{Improving Third-Party Packages with \Package{scrhack}}
\labelbase{scrhack}
@@ -213,7 +214,7 @@ package also uses \Package{lscape}, so \Package{scrhack} affects the
functioning of this package too.%
-\section{Special Case \Package{nomencl}}
+\section{Special Case for \Package{nomencl}}
\label{sec:nomencl}
The\ChangedAt{v3.23}{\Package{scrhack}} hack for the
@@ -251,6 +252,47 @@ The\textnote{Achtung!} setting of the option when \Package{nomencl} is loaded
is crucial! Later changes to the option with
\DescRef{\LabelBase.cmd.KOMAoption} or \DescRef{\LabelBase.cmd.KOMAoptions}
have no influence and will lead to a corresponding warning.%
+
+
+\section{Special Case for Section Headings}
+\seclabel{sections}
+
+Various\ChangedAt{v3.27}{\Package{scrhack}} packages assume that the
+sectioning commands are defined in a specific way, corresponding to the
+definitions in the standard classes. But for some classes this is not the
+case. For example, the \KOMAScript{} classes use a completely different
+implementation to provide many additional features. But this can cause
+problems for packages that depend on the definition of the standard classes.
+As of version~3.27, \Package{scrhack} offers the option to force the
+sectioning commands \DescRef{maincls.cmd.part}\IndexCmd{part},
+\DescRef{maincls.cmd.chapter}\IndexCmd{chapter},
+\DescRef{maincls.cmd.section}\IndexCmd{section},
+\DescRef{maincls.cmd.subsection}\IndexCmd{subsection},
+\DescRef{maincls.cmd.subsubsection}\IndexCmd{subsubsection},
+\DescRef{maincls.cmd.paragraph}\IndexCmd{paragraph}, and
+\DescRef{maincls.cmd.subparagraph}\IndexCmd{subparagraph} to be compatible
+with those in the standard classes. When \DescRef{maincls.cmd.chapter} is
+defined, the definitions are based on those in \Class{book}. When
+\DescRef{maincls.cmd.chapter} is undefined, the definitions of
+\Class{article} are used.
+
+If you are using a \KOMAScript{} class, several features of these classes are
+also deactivated as side effect. For example, the commands to define or
+modify sectioning commands described in
+\autoref{sec:maincls-experts.sections} or option
+\DescRef{maincls.option.headings} are no longer available, and commands like
+\DescRef{maincls.cmd.partformat} have different defaults.
+
+Because this hack has the potential to do more harm than good, it issues
+several warnings. Also it is not activated simply by loading the
+\Package{scrhack} package. If you want to use it, you must explicitly activate
+it with the \Option{standardsections}\IndexOption[indexmain]{standardsections}
+option when you load the package. Late activation or deactivation is not
+supported.
+
+Since there are often less invasive solutions to fix the problem of package
+incompatibilities, using this hack is not recommended. It is provided only as
+a last resort for emergencies.%
\EndIndexGroup
\endinput
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrjura.tex b/macros/latex/contrib/koma-script/source-doc/english/scrjura.tex
index fb782ca3dc..34d9d0d4a8 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrjura.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrjura.tex
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{scrjura.tex}%
- [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-10 09:25:44 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrjura)]
\translator{Alexander Willand\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-07-20
+% Date of the translated German file: 2019-10-09
\chapter{Support for the Law Office with \Package{scrjura}}
\labelbase{scrjura}
@@ -84,6 +84,14 @@ has to be loaded after \Package{scrjura} as usual.
The headings of clauses can also be added automatically to the table of
contents, if desired.
+% TODO: Fix new translation
+Therefore\ChangedAt{v3.27}{\Package{scrjura}} the package uses
+\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry}
+(see \autoref{sec:tocbasic.tocstyle},
+\DescPageRef{tocbasic.cmd.DeclareTOCStyleEntry}) to define an \PName{entry
+ level} named \PValue{cpar}.
+% :ODOT
+
\begin{Declaration}
\OptionVName{juratotoc}{simple switch}%
@@ -94,9 +102,9 @@ Clauses\Index{clause} are shown in the table of contents only if their
\DescRef{maincls.counter.tocdepth}%
\important{\DescRef{maincls.counter.tocdepth}}\IndexCounter{tocdepth} counter
(see \autoref{sec:maincls.toc}, \DescPageRef{maincls.counter.tocdepth}). By
-default, the \PName{level number} is 10000, which is also used if the option
-is switched off with the \PName{simple
-switch}\important{\OptionValue{juratotoc}{false}} (see
+default, the \PName{level number} is \Length{maxdimen}, which is also used if
+the option is switched off with the \PName{simple
+ switch}\important{\OptionValue{juratotoc}{false}} (see
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}). Because the
\DescRef{maincls.counter.tocdepth} counter usually has a one-digit value,
clause entries are therefore not normally displayed in the table of contents.
@@ -105,7 +113,15 @@ If you switch on the option using the \PName{simple switch}%
\important{\OptionValue{juratotoc}{true}}, the \PName{level number} 2 is used
so that clauses are shown in the table of contents on the same level as
subsections. For the default setting of \DescRef{maincls.counter.tocdepth},
-clauses are then shown in all \KOMAScript{} classes.%
+clauses are then shown in all \KOMAScript{} classes.
+
+% TODO: Fix new translation
+Internally\ChangedAt{v3.27}{\Package{scrjura}} usage of this option results in
+a call of
+\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry}
+with the \PName{style} \PValue{default} and a corresponding value of
+\Option{level} in the \PName{option list}.%
+% :ODOT
\EndIndexGroup
@@ -116,7 +132,15 @@ clauses are then shown in all \KOMAScript{} classes.%
These two options can be used to determine the indentation for the clause
entries in the table of contents as well as the space reserved for the numbers
there. The defaults are the same as for subsection entries in
-\Class{scrartcl}.%
+\Class{scrartcl}.
+
+% TODO: Fix new translation
+Internally\ChangedAt{v3.27}{\Package{scrjura}} usage of these options results
+in calls of
+\DescRef{tocbasic.cmd.DeclareTOCStyleEntry}\IndexCmd{DeclareTOCStyleEntry}
+with the \PName{style} \PValue{default} and \OptionVName{indent}{indent}
+respectively \OptionVName{numwidth}{number width} in the \PName{option list}.%
+% :ODOT
\EndIndexGroup
@@ -188,7 +212,7 @@ other environments declared with
\end{Declaration}
These are the most important commands inside of a contract. Without using any
additional \PName{options}, \Macro{Clause} creates the heading of a clause,
-which consists of the sign »\S«, followed by its number. In contrast,
+which consists of the sign ``\S'', followed by its number. In contrast,
\Macro{SubClause} creates the heading of a clause with the last number used by
\Macro{Clause} and adds a lower-case letter. \Macro{SubClause} is mainly
intended for cases where an act or a contract is amended and not only are
@@ -747,10 +771,10 @@ You can find examples of results of the basic commands in
\toprule
Command & Example output \\
\midrule
- \DescRef{\LabelBase.cmd.refL}\Parameter{label} & § 1 paragraph 1 sentence 1 \\
- \DescRef{\LabelBase.cmd.refS}\Parameter{label} & § 1 par. 1 sent. 1 \\
- \DescRef{\LabelBase.cmd.refN}\Parameter{label} & § 1 I 1. \\
- \DescRef{\LabelBase.cmd.refClause}\Parameter{label} & § 1 \\
+ \DescRef{\LabelBase.cmd.refL}\Parameter{label} & \S{} 1 paragraph 1 sentence 1 \\
+ \DescRef{\LabelBase.cmd.refS}\Parameter{label} & \S{} 1 par. 1 sent. 1 \\
+ \DescRef{\LabelBase.cmd.refN}\Parameter{label} & \S{} 1 I 1. \\
+ \DescRef{\LabelBase.cmd.refClause}\Parameter{label} & \S{} 1 \\
\DescRef{\LabelBase.cmd.refClauseN}\Parameter{label} & 1 \\
\DescRef{\LabelBase.cmd.refParL}\Parameter{label} & paragraph 1 \\
\DescRef{\LabelBase.cmd.refParS}\Parameter{label} & par. 1 \\
@@ -817,7 +841,7 @@ supported \PName{options}.
\PName{commands} used as its default setting. If the element was
previously defined as an alias (see
\DescRef{maincls-experts.cmd.aliaskomafont} in
- \autoref{sec:maincls-experts.experts},
+ \autoref{sec:maincls-experts.fonts},
\DescPageRef{maincls-experts.cmd.aliaskomafont}), it will become an
independent element instead. If it has already been defined as an
independent element, \DescRef{\LabelBase.cmd.setkomafont} is used to set
@@ -1158,7 +1182,6 @@ detailed user feedback.%
%%% Local Variables:
%%% mode: latex
%%% mode: flyspell
-%%% coding: iso-latin-1
%%% ispell-local-dictionary: "en_GB"
%%% TeX-PDF-mode: t
%%% TeX-master: "guide.tex"
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex
index 47cc29a8aa..20651e4003 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-notecolumn.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-notecolumn.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -51,7 +51,7 @@
\translator{Markus Kohm\and Arndt Schubert\and Karl Hagen}
-% Date of the translated German file: 2018-02-05
+% Date of the translated German file: 2019-10-09
\chapter{Note Columns with \Package{scrlayer-notecolumn}}
\labelbase{scrlayer-notecolumn}
@@ -482,7 +482,29 @@ commands mentioned in the example above does not occur with the starred
variant\important{\Macro{makenote*}}. It uses \Macro{detokenize} to prevent
the expansion of commands. But this also means that you should not use
commands in the \PName{note} that change their definition within the
-document.%
+document.
+
+Unfortunately, both commands have two other known
+limitations\textnote{Attention!}. The first issue is related to colours using
+\Package{color}\IndexPackage{color} or \Package{xcolor}\IndexPackage{xcolor}
+within the note columns. To make such colour changes possible each note column
+requires its own colour management using so-called \emph{colour stacks}.
+Because the package was designed only as a \emph{proof of concept} and because
+\XeTeX{} does not support multiple colour stacks, \XeTeX{} colour switching is
+restricted to the attributes of the font element
+\FontElement{notecolumn.\PName{note column name}}, a limitation which
+eliminates the time and effort required to implement custom colour management.
+
+The second issue is of a more conceptual nature. The content of the auxiliary
+file that contains the note-column information is read while processing the
+page header. This has consequences in particular if the read occurs while
+an environment like \Environment{verbatim} is active. In this case, the
+\Macro{catcode} settings of this environment would be active while reading the
+auxiliary file. This will inevitably lead to errors in processing and output.
+To attenuate this risk, the \Macro{catcodes} of the characters from
+\Macro{dospecials}\IndexCmd{dospecials} are stored during
+\Macro{begin}\PParameter{document} and explicitly restored when reading from
+the auxiliary file.%
\EndIndexGroup
@@ -696,7 +718,6 @@ changed from blue to grey.}
%%% Local Variables:
%%% mode: latex
%%% mode: flyspell
-%%% coding: iso-latin-1
%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
%%% End:
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex
index c9cdc98c8a..b5684a766e 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-scrpage-experts.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-scrpage-experts.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -44,11 +44,11 @@
% ============================================================================
\KOMAProvidesFile{scrlayer-scrpage-experts.tex}%
- [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrlayer-scrpage-experts)]
\translator{Markus Kohm\and Karl Hagen}
-% Date version of the translated file: 2018-01-31
+% Date version of the translated file: 2019-10-09
\chapter[{Additional Features of \Package{scrlayer-scrpage}}]
{Additional Features\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} with
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex
index d3c50bfef0..cffeeffd9b 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-scrpage.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-scrpage.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-scrpage.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -44,11 +44,11 @@
% ============================================================================
\KOMAProvidesFile{scrlayer-scrpage.tex}%
- [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrlayer-scrpage)]
\translator{Markus Kohm\and Jana Schubert\and Jens H\"uhne\and Karl Hagen}
-% Date version of the translated file: 2018-02-13
+% Date version of the translated file: 2019-10-09
\chapter[{Headers and Footers with \Package{scrlayer-scrpage}}]
{Headers\ChangedAt{v3.12}{\Package{scrlayer-scrpage}} and
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex
index 5488fe2cb0..e56824c156 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,12 +46,12 @@
% ============================================================================
\KOMAProvidesFile{scrlayer.tex}
- [$Date: 2018-12-15 15:01:34 +0100 (Sat, 15 Dec 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter:scrlayer)]
\translator{Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-12-15
+% Date of the translated German file: 2019-10-09
\chapter[{Defining Layers and Page Styles with \Package{scrlayer}}]
{Defining\ChangedAt{v3.12}{\Package{scrlayer}} Layers and Page Styles with
@@ -606,6 +606,16 @@ be changed. Applying either command to a previously undefined \PName{layer
\begin{Declaration}
+ \Macro{ModifyLayers}\OParameter{option list}\Parameter{layer list}
+\end{Declaration}
+This\ChangedAt{v3.26}{\Package{scrlayer}} command executes
+\DescRef{\LabelBase.cmd.ModifyLayer} with the given \PName{option list} for
+all layers of the comma-separated layer list. Therefore the option can be used
+to change attributes of several layers simultaneously.%
+\EndIndexGroup
+
+
+\begin{Declaration}
\Macro{layerhalign}%
\Macro{layervalign}%
\Macro{layerxoffset}%
@@ -860,16 +870,14 @@ first time. Therefore, when defining an end-user interface, you may find it
useful to set the current page style to a default with an implicit
\DescRef{maincls.cmd.pagestyle} statement.
-% Todo: New translation by Markus Kohm (please fix it!)
-For page-style aliases activated using \DescRef{maincls.cmd.pagestyle}
-\Macro{currentpagestyle} does not show the alternative name but the name of
+If \DescRef{maincls.cmd.pagestyle} activates an alias page style,
+\Macro{currentpagestyle} shows not the alternative name but the name of
the real page style. You\ChangedAt{v3.16}{\Package{scrlayer}} can get the
alternative name using \Macro{toplevelpagestyle}. However, it is not
-recommended to define page styles, that have different results depending on
+recommended to define page styles that produce different results depending on
\Macro{toplevelpagestyle}, e.\,g., using \DescRef{scrbase.cmd.ifstr}. If you
-would activate such a page style using \DescRef{maincls.cmd.thispagestyle} you
-could get the wrong result.%
-% End of new translation.
+were to activate such a page style using \DescRef{maincls.cmd.thispagestyle}
+you could get the wrong result.%
\EndIndexGroup
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex
index a01a4a0035..1796a163c4 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrlfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlfile.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ============================================================================
\KOMAProvidesFile{scrlfile.tex}
- [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrlfile)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-02-15
+% Date of the translated German file: 2019-10-10
\chapter{Controlling Package Dependencies with \Package{scrlfile}}
\labelbase{scrlfile}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex
index ffb397b6d2..722183a7bd 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrlttr2-experts.tex
@@ -46,14 +46,14 @@
% ============================================================================
\KOMAProvidesFile{scrlttr2-experts.tex}
- [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrlttr2 for experts)]
\translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe
Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm\and
Karl Hagen}
-% Date of the translated German file: 2018-07-20
+% Date of the translated German file: 2019-10-09
\chapter{Additional Information about the \Class{scrlttr2} Class and the
\Package{scrletter} Package}
@@ -400,6 +400,22 @@ exists for package authors.%
\begin{Declaration}
+ \Macro{Ifplength}\Parameter{pseudo-length}%
+ \Parameter{then-code}\Parameter{else-code}
+\end{Declaration}
+This\ChangedAt{v3.27}{\Class{scrlttr2}\and \Class{scrletter}} command can be
+used to determine whether a \PName{pseudo-length} has been defined. The
+\PName{then-code} is executed if the \PName{pseudo-length} is defined and not
+\Macro{relax}. Otherwise the \PName{else-code} is executed.
+
+% Note: In the English manual this information is not \iffree{}{...}!
+\BeginIndex{Cmd}{if@plength}%
+For reasons of consistency only, the internal command \Macro{if@plength},
+with the identical meaning, exists for the use of package authors.%
+\EndIndexGroup
+
+
+\begin{Declaration}
\Macro{setplength}%
\OParameter{factor}\Parameter{pseudo-length}\Parameter{value}%
\Macro{addtoplength}%
@@ -1280,6 +1296,36 @@ it is robust enough to be used as the argument of
example.%
%
\EndIndexGroup
+
+
+\begin{Declaration}
+ \Macro{foreachkomavar}\Parameter{list of variables}\Parameter{command}
+ \Macro{foreachnonemptykomavar}\Parameter{list of variables}\Parameter{command}
+ \Macro{foreachemptykomavar}\Parameter{list of variables}\Parameter{command}
+ \Macro{foreachkomavarifempty}\Parameter{list of variables}
+ \Parameter{then-code}\Parameter{else-code}
+\end{Declaration}
+The\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}}
+\Macro{foreachkomavar} command executes the specified \PName{command} for each
+variable in the comma-separated \PName{list of variables}. The name of each
+variable is added as parameter to the \PName{command}.%
+
+The \Macro{foreachnonemptykomavar} command does the same but only for those
+variables that are not empty in sense of
+\DescRef{\LabelBase.cmd.ifkomavarempty}. Empty variables in the \PName{list of
+ variables} are ignored.
+
+By contrast, the \Macro{foreachemptykomavar} command executes the
+\PName{command} only for variables that are empty in sense of
+\DescRef{\LabelBase.cmd.ifkomavarempty}. Accordingly, non-empty variables are
+ignored.
+
+The \Macro{foreachkomavarifempty} command is a kind of combination of the two
+previously described commands. It executes the \PName{then-command} only for
+those variables in the \PName{list of variables} that are empty, and the
+\PName{else-command} for the non empty variables. As with \PName{command}, the
+name of each variable is added as a parameter in both cases.%
+\EndIndexGroup
%
\EndIndexGroup
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex
index e63f59c2ab..81923f666c 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrlttr2.tex
@@ -46,14 +46,14 @@
% ============================================================================
\KOMAProvidesFile{scrlttr2.tex}%
- [$Date: 2019-01-15 08:39:58 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-10 10:25:29 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrlttr2)]
\translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe
Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm\and
Karl Hagen}
-% Date of the translated German file: 2018-04-26
+% Date of the translated German file: 2019-10-10
\chapter{Letters with the \Class{scrlttr2} Class or the \Package{scrletter}
Package}
@@ -483,9 +483,10 @@ printing. Since letters are not usually bound, each page of a letter will be
viewed on its own. This is also true even if both the letter is printed on
both sides of the paper. Vertical adjustment usually does not matter for
letters either. If you nevertheless need it, or want to understand what it is,
-please refer to the commands \Macro{raggedbottom} and \Macro{flushbottom}
-explained in \autoref{sec:maincls.typearea} on
-\DescPageRef{maincls.cmd.flushbottom}.%
+please refer to the commands
+\DescRef{maincls.cmd.raggedbottom}\IndexCmd{raggedbottom} and
+\DescRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom} explained in
+\autoref{sec:maincls.typearea} on \DescPageRef{maincls.cmd.flushbottom}.%
%
\EndIndexGroup
@@ -663,7 +664,12 @@ for the standard letter class.
description of the \DescRef{\LabelBase.cmd.opening} command on
\DescPageRef{\LabelBase.cmd.opening}.
\end{Example}
-%
+
+Letters\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} are always
+printed in single-column mode and without vertical adjustment. You can use
+\DescRef{maincls.cmd.flushbottom}, explained in \autoref{sec:maincls.typearea}
+on \DescPageRef{maincls.cmd.flushbottom}\IndexCmd{flushbottom}, together with
+\DescRef{\LabelBase.cmd.AtBeginLetter} to force a vertical adjustment.%
\EndIndexGroup
@@ -1300,7 +1306,7 @@ definitely set the variables for return address (see
\EndIndexGroup
\begin{Declaration}
- \OptionVName{symbolicnames}{simple switch}%
+ \OptionVName{symbolicnames}{value}%
\OptionVName{fromphone}{simple switch}%
\OptionVName{frommobilephone}{simple switch}%
\OptionVName{fromfax}{simple switch}%
@@ -1318,12 +1324,13 @@ definitely set the variables for return address (see
\Variable{urlseparator}%
\end{Declaration}
\BeginIndex{}{letterhead}%
-\BeginIndex{}{letter>header}
-You can use the five options \Option{fromphone}, \Option{frommobilephone}\ChangedAt{v3.12}{\Class{scrlttr2}}, \Option{fromfax},
+\BeginIndex{}{letter>header}%
+You can use the five options \Option{fromphone},
+\Option{frommobilephone}\ChangedAt{v3.12}{\Class{scrlttr2}}, \Option{fromfax},
\Option{fromemail}, and \Option{fromurl} to specify whether to include the
phone number\Index{telephone}\Index{phone},
mobile\ChangedAt{v3.12}{\Class{scrlttr2}} phone number\Index{mobile
-phone}\Index{cell phone}\Index{cellphone}, fax number\Index{fax}, e-mail
+ phone}\Index{cell phone}\Index{cellphone}, fax number\Index{fax}, e-mail
address\Index{e-mail}, or URL should be as part of the sender's
information. You can assign any standard value for simple switches from
\autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} to these
@@ -1338,18 +1345,24 @@ You can\ChangedAt{v3.12}{\Class{scrlttr2}}\important{\Option{symbolicnames}}
change the defaults for describing the variables all at once with the
\Option{symbolicnames} option. This option understands the values for simple
switches found in \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}. Activating the option replaces the
-descriptions from the language-dependant labels of
+\autopageref{tab:truefalseswitch}.
+Activating\ChangedAt{v3.27}{\Class{scrlttr2}\and \Package{scrletter}} the
+option corresponds to \PName{value} \PValue{marvosym} and replaces the
+descriptions from the language-dependent labels of
\DescRef{scrlttr2-experts.cmd.emailname},
\DescRef{scrlttr2-experts.cmd.faxname},
\DescRef{scrlttr2-experts.cmd.mobilephonename}, and
\DescRef{scrlttr2-experts.cmd.phonename} with symbols from the
\Package{marvosym}\IndexPackage{marvosym} package. At the same time, the colon
is omitted when defining the separators. In this case, both the description
-and the content of the URL separator will be empty. Note\textnote{Attention!}
-that you have to load the \Package{marvosym} package on your own if you activate
-\Option{symbolicnames} for the first time after
-\Macro{begin}\PParameter{document}.
+and the content of the URL separator will be empty. With
+\OptionValue{symbolicnames}{fontawesome} or
+\OptionValue{symbolicnames}{awesome}, symbols of package
+\Package{fontawesome}\IndexPackage{fontawesome} are used. In this case there
+is also a symbol for the URL. Note\textnote{Attention!} that you may need to
+load the \Package{marvosym} or \Package{fontawesome} package in your document
+preamble if you activate the option for the corresponding package for the
+first time after \Macro{begin}\PParameter{document}.
\begin{table}
\centering
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex b/macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex
index 78253e34e0..a2ae601c86 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrwfile.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrwfile.tex
-% Copyright (c) Markus Kohm, 2010-2018
+% Copyright (c) Markus Kohm, 2010-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrwfile.tex
-% Copyright (c) Markus Kohm, 2010-2018
+% Copyright (c) Markus Kohm, 2010-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,10 +46,10 @@
% ============================================================================
\KOMAProvidesFile{scrwfile.tex}%
- [$Date: 2018-03-27 11:46:14 +0200 (Tue, 27 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrwfile)]
-% Date of the translated German file: 2018-02-15
+% Date of the translated German file: 2019-10-10
\translator{Markus Kohm\and Jana Schubert\and Karl Hagen}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex b/macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex
index 36681ff609..bd34f48969 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/tocbasic.tex
@@ -1,6 +1,6 @@
% ======================================================================
% tocbasic.tex
-% Copyright (c) Markus Kohm, 2002-2018
+% Copyright (c) Markus Kohm, 2002-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% tocbasic.tex
-% Copyright (c) Markus Kohm, 2002-2018
+% Copyright (c) Markus Kohm, 2002-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,10 +46,10 @@
% ======================================================================
\KOMAProvidesFile{tocbasic.tex}
- [$Date: 2018-08-31 09:11:20 +0200 (Fri, 31 Aug 2018) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (package tocbasic)]
-% Date of the translated German file: 2018-08-31
+% Date of the translated German file: 2019-10-09
\translator{Markus Kohm\and Arndt Schubert\and Karl Hagen}
@@ -83,26 +83,26 @@ contents but also for the already mentioned lists of figures and tables.
\label{sec:tocbasic.basics}
The basic commands are primarily used to handle a list of all known file
-extensions\textnote{file extension, content lists} that
-represent a table or list of contents. We call these auxiliary
-files\Index{auxiliary file}\footnote{The term \emph{auxiliary file} here
- refers not to the main \File{aux} file but to the other internal files used
- indirectly via the \File{aux} file, e.\,g. the \File{toc} file, the
- \File{lof} file, or the \File{lot} file.} TOC files\textnote{TOC
- file}\Index[indexmain]{TOC file} regardless of the file extension that is
-actually used. Entries to such files are typically written using
+extensions\textnote{file extension, content lists} that represent a table or
+list of contents. We call these auxiliary files\Index{auxiliary
+ file}\footnote{The term \emph{auxiliary file} here refers not to the main
+ \File{aux} file but to the other internal files used indirectly via the
+ \File{aux} file, e.\,g. the \File{toc} file, the \File{lof} file, or the
+ \File{lot} file.} TOC files\textnote{TOC file}\Index[indexmain]{TOC file}
+regardless of the file extension that is actually used. Entries to such files
+are typically written using
\Macro{addtocontents}\important{\Macro{addtocontents},
-\DescRef{\LabelBase.cmd.addxcontentsline}}, or
+ \DescRef{\LabelBase.cmd.addxcontentsline}}, or
\DescRef{\LabelBase.cmd.addxcontentsline}. There are also commands to perform
actions on all of these file extensions. Additionally, there are commands to
set or unset features for the file associated with a given extension.
Typically an file extension also has an owner\textnote{file owner}. This owner
-may be a class or package, or an identifier that the author of the class or
-package using \Package{tocbasic} has chosen independently. For example,
-\KOMAScript{} uses the owner \texttt{float} for the \File{lof} and \File{lot}
-file extensions that are associated with the list of figures and list of
-tables, respectively. For the table of contents, \KOMAScript{} uses the file
-name of the class.
+may be a class or package, or an identifier of a category that the author of
+the class or package using \Package{tocbasic} has chosen independently. For
+example, \KOMAScript{} uses the category \texttt{float} as owner for the
+\File{lof} and \File{lot} file extensions that are associated with the list of
+figures and list of tables, respectively. For the table of contents,
+\KOMAScript{} uses the file name of the class.
\begin{Declaration}
\Macro{ifattoclist}\Parameter{extension}\Parameter{then code}%
@@ -198,8 +198,8 @@ brackets. An empty argument would also result in an empty owner.
\end{Example}
You can specify any \PName{owner} you want, but it must be unique. For
example, if you were the author of the \Package{float} package, you could
-specify ``\PValue{float}'' instead of ``\PValue{float.sty}'' as the
-\PName{owner}. In this case, the \KOMAScript{}
+specify the category ``\PValue{float}'' instead of ``\PValue{float.sty}'' as
+the \PName{owner}. In this case, the \KOMAScript{}
options\important{\DescRef{maincls.option.listof}}%
\IndexOption{listof~=\PName{setting}} for the list of figures and the list of
tables would also affect your content lists because these lists are already
@@ -383,7 +383,7 @@ If so, it will be used for the entry, passing the \PName{section number} as an
optional argument and \PName{text} as a mandatory argument. You can find an
example of such a command provided by the \KOMAScript{} classes in
\DescRef{maincls-experts.cmd.addparttocentry} (see
-\autoref{sec:maincls-experts.experts},
+\autoref{sec:maincls-experts.toc},
\DescPageRef{maincls-experts.cmd.addparttocentry}). If the corresponding
command is undefined, the internal command
\DescRef{\LabelBase.cmd.tocbasic@addxcontentsline} is used instead. This takes
@@ -623,7 +623,12 @@ to define your own title for the content list with the given file
\PName{extension}. The \PName{definition} of the title can use a single
parameter, \PValue{\#1}. When the command is called inside
\DescRef{\LabelBase.cmd.listoftoc} or \DescRef{\LabelBase.cmd.listofeachtoc},
-that \PValue{\#1} will be replaced by the title of this content list.%
+that \PValue{\#1} will be replaced by the title of this content list.
+
+Obviously, the \PName{definition} is also responsible for the interpretation
+of additional features related to the title. This is especially true
+for the features \PValue{leveldown}, \PValue{numbered} and \PValue{totoc},
+that are be explained next.%
\EndIndexGroup
@@ -636,7 +641,7 @@ You can use these two commands to set and clear features for a TOC file
list} is a comma-separated list of features. The \Package{tocbasic} package
recognizes following features:
\begin{description}
-\item[\texttt{leveldown}] means that the content list's heading is created not
+\item[\PValue{leveldown}] means that the content list's heading is created not
with the highest sectioning level below
\DescRef{maincls.cmd.part}\,---\,\DescRef{maincls.cmd.chapter} if available,
\DescRef{maincls.cmd.section} otherwise\,---\,but with a heading of the next
@@ -648,7 +653,7 @@ recognizes following features:
important{\OptionValueRef{maincls}{listof}{leveldown}}%
\IndexOption{listof~=\textKValue{leveldown}} option for all file extensions
with the owner \PValue{float}.
-\item[\texttt{nobabel}] prevents using the language-switching features of
+\item[\PValue{nobabel}] prevents using the language-switching features of
\Package{babel}\IndexPackage{babel} for the TOC file associated with the
this file \PName{extension}. This feature should be used only for content
lists that are created in a fixed language, which means that changes of the
@@ -660,14 +665,20 @@ recognizes following features:
Note\textnote{Attention!} that you must set this feature before you add a
file extension to the list of known extensions. Changing the feature
afterwards will have no effect.
-\item[\texttt{noparskipfake}] prevents\ChangedAt{v3.17}{\Package{tocbasic}}
+\item[\PValue{noindent}]\ChangedAt{v3.27}{\Package{tocbasic}}%
+ causes all content-list entry styles provided by \KOMAScript{} to ignore
+ the \PValue{indent} attribute (see
+ \autoref{tab:tocbasic.tocstyle.attributes},
+ \autopageref{tab:tocbasic.tocstyle.attributes.indent}) and instead to
+ deactivate the indentation.%
+\item[\PValue{noparskipfake}] prevents\ChangedAt{v3.17}{\Package{tocbasic}}
the insertion of a final \Length{parskip} before switched off paragraph
spacing for content lists. In general, this will cause documents that use
spacing between paragraphs to have less vertical space between the list
heading and first entry than between normal headings and normal text.
Normally, therefore, you will obtain a more uniform formatting without this
feature.
-\item[\texttt{noprotrusion}] prevents\ChangedAt{v3.10}{\Package{tocbasic}}
+\item[\PValue{noprotrusion}] prevents\ChangedAt{v3.10}{\Package{tocbasic}}
character protrusion, which allows optical margin alignment, from being
disabled in the content lists. By default, character protrusion is disabled
when the \Package{microtype}\IndexPackage{microtype} package, or another
@@ -676,7 +687,7 @@ recognizes following features:
must set this feature. Note\textnote{Attention!}, however, that character
protrusion in content lists often results in incorrect results. This is a
known issue with character protrusion.
-\item[\texttt{numbered}] means that the heading for the content list should
+\item[\PValue{numbered}] means that the heading for the content list should
be numbered and included in the table of contents. This feature is evaluated
by the internal heading command. However, if a user-defined heading command
has been created with \DescRef{\LabelBase.cmd.deftocheading}, the person
@@ -686,7 +697,7 @@ recognizes following features:
\important{\OptionValueRef{maincls}{listof}{numbered}}%
\IndexOption{listof~=\textKValue{numbered}} option for all file extensions
with the owner \PValue{float}.
-\item[\texttt{numberline}] \leavevmode\ChangedAt{v3.12}{\Package{tocbasic}}%
+\item[\PValue{numberline}] \leavevmode\ChangedAt{v3.12}{\Package{tocbasic}}%
means that any entries made using \DescRef{\LabelBase.cmd.addxcontentsline}
or \DescRef{\LabelBase.cmd.addxcontentslinetoeachtocfile}, where the
optional argument for the number is missing or empty, will be provided with
@@ -714,7 +725,7 @@ recognizes following features:
\OptionValueRef{maincls}{toc}{nonumberline}%
\important{\OptionValueRef{maincls}{toc}{nonumberline}}%
\IndexOption{toc~=\textKValue{nonumberline}}.
-\item[\texttt{onecolumn}] \leavevmode\ChangedAt{v3.01}{\Package{tocbasic}}%
+\item[\PValue{onecolumn}] \leavevmode\ChangedAt{v3.01}{\Package{tocbasic}}%
means that this content list will automatically use \LaTeX's internal
one-column mode with \Macro{onecolumn}\IndexCmd{onecolumn}.
However\textnote{Attention!}, this applies only if this content list does
@@ -728,7 +739,7 @@ recognizes following features:
these classes. The multicolumn mode of the
\Package{multicol}\IndexPackage{multicol} package is expressly unaffected by
this option.
-\item[\texttt{totoc}] means that the title of content list should be included
+\item[\PValue{totoc}] means that the title of content list should be included
in the table of contents. This feature will be evaluated by the internal
heading command. However, if an user-defined heading command has been
created with \DescRef{\LabelBase.cmd.deftocheading}, the person defining
@@ -740,7 +751,7 @@ recognizes following features:
\end{description}
The \KOMAScript{} classes recognize an additional feature:
\begin{description}
-\item[\texttt{chapteratlist}] ensures that an optional subdivision is added
+\item[\PValue{chapteratlist}] ensures that an optional subdivision is added
to the content list for each new chapter. By default, this subdivision is a
vertical space. See \DescRef{maincls.option.listof}%
\IndexOption{listof}\important{\DescRef{maincls.option.listof}} in
@@ -804,7 +815,7 @@ you define your own heading command using
\BeginIndex{}{table of contents>entry}%
\Index{list of contents|\see{table of contents}}
-Since\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} version~3.20, the
+Since\ChangedAt{v3.20}{\Package{tocbasic}} version~3.20, the
\Package{tocbasic} package has been able not only to configure the tables or
lists of contents and their auxiliary files but also to influence their
entries. To do so, you can define new styles or you can use and configure one
@@ -839,7 +850,7 @@ later in this section}) observe \Counter{tocdepth}.%
\Macro{numberline}\Parameter{entry number}%
\Macro{usetocbasicnumberline}\OParameter{code}
\end{Declaration}
-Although\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the \LaTeX{} kernel
+Although\ChangedAt{v3.20}{\Package{tocbasic}} the \LaTeX{} kernel
already defines a \Macro{numberline} command, the definition is not sufficient
for \Package{tocbasic}. Therefore \Package{tocbasic} defines its own commands
and sets \Macro{numberline} as needed using \Macro{usetocbasicnumberline} for
@@ -1016,18 +1027,19 @@ Currently, \Package{tocbasic} defines the following entry styles:
\PValue{section} and \PValue{subsection} using this style, but add extra
\PName{initial code} to the clones to change their defaults.
- The style supports 16\important{\PValue{level}, \PValue{beforeskip},
+ The style supports 18\important{\PValue{level}, \PValue{beforeskip},
\PValue{breakafternumber}, \PValue{dynnumwidth}, \PValue{entryformat},
\PValue{entrynumberformat}, \PValue{indent}, \PValue{linefill},
\PValue{numsep}, \PValue{numwidth}, \PValue{onstarthigherlevel},
\PValue{onstartlowerlevel}, \PValue{onstartsamelevel},
\PValue{pagenumberbox}, \PValue{pagenumberformat},
- \PValue{raggedentrytext}, \PValue{raggedpagenumber}} additional attributes
- in addition to the default \PValue{level} attribute. The defaults of all
- these attributes depend on the name of the \PName{entry level} and
- correspond to the results of the standard classes. So after loading
- \Package{tocbasic}, you can change the style of the entries in the table of
- contents of the standard classes into \PValue{tocline} using
+ \PValue{pagenumberwidth}, \PValue{raggedentrytext},
+ \PValue{raggedpagenumber}, \PValue{rightindent}} additional attributes in
+ addition to the default \PValue{level} attribute. The defaults of all these
+ attributes depend on the name of the \PName{entry level} and correspond to
+ the results of the standard classes. So after loading \Package{tocbasic},
+ you can change the style of the entries in the table of contents of the
+ standard classes into \PValue{tocline} using
\DescRef{\LabelBase.cmd.DeclareTOCEntryStyle} without this leading directly
to major changes in their appearance. Thus you can precisely change only
those attributes that are necessary for the desired changes. The same
@@ -1190,6 +1202,20 @@ Currently, \Package{tocbasic} defines the following entry styles:
\PValue{tocline} style}
\label{fig:tocbasic.tocline}
\end{figure}
+\item[\PValue{toctext}]\ChangedAt{v3.27}{\Package{tocbasic}}%
+ is a special feature. While all other styles produce one paragraph per
+ entry, this one produces one paragraph for all successive entries of this
+ style. With 13\important{\PValue{afterpar}, \PValue{entryformat},
+ \PValue{entrynumberformat}, \PValue{indent}, \PValue{numsep},
+ \PValue{onendentry}, \PValue{onendlastentry}, \PValue{onstartentry},
+ \PValue{onstartfirstentry}, \PValue{pagenumberformat},
+ \PValue{prepagenumber}, \PValue{raggedright}, \PValue{rightindent}}
+ attributes in addition to the default \PValue{level} attribute, there are
+ almost as many options as for \PValue{tocline}. However, this style
+ depends on the fact that an unfinished paragraph will be concluded at the
+ beginning of the entry for all other styles, as well as at the end of the
+ current content list. So it should never be combined with entries or content
+ lists that are generated outside of \Package{tocbasic}.
\item[\PValue{undottedtocline}] is similar to the style used by the standard
\Class{book} and \Class{report} classes for the \PValue{chapter} entry
level, or by \Class{article} for the \PValue{section} entry level in the
@@ -1246,11 +1272,27 @@ Currently, \Package{tocbasic} defines the following entry styles:
\end{description}
You can find an explanation of the attributes of all styles that
\Package{tocbasic} defines in \autoref{tab:tocbasic.tocstyle.attributes}.
+In\ChangedAt{v3.27}{\Package{tocbasic}} addition to the usual assignment with
+\Option{\PName{key}=\PName{value}}, both commands understand an assignment in
+the form \Option{\PName{key}:=\PName{entry level}} for all options of the
+\KOMAScript{} styles. In this case, the current setting of \PName{key} for the
+\PName{entry level} will be copied. For example, you can copy the current
+indent of the \PValue{figure} level using \OptionValue{indent:}{figure}. For
+options that expect a length or integer value, you can also use
+\Option{\PName{key}+=\PName{value}} to add\PName{value} to the current setting
+of the \PName{key}. To subtract simply, you can use a negative \PName{value}.
+For example, with \OptionValue{indent+}{1cm} you can increase the indent by
+1\Unit{cm}.
+
If\ChangedAt{v3.21}{\Package{tocbasic}} you use these attributes as
options to \DescRef{\LabelBase.cmd.DeclareNewTOC} (see
\DescPageRef{\LabelBase.cmd.DeclareNewTOC}), you must prefix the names of the
-attribute by \PValue{tocentry}, e\,g. \PValue{level} becomes
-\Option{tocentrylevel}. If\ChangedAt{v3.20}{\Package{tocbasic}} use
+attributes with \PValue{tocentry}, e\,g., \PValue{level} becomes
+\Option{tocentrylevel}. The copy operation with \Option{:=} described above is
+also available here. However, addition with \Option{+=} is not currently
+supported.
+
+If\ChangedAt{v3.20}{\Package{tocbasic}} you use
these attributes as options for
\DescRef{maincls-experts.cmd.DeclareSectionCommand}%
\IndexCmd{DeclareSectionCommand}\IndexCmd{DeclareNewSectionCommand}%
@@ -1258,6 +1300,8 @@ these attributes as options for
\DescPageRef{maincls-experts.cmd.DeclareSectionCommand}) and similar commands,
you must prefix the names of the attributes with \PValue{toc}, e\,g.
\PValue{level} becomes \Option{toclevel}.
+At this time, neither the copy operation with \Option{:=} nor the
+addition operation with \Option{+=} is supported.
Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
\Macro{l@\PName{entry level}}.
@@ -1269,6 +1313,13 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
}{%
Attributes of the TOC-entry styles (\emph{continued})%
}%
+ \entry{\OptionVName{afterpar}{code}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ The specified \PName{code} will be executed after the end of the paragraph
+ in which an entry with the \PValue{toctext} style is printed. If several
+ entries have such settings, their code will be executed in the order of
+ the entries.%
+ }%
\entry{\OptionVName{beforeskip}{length}}{%
The vertical distance inserted before an entry of this level in the
\PValue{tocline} style (see \autoref{fig:tocbasic.tocline}). The distance
@@ -1342,12 +1393,19 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
\IndexOption{toc~=\textKValue{numberline}} option, the unnumbered entries
will execute the \PName{command} as well.%
}%
- \entry{\OptionVName{indent}{length}}{%
- The horizontal distance of the entry from the left margin (see
+ \entry{%
+ \OptionVName{indent}{length}%
+ {\phantomsection\label{tab:tocbasic.tocstyle.attributes.indent}}%
+ }{%
+ For\ChangedAt{v3.27}{\Package{tocbasic}} the \PValue{toctext} style, the
+ \PName{length} is the horizontal distance of the paragraph from the left
+ margin. If different entries within the paragraph have different settings,
+ the last one is used. For the remaining styles, the \PName{length} is the
+ horizontal distance of the entry from the left margin (see
\autoref{fig:tocbasic.dottedtocline} and \autoref{fig:tocbasic.tocline}).
-
- For the \PValue{tocline} style, all entry levels whose names start with
- ``\texttt{sub}'' are initialised with the
+
+ For the styles \PValue{tocline} and \PValue{toctext}, all entry levels
+ whose names start with ``\texttt{sub}'' are initialised with the
\PValue{indent}+\PValue{numwidth} of the entry level of the same name
without this prefix. For the \PValue{dottedtocline},
\PValue{undottedtocline}, and \PValue{tocline} styles, the initial values
@@ -1355,7 +1413,11 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
\PValue{figure} and \PValue{table} are compatible with the standard
classes. All other levels do not have an initial value. Therefore you have
to set an explicit value for such levels when they are defined first
- time.%
+ time.
+
+ If the \PValue{noindent} attribute is set for a content list via
+ \DescRef{\LabelBase.cmd.setuptoc}, the entries of all styles provided by
+ \KOMAScript{} enforce the value 0\Unit{pt} to deactivate the indent.%
}%
\entry{\OptionVName{level}{integer}}{%
The numerical value of the \PName{entry level}. Only those entries whose
@@ -1367,15 +1429,15 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
This attribute is mandatory for all styles and will be defined
automatically when the style is declared.
- For the \PValue{tocline} style, all entry levels whose name starts with
- ``\texttt{sub}'' are initialised with the value of the entry level of the
- same name without this prefix plus one. For the \PValue{dottedtocline},
- \PValue{largetocline}, \PValue{tocline}, and \PValue{undottedtocline}
- styles, the entry levels from \PValue{part} to \PValue{subparagraph}, as
- well as \PValue{figure} and \PValue{table}, are initialised to be
- compatible with the standard classes. For all other levels, the
- initialisation is done with the value of \Macro{\PName{entry
- level}numdepth}, if this is defined.%
+ For the \PValue{tocline} and \PValue{toctext} styles, all entry levels
+ whose name starts with ``\texttt{sub}'' are initialised with the value of
+ the entry level of the same name without this prefix plus one. For the
+ \PValue{dottedtocline}, \PValue{largetocline}, \PValue{tocline},
+ \PValue{toctext}, and \PValue{undottedtocline} styles, the entry levels
+ from \PValue{part} to \PValue{subparagraph}, as well as \PValue{figure}
+ and \PValue{table}, are initialised to be compatible with the standard
+ classes. For all other levels, the initialisation is done with the value
+ of \Macro{\PName{entry level}numdepth}, if this is defined.%
}%
\entry{\OptionVName{linefill}{code}}{%
With the \PValue{tocline} style, you can change what is used to fill the
@@ -1395,9 +1457,14 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
\entry{\OptionVName{numsep}{length}}{%
The \PValue{tocline} style tries to ensure a minimum distance of
\PName{length} between the entry number and the entry text. If
- \PValue{dynnumwidth} is active, it will correct the number width to achieve
- this. Otherwise it simply throws a warning, if the condition is not met.
+ \PValue{dynnumwidth} is active, it will correct the number width to
+ achieve this. Otherwise it simply throws a warning if the condition is not
+ met.
+ The\ChangedAt{v3.27}{\Package{tocbasic}} \PValue{toctext} style, on the
+ other hand, always adds a horizontal space of width \PName{length} after
+ the number of the entry.
+
The initial \PName{length} is 0.4\Unit{em}.%
}%
\entry{\OptionVName{numwidth}{length}}{%
@@ -1419,6 +1486,37 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
you must set \PValue{numwidth} explicitly when the entry level is first
used.%
}%
+ \entry{\OptionVName{onendentry}{code}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ The \PName{code} is executed immediately after an entry with the
+ \PValue{toctext} style, if this entry is not the last one of the
+ paragraph. The user must ensure that the \PName{code} does not result in
+ the paragraph ending.
+
+ Note: In reality the \PName{code} is not executed at the end of the entry
+ but before the next entry with style \PValue{toctext}.%
+ }%
+ \entry{\OptionVName{onendlastentry}{code}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ The \PName{code} is executed immediately before the end of the paragraph
+ with an entry in the \PValue{toctext} style, as long as this entry is the
+ last one in the paragraph. The user must ensure that the \PName{code} does
+ not result in the paragraph ending.%
+ }%
+ \entry{\OptionVName{onstartentry}{code}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ The \PName{code} is executed immediately before an entry with the
+ \PValue{toctext} style, unless it is the first one in the paragraph. The
+ user must ensure that the \PName{code} does not result in the paragraph
+ ending.%
+ }%
+ \entry{\OptionVName{onstartfirstentry}{code}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ The \PName{code} is executed immediately before an entry with the
+ \PValue{toctext} style if this entry is the first one of the paragraph. The
+ user must ensure that the \PName{code} does not result in the paragraph
+ ending.%
+ }%
\entry{\OptionVName{onstarthigherlevel}{code}}{%
The \PValue{tocline} style can execute \PName{code} at the start of an
entry, depending on whether the previous entry had numerical level greater
@@ -1482,6 +1580,23 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
all other levels prints the argument in
\Macro{normalfont}\Macro{normalcolor}.%
}%
+ \entry{\OptionVName{pagenumberwidth}{length}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ You can use this attribute to locally change the width of the default box
+ for the page number of an entry with the style \PValue{tocline} from
+ \Macro{@pnumwidth} to the specified \PName{length}. Note that if you
+ change the default page number box with the \Option{pagenumberbox}
+ attribute, the specified \PName{length} will no longer be used
+ automatically.%
+ }%
+ \entry{\OptionVName{prepagenumber}{code}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ The \PValue{toctext} style executes the \PName{code} between the text and
+ the page number of the entry. Usually this is used to add a horizontal
+ space or separator between text and page number.%
+
+ The default is a non-breaking space using \Macro{nonbreakspace}.%
+ }%
\entry{\OptionVName{raggedentrytext}{switch}}{%
The\ChangedAt{v3.21}{\Package{tocbasic}} \PName{switch} is one of the
values for simple switches from \autoref{tab:truefalseswitch},
@@ -1508,16 +1623,26 @@ Finally, using \Macro{DeclareTOCStyleEntry} will define the internal command
\DescRef{\LabelBase.cmd.TOCLineLeaderFill} for the \PValue{linefill}
attribute.%
}%
+ \entry{\OptionVName{raggedright}{switch}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ The \PName{switch} is one of the values for simple switches from
+ \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. If the
+ switch is active for any entry with the \PValue{toctext} style inside the
+ same paragraph, the whole paragraph is printed ragged right.
+ }%
+ \entry{\OptionVName{rightindent}{length}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ You can use this attribute to locally change the right indent for the text
+ of an entry with the \PValue{tocline} style from \Macro{@tocrmarg} to the
+ specified \PName{length}.%
+ }%
\end{desclist}
-% New translation by Markus Kohm (please fix it!):
-\Macro{DeclareTOCStyleEntries}\ChangedAt{v3.26}{\Package{tocbasic}} uses
-\Macro{DeclareTOCStyleEntry} to define not only one \PName{entry level} but
-several entry levels. Each of the entry levels, given by the comma-separated
-\PName{entry level list}, is defined with the same \PName{style} and the
-settings of the given \PName{option list}.%
-% End of new translation.
-%
+While \Macro{DeclareTOCStyleEntry} defines only one \PName{entry level},
+\Macro{DeclareTOCStyleEntries}\ChangedAt{v3.26}{\Package{tocbasic}} can define
+an entire list of \PName{entry level}s in one command. Each entry level in the
+comma-separated \PName{entry-level list} is defined with the same \PName{style}
+and settings of the given \PName{option list}.%
\EndIndexGroup
@@ -1558,7 +1683,7 @@ settings of the given \PName{option list}.%
\Parameter{description}%
%\OParameter{initial code}%
\end{Declaration}
-\Macro{DeclareTOCEntryStyle}\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} is
+\Macro{DeclareTOCEntryStyle}\ChangedAt{v3.20}{\Package{tocbasic}} is
one of the most complex commands in \KOMAScript. It is therefore explicitly
intended for \LaTeX{} developers and not for ordinary \LaTeX{} users. It lets
you define new a \PName{style} for content-list entries. Usually, entries to
@@ -1592,20 +1717,33 @@ automatically. The value of the \Option{level} can be queried within the
\important{\Macro{\PName{entry level}tocdepth}}, for example, to compare it
with the \DescRef{\LabelBase.counter.tocdepth}\IndexCounter{tocdepth} counter.
-To define options for the attributes of the
-\PName{style} inside the \PName{initial code}, you can use the commands \Macro{DefineTOCEntryBooleanOption},
-\Macro{DefineTOCEntryCommandOption}, \Macro{DefineTOCEntryIfOption},
-\Macro{DefineTOCEntryLengthOption}, and \Macro{DefineTOCEntryNumberOption}.
-These commands each define an \PName{option} that, when called,
-defines a macro named \Macro{\PName{prefix}\PName{entry
- level}\PName{postfix}} set to the given value or to the
-\PName{default value} of the option. The
-\Macro{DefineTOCEntryIfOption} command is a somewhat special case. It defines \Macro{\PName{prefix}\PName{entry
- level}\PName{postfix}} as a command with two arguments. If the value passed to
-the option is one of the activation (true) values from \autoref{tab:truefalseswitch},
-\autopageref{tab:truefalseswitch}, the command expands to the first
-argument. If the value to the option is a deactivation (false) value, the command
-expands to the second argument.
+To define options for the attributes of the \PName{style} inside the
+\PName{initial code}, you can use the commands
+\Macro{DefineTOCEntryBooleanOption}, \Macro{DefineTOCEntryCommandOption},
+\Macro{DefineTOCEntryIfOption}, \Macro{DefineTOCEntryLengthOption}, and
+\Macro{DefineTOCEntryNumberOption}. These commands each define an
+\PName{option} that, when called, defines a macro named
+\Macro{\PName{prefix}\PName{entry level}\PName{postfix}} set to the given
+value or to the \PName{default value} of the option. The
+\Macro{DefineTOCEntryIfOption} command is a somewhat special case. It defines
+\Macro{\PName{prefix}\PName{entry level}\PName{postfix}} as a command with two
+arguments. If the value passed to the option is one of the activation (true)
+values from \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch},
+the command expands to the first argument. If the value to the option is a
+deactivation (false) value, the command expands to the second argument.
+
+In\ChangedAt{v3.27}{\Package{tocbasic}} addition to the usual options of the
+form \Option{\PName{key}=\PName{value}}, the five
+\Macro{DefineTOCEntry\dots Option} commands automatically define options of
+the form \Option{\PName{key}:=\PName{entry level}}. These copy the value of
+another \PName{entry level} if the value is stored in a macro with the same
+\PName{prefix} and \PName{postfix}. For the styles predefined by
+\Package{tocbasic}, this is the case for all options of the same name
+independent of the name of the style. The commands
+\Macro{DefineTOCEntryLengthOption} and \Macro{DefineTOCEntryNumberOption} also
+define options of the form \Option{\PName{key}:=\PName{value}}, which are used
+to add the new \PName{value} to the value already stored in
+\Macro{\PName{prefix}\PName{entry level}\PName{postfix}}.
The \PName{description} should be a brief message that describes the sense
of the option with some keywords. The \Package{tocbasic} package uses this text
@@ -1662,7 +1800,7 @@ mentioned here only for the sake of completeness.%
\begin{Declaration}
\Macro{CloneTOCEntryStyle}\Parameter{style}\Parameter{new style}%
\end{Declaration}
-With\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} this command you can clone
+With\ChangedAt{v3.20}{\Package{tocbasic}} this command you can clone
an existing \PName{style}. It defines a \PName{new style} with the same
attributes and settings as the existing \PName{style}. The package itself uses
\Macro{CloneTOCEntryStyle} to declare the \PValue{default} style as a clone of
@@ -1683,7 +1821,7 @@ of \PValue{section}, and \Class{scrartcl} declares it as a clone of
\Macro{TOCEntryStyleStartInitCode}\Parameter{style}%
\Parameter{initial code}
\end{Declaration}
-Every\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} TOC-entry style has an
+Every\ChangedAt{v3.20}{\Package{tocbasic}} TOC-entry style has an
initialisation code. This is used whenever a \PName{style} is assigned to an
TOC entry using \DescRef{\LabelBase.cmd.DeclareTOCEntryStyle}. This
\PName{initial code} should not have global side effects, because it is also
@@ -1718,7 +1856,7 @@ to define \PValue{section} as a modified clone of \PValue{tocline}.%
\Macro{LastTOCLevelWasSame}%
\Macro{LastTOCLevelWasLower}
\end{Declaration}
-At\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} the beginning of entries
+At\ChangedAt{v3.20}{\Package{tocbasic}} the beginning of entries
using the \PValue{tocline} style, \Package{tocbasic} executes one of these
three commands depending on \Macro{lastpenalty}. \Macro{LastTOCLevelWasHigher}
and \Macro{LastTOCLevelWasSame} used in vertical mode add
@@ -1736,7 +1874,7 @@ behaviour of single entry levels using the \PValue{onstartlowerlevel},
\begin{Declaration}
\Macro{TOCLineLeaderFill}\OParameter{leader}
\end{Declaration}
-This\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} command is intended to be
+This\ChangedAt{v3.20}{\Package{tocbasic}} command is intended to be
used as a value for the \Option{linefill} option of the \PName{tocline}
TOC-entry style. It creates a connection between the end of the entry text and
the entry's page number. You can specify the \PName{leader}, which is repeated
@@ -1925,7 +2063,7 @@ run.%
\Macro{tocbasic@DependOnPenaltyAndTOCLevel}\Parameter{entry level}%
\Macro{tocbasic@SetPenaltyByTOCLevel}\Parameter{entry level}
\end{Declaration}
-The\ChangedAt[2016/03]{v3.20}{\Package{tocbasic}} \PValue{tocline}
+The\ChangedAt{v3.20}{\Package{tocbasic}} \PValue{tocline}
content-list style (see \autoref{sec:tocbasic.tocstyle}) sets a
\Macro{penalty} at the end of each entry via
\Macro{tocbasic@SetPenaltyByTOCLevel} so that no page break can occur after an
@@ -2126,15 +2264,15 @@ cannot be set using \DescRef{maincls.cmd.KOMAoptions}\IndexCmd{KOMAoptions}!
You can find an overview of all available options in
\autoref{tab:tocbasic.DeclareNewTOC-options}.
-If\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}} the \Option{tocentrystyle}
+If\ChangedAt{v3.20}{\Package{tocbasic}} the \Option{tocentrystyle}
option is not used, the \PValue{default} style will be used if required. For
information about this style, see \autoref{sec:tocbasic.tocstyle}. If you do
not want to define a command for entries to the content list, you can use an
empty argument, i.\,e. \OptionValue{tocentrystyle}{} or
\OptionValue{tocentrystyle}{\PParameter{}}.
-Depending\ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
-\ChangedAt[2016/06]{v3.21}{\Package{tocbasic}} on the style of the entries to
+Depending\ChangedAt{v3.20}{\Package{tocbasic}}%
+\ChangedAt{v3.21}{\Package{tocbasic}} on the style of the entries to
the content list, you can set all valid attributes of the selected style as
part of the \PName{options}. To do so, you must add the prefix
\PValue{tocentry} to the names of the attributes given in
@@ -2167,6 +2305,10 @@ the styles.%
The \PName{commands} will be executed at the end of the floating or
non-floating environment.%
}%
+ \entry{\OptionVName{category}{string}}{%
+ \ChangedAt{v3.27}{\Package{tocbasic}}%
+ This option can be used as a synonym for \OptionVName{owner}{string}.%
+ }%
\entry{\OptionVName{counterwithin}{\LaTeX{} counter}}{%
If you define a new floating or non-floating environment, a new counter
\Counter{\PName{type}} will be created as well (see option
@@ -2201,8 +2343,8 @@ the styles.%
before.%
}%
\entry{\OptionVName{hang}{length}}{%
- \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
- \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}%
+ \ChangedAt{v3.20}{\Package{tocbasic}}%
+ \ChangedAt{v3.21}{\Package{tocbasic}}%
This option has been deprecated since \KOMAScript~3.20. Instead, the
amount of the hanging indent of entries to the content list\index{content
list>entry} depends on attributes of the TOC-entry style given by the
@@ -2214,8 +2356,8 @@ the styles.%
example, use \OptionValue{tocentrynumwidth}{2.3em}.%
}%
\entry{\OptionVName{indent}{length}}{%
- \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
- \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}%
+ \ChangedAt{v3.20}{\Package{tocbasic}}%
+ \ChangedAt{v3.21}{\Package{tocbasic}}%
This option has been deprecated since \KOMAScript~3.20. Instead, the
amount that entries to the content list\index{content list>entry} are
indented depends on attributes of the TOC-entry style given by the
@@ -2227,8 +2369,8 @@ the styles.%
use \OptionValue{tocentrynumwidth}{1.5em}.%
}%
\entry{\OptionVName{level}{number}}{%
- \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
- \ChangedAt[2015/12]{v3.21}{\Package{tocbasic}}%
+ \ChangedAt{v3.20}{\Package{tocbasic}}%
+ \ChangedAt{v3.21}{\Package{tocbasic}}%
This option has been deprecated since \KOMAScript~3.20. Instead, the level
of the entries to the content list\index{content list>entry} depends on
attributes of the TOC-entry style given by the \Option{tocentrystyle}
@@ -2289,7 +2431,7 @@ the styles.%
\autopageref{sec:tocbasic.tocstyle}.%
}%
\entry{\OptionVName{tocentry\PName{style-option}}{value}}{%
- \ChangedAt[2015/12]{v3.20}{\Package{tocbasic}}%
+ \ChangedAt{v3.20}{\Package{tocbasic}}%
Additional options depending on the \PName{TOC-entry style} given by
\Option{tocentrystyle}. See \autoref{sec:tocbasic.tocstyle},
\autopageref{sec:tocbasic.tocstyle} for additional information about
diff --git a/macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex b/macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex
index da2679cc7d..b72bd75cc5 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/typearea-experts.tex
@@ -1,6 +1,6 @@
% ======================================================================
% typearea-experts.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% typearea-experts.tex
-% Copyright (c) Markus Kohm, 2001-2018
+% Copyright (c) Markus Kohm, 2001-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -46,11 +46,11 @@
% ======================================================================
\KOMAProvidesFile{typearea-experts.tex}
- [$Date: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: typearea)]
\translator{Markus Kohm\and Gernot Hassenpflug\and Karl Hagen}
-% Date of the translated German file: 2018-01-31
+% Date of the translated German file: 2019-10-10
\chapter{Additional Information about the \Package{typearea} package}
\labelbase{typearea-experts}
diff --git a/macros/latex/contrib/koma-script/source-doc/english/typearea.tex b/macros/latex/contrib/koma-script/source-doc/english/typearea.tex
index 1985498be3..6ae976a096 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/typearea.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/typearea.tex
@@ -46,12 +46,12 @@
% ======================================================================
\KOMAProvidesFile{typearea.tex}%
- [$Date: 2019-01-15 08:29:44 +0100 (Tue, 15 Jan 2019) $
+ [$Date: 2019-10-10 10:04:30 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: typearea)]
\translator{Markus Kohm\and Gernot Hassenpflug\and Krickette Murabayashi\and
Karl Hagen}
-% Date of the translated German file: 2018-01-31
+% Date of the translated German file: 2019-10-10
\chapter{Calculating the Page Layout with \Package{typearea}}
\labelbase{typearea}