summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/source-doc/english/scrhack.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc/english/scrhack.tex')
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrhack.tex52
1 files changed, 47 insertions, 5 deletions
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