summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/doc/common-compatibility-de.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/koma-script/doc/common-compatibility-de.tex')
-rw-r--r--macros/latex/contrib/koma-script/doc/common-compatibility-de.tex182
1 files changed, 182 insertions, 0 deletions
diff --git a/macros/latex/contrib/koma-script/doc/common-compatibility-de.tex b/macros/latex/contrib/koma-script/doc/common-compatibility-de.tex
new file mode 100644
index 0000000000..3a8652febb
--- /dev/null
+++ b/macros/latex/contrib/koma-script/doc/common-compatibility-de.tex
@@ -0,0 +1,182 @@
+% ======================================================================
+% common-compatibility-de.tex
+% Copyright (c) Markus Kohm, 2001-2022
+%
+% This file is part of the LaTeX2e KOMA-Script bundle.
+%
+% This work may be distributed and/or modified under the conditions of
+% the LaTeX Project Public License, version 1.3c of the license.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3c or later is part of all distributions of LaTeX
+% version 2005/12/01 or later and of this work.
+%
+% This work has the LPPL maintenance status "author-maintained".
+%
+% The Current Maintainer and author of this work is Markus Kohm.
+%
+% This work consists of all files listed in MANIFEST.md.
+% ======================================================================
+%
+% Paragraphs that are common for several chapters of the KOMA-Script guide
+% Maintained by Markus Kohm
+%
+% ======================================================================
+
+\KOMAProvidesFile{common-compatibility-de.tex}
+ [$Date: 2022-06-05 12:40:11 +0200 (So, 05. Jun 2022) $
+ KOMA-Script guide (common paragraphs)]
+
+\section{Kompatibilität zu früheren Versionen von \KOMAScript}
+\seclabel{compatibilityOptions}
+\BeginIndexGroup
+\BeginIndex{}{Kompatibilität}
+
+\IfThisCommonFirstRun{}{%
+ Es gilt sinngemäß, was in
+ \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} geschrieben
+ wurde.\IfThisCommonLabelBase{scrlttr2}{ Allerdings existiert diese
+ Möglichkeit bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} bereits seit
+ Version~2.9t, während \Package{scrletter} sie nicht bietet, sondern
+ sozusagen immer von \OptionValue{version}{last} ausgeht.}{} Falls Sie also
+ \autoref{sec:\ThisCommonFirstLabelBase.compatibilityOptions} bereits gelesen
+ und verstanden haben, können Sie in
+ \autoref{sec:\ThisCommonLabelBase.compatibilityOptions.next} auf
+ \autopageref{sec:\ThisCommonLabelBase.compatibilityOptions.next}
+ fortfahren.%
+}
+
+\IfThisCommonLabelBaseOneOf{typearea,maincls,scrlttr2}{%
+ Wer seine Dokumente im Quellcode archiviert, legt in der Regel allergrößten
+ Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer wieder exakt
+ dasselbe Ergebnis erzielt wird. In einigen Fällen führen aber Verbesserungen
+ und Korrekturen \IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{an der
+ Klasse}{am Paket} zu Änderungen im Verhalten, inbesondere beim
+ Umbruch. Dies ist jedoch manchmal eher unerwünscht.%
+}{%
+ \IfThisCommonLabelBase{scrextend}{%
+% In einigen Fällen ist es so, dass Verbesserungen und Korrekturen am Paket
+% zu Änderungen im Verhalten, inbesondere beim Umbruch, führen. Dies ist
+% jedoch nicht immer erwünscht.%
+% Wer seine Dokumente im Quellcode archiviert, legt in der Regel
+% allergrößten Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer
+% wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen ist es aber
+% so, dass Verbesserungen und Korrekturen an der Klasse zu Änderungen im
+% Verhalten, inbesondere beim Umbruch, führen.%
+ }{%
+ \ThisCommonLabelBaseFailure
+% \IfThisCommonLabelBase{scrlttr2}{%
+% In einigen Fällen ist es so, dass Verbesserungen und Korrekturen an der
+% Klasse zu Änderungen im Verhalten, inbesondere beim Umbruch,
+% führen. Dies ist jedoch nicht immer erwünscht.%
+% }{}%
+ }%
+}%
+
+
+\begin{Declaration}
+ \OptionVName{version}{Wert}
+ \OptionValue{version}{first}
+ \OptionValue{version}{last}
+\end{Declaration}
+\IfThisCommonLabelBase{scrextend}{Bei }{Seit }%
+\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
+\ChangedAt{v2.9t}{\Class{scrlttr2}}%
+\ChangedAt{v3.01b}{\Package{typearea}}%
+\IfThisCommonLabelBase{typearea}{%
+ Version~3.01b besteht bei \Package{typearea} }{%
+ \IfThisCommonLabelBase{maincls}{%
+ Version~2.96a besteht bei \KOMAScript{} }{%
+ \IfThisCommonLabelBase{scrlttr2}{%
+ Version~2.9t besteht bei \Class{scrlttr2}\OnlyAt{\Class{scrlttr2}} }{%
+ \IfThisCommonLabelBase{scrextend}{\Package{scrextend} besteht }{%
+ \InteralCommonFileUsageError }%
+ }%
+ }%
+}%
+die Wahl, ob eine Quelldatei, soweit irgend möglich, auch zukünftig bei einem
+\LaTeX{}-Lauf zu exakt demselben Ergebnis führen soll oder ob sie jeweils
+entsprechend der Anpassungen der neusten
+Version\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{ der Klasse}{} zu setzen
+ist. Zu welcher Version Kompatibilität herzustellen ist, wird dabei über die
+Option \Option{version} festgelegt. Kompatibilität zur ältesten unterstützten
+\KOMAScript-Version kann mit
+\OptionValue{version}{first}\important{\OptionValue{version}{first}} oder
+\OptionValue{version}{2.9} oder \OptionValue{version}{2.9t} erreicht
+werden. Bei Angabe einer unbekannten Version als \PName{Wert} wird eine
+Warnung ausgegeben und sicherheitshalber \OptionValue{version}{first}
+angenommen.
+
+Mit \OptionValue{version}{last}\important{\OptionValue{version}{last}}%
+\textnote{Voreinstellung} kann die jeweils neuste Version ausgewählt
+werden. In diesem Fall wird also auf rückwirkende Kompatibilität
+verzichtet. Wird die Option ohne Wertangabe verwendet, so wird ebenfalls
+\PValue{last} angenommen. \ChangedAt{v3.01a}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}\and \Class{scrlttr2}\and
+ \Package{scrextend}}Dies entspricht auch der
+Voreinstellung\IfThisCommonLabelBase{scrextend}{}{, solange keine obsolete
+ Option verwendet wird}.
+
+\IfThisCommonLabelBase{scrextend}{% scrextend kennt keine obsoleten Optionen
+}{%
+ Bei\textnote{Achtung!} der Verwendung einer obsoleten Option von
+ \KOMAScript~2 setzt \KOMAScript~3 automatisch
+ \OptionValue{version}{first}. In der dabei ausgegebenen Warnung wird
+ erklärt, wie man diese Kompatibilitätsumschaltung verhindern
+ kann. Alternativ kann man auch nach der obsoleten Option selbst eine
+ abweichende Einstellung für Option \Option{version} wählen.%
+}
+
+Die Frage der Kompatibilität betrifft in erster Linie Fragen des
+Umbruchs. Neue Möglichkeiten, die sich nicht auf den Umbruch auswirken, sind
+auch dann verfügbar, wenn man per Option die Kompatibilität zu einer älteren
+Version ausgewählt hat. Die Option hat keine Auswirkungen auf
+Umbruchänderungen, die bei Verwendung einer neueren Version durch Beseitigung
+eindeutiger Fehler entstehen. Wer\textnote{Tipp!} auch im Fehlerfall
+unbedingte Umbruchkompatibilität benötigt, sollte stattdessen mit dem Dokument
+auch die verwendete \KOMAScript-Version archivieren.
+
+\IfThisCommonLabelBase{scrlttr2}{\begin{Example}
+ Die Beispielbriefe dieses Kapitels sollen alle Möglichkeiten nutzen, die in
+ der neusten Version von \KOMAScript{} zur Verfügung stehen. Dazu muss beim
+ Laden der Klasse die Kompatibilität entsprechend gesetzt werden:%
+ \lstinputcode[xleftmargin=1em,lastline=1]{letter-example-00-de.tex}%
+ \iftrue% Umbruchkorrektur
+ Hier wurde einfach mit dem symbolischen Wert \PValue{last} die neuste
+ Version gewählt.%
+ \else%
+ Um nicht bei jeder neuen Version eine neue Versionsnummer angeben zu
+ müssen, wurde hier die Möglichkeit des symbolischen Wertes \PValue{last}
+ gewählt.%
+ \fi
+\end{Example}}{}
+
+Es\textnote{Achtung!} ist zu beachten, dass die Option \Option{version} nach
+dem Laden %
+\IfThisCommonLabelBaseOneOf{maincls,scrlttr2}{der Klasse}{%
+ des Pakets \IfThisCommonLabelBase{typearea}{\Package{typearea}}{%
+ \IfThisCommonLabelBase{scrextend}{\Package{scrextend}}{%
+ \InternalCommonFileUsageError }%
+ }%
+} nicht mehr verändert werden kann. Das Setzen mit
+\DescRef{\ThisCommonLabelBase.cmd.KOMAoptions} oder
+\DescRef{\ThisCommonLabelBase.cmd.KOMAoption} ist
+% Umbruchkorrektur!!!!
+\IfThisCommonLabelBaseNotOneOf{maincls,scrlttr2,typearea}{für diese Option }{}%
+daher nicht vorgesehen.%
+%
+\EndIndexGroup
+%
+\EndIndexGroup
+
+\phantomsection
+\label{sec:\ThisCommonLabelBase.compatibilityOptions.end}
+\endinput
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: "scrguide-de.tex"
+%%% coding: utf-8
+%%% ispell-local-dictionary: "de_DE"
+%%% eval: (flyspell-mode 1)
+%%% End: