summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex197
1 files changed, 102 insertions, 95 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex
index 550cafe8918..3dbcdad259b 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex
@@ -40,13 +40,15 @@
%
% ----------------------------------------------------------------------
%
-% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind
+% Absaetze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind
% Verwaltet von Markus Kohm
%
% ======================================================================
-\ProvidesFile{common-1.tex}[2009/01/04 KOMA-Script guide (common paragraphs)]
-\translator{Gernot Hassenpflug}
+\ProvidesFile{common-1.tex}[2012/04/08 KOMA-Script guide (common paragraphs)]
+\translator{Markus Kohm\and Krickette Murabayashi}
+
+% Date of the translated German file: 2011/09/20
\makeatletter
\@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}%
@@ -56,115 +58,120 @@
\makeatother
-\section{Kompatibilität zu früheren Versionen von \KOMAScript}
+\section{Compatibility with Earlier Versions of \KOMAScript}
\label{sec:\csname label@base\endcsname.compatibilityOptions}
-\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi%
-\ifIgnoreThis%
-Es gilt sinngemäß, was in \autoref{sec:maincls.compatibilityOptions}
-geschrieben wurde. \IfCommon{scrlttr2}{Allerdings existiert diese Möglichkeit
- bei \Class{scrlttr2} bereits seit Version~2.9t}.
-\else
-\BeginIndex{}{Kompatibilität}
-
-\IfCommon{maincls}{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.}%
-\IfCommon{scrextend}{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.}%
-\IfCommon{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.}%
+\ifshortversion\IgnoreThisfalse\IfNotCommon{typearea}{\IgnoreThistrue}\fi%
+\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht typearea +
+
+It applies, mutatis mutandis, what is written in
+\autoref{sec:typearea.compatibilityOptions}\IfCommon{scrlttr2}{. However, this
+ feature exists at \Class{scrlttr2} since version~2.9t}.
+\else %------------------------------------------------------- nur typearea -
+\BeginIndex{}{Compatibility}
+\IfCommon{typearea}{Those who achieve their documents in source code set utmost
+ value to the fact that future \LaTeX{} runs will yield exactly the same
+ result. Nevertheless, in some cases improvement and bug corrections of
+ packages will result in changes of the behaviour and make-up. But sometimes
+ this is not wanted.}%
+\IfCommon{maincls}{Those who achieve their documents in source code set utmost
+ value to the fact that future \LaTeX{} runs will yield exactly the same
+ result. However, sometimes improvement and bug corrections of classes will result
+ in changes of the behaviour and make-up. But sometimes this is not wanted.}%
+\IfCommon{scrextend}{Those who achieve their documents in source code set
+ utmost value to the fact that future \LaTeX{} runs will yield exactly
+ the same result. In some cases improvement and bug corrections of packages
+ will result in changes of the behaviour and make-up. But sometimes this is
+ not wanted.}%
+\IfCommon{scrlttr2}{In some cases improvement and bug corrections of classes
+ will result in changes of the behaviour and make-up. But sometimes this is
+ not wanted.}%
\begin{Declaration}
- \KOption{version}\PName{Wert}\\
- \OptionValue{version}{first}\\
- \OptionValue{version}{last}
+ \KOption{version}\PName{value}\\
+ \XOptionValue{version}{first}\\
+ \XOptionValue{version}{last}
\end{Declaration}
\BeginIndex{Option}{version}%
-\BeginIndex{Option}{version~=\PName{Wert}}%
-\BeginIndex{Option}{version~=last}%
-\BeginIndex{Option}{version~=first}%
-\IfCommon{maincls}{\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}}Seit Version~2.96a besteht bei \KOMAScript\ }%
-\IfCommon{scrlttr2}{\ChangedAt{v2.9t}{Seit \Class{scrlttr2}} Version~2.9t
- besteht bei \Class{scrlttr2} }%
-\IfCommon{scrextend}{Bei \Package{scrextend} besteht }%
-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 jeweils
-entsprechend der Anpassungen der neusten Version der Klasse zu setzen ist. Zu
-welcher Version Kompatibilität herzustellen ist, wird dabei über die Option
-\Option{version} festgelegt. Voreingestellt ist Version~2.9t. Dasselbe
-Ergebnis kann mit
-% Umbruchkorrektur: Unterlängenproblem in listings!
-\begin{lstcode}[belowskip=\dp\strutbox]
- version=first
-\end{lstcode}
-oder
-\begin{lstcode}[belowskip=\dp\strutbox]
- version=2.9
-\end{lstcode}
-oder
-\begin{lstcode}[belowskip=\dp\strutbox]
- version=2.9t
-\end{lstcode}
-erreicht werden. Bei Angabe einer unbekannten Version als \PName{Wert} wird
-eine Warnung ausgegeben und sicherheitshalber \Option{version=}\PValue{first}
-angenommen. Mit
-\begin{lstcode}[belowskip=\dp\strutbox]
- version=last
-\end{lstcode}
-kann die jeweils neuste Version ausgewählt werden. In diesem Fall wird also
-auf zukünftige Kompatibilität verzichtet. Wird die Option ohne Wertangabe
-verwendet, so wird ebenfalls \PValue{last} angenommen.
-
-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 auch im Fehlerfall unbedingte Umbruchkompatibilität benötigt,
-sollte stattdessen mit dem Dokument auch die verwendete \KOMAScript-Version
-archivieren.
+\BeginIndex{Option}{version~=\PName{value}}%
+\BeginIndex{Option}{version~=\PValue{last}}%
+\BeginIndex{Option}{version~=\PValue{first}}%
+\IfNotCommon{scrextend}{Since }%
+\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
+\ChangedAt{v2.9t}{\Class{scrlttr2}}%
+\ChangedAt{v3.01b}{\Package{typearea}}%
+\IfCommon{typearea}{\ifshortversion %
+ version~2.96a of \KOMAScript, for \Class{scrlttr2} since
+ version~2.9t, and for \Package{typearea} since version~3.01b, %
+ \else%
+ version~3.01b of \Package{typearea} %
+ \fi%
+}%
+\IfCommon{maincls}{version~2.96a of \KOMAScript{} }%
+\IfCommon{scrlttr2}{version~2.9t of \Class{scrlttr2} }%
+\IfCommon{scrextend}{At \Package{scrextend} }%
+it's your choice if your source code should result in the same make-up at
+future \LaTeX{} runs or if you like to participate in all improvements of new
+releases\IfCommon{maincls}{ of the class}\IfCommon{scrlttr2}{ of the
+ class}. You may select the compatible version of \KOMAScript{} with option
+\Option{version}. Compatibility to the lowest supported \KOMAScript{}
+release may be achieved by
+\OptionValue{version}{first}\important{\OptionValue{version}{first}} or
+\OptionValue{version}{2.9} or \OptionValue{version}{2.9t}. Setting
+\PName{value} to an unknown release number will result in a warning message and
+selects \OptionValue{version}{first} for safety.
+
+With \OptionValue{version}{last} the most recent version will be selected at
+every \LaTeX{} run. Be warned, though, that using \OptionValue{version}{last}
+poses possibilities of compatibility issues for future \LaTeX{} runs. Option
+\Option{version} without any \PName{value} means the
+same. \ChangedAt{v3.01a}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}\and \Class{scrlttr2}\and \Package{scrextend}}This is the
+default behaviour as long as you don't use any deprecated options.
+
+If\textnote{Attention!} you use a deprecated option of \KOMAScript~2,
+\KOMAScript~3 will switch to \OptionValue{version}{first} automatically. This
+will also result in a warning message that explains how to prevent this
+switching. Alternatively you may select another adjustment using option
+\Option{version} with the wanted compatibility after the deprecated option.
+
+Compatibility is primarily make-up compatibility. New features not related to
+the mark-up will be available even if you switch compatibility to a version
+before first implementation of the feature. Option \Option{version} doesn't
+influence make-up changes that are motivated by bug fixes. If you need bug
+compatibility you should physically save the used \KOMAScript{} version
+together with your document.
\IfCommon{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:%
+ The letter examples of this chapter should use and show all the features
+ of the recent \KOMAScript{} release. To achieve this, we set the
+ corresponding compatibility:%
\lstinputcode[xleftmargin=1em,lastline=1]{letter-0.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
+ In this case the symbolic value \PValue{last} has been used to select the
+ latest version.%
\end{Example}}
-Es ist zu beachten, dass die Option \Option{version} nach dem Laden %
-\IfCommon{maincls}{der Klasse }%
-\IfCommon{scrlttr2}{der Klasse }%
-\IfCommon{scrextend}{des Pakets \Package{scrextend} }%
-nicht mehr verändert werden kann.%
-%
-\EndIndex{Option}{version~=\PName{Wert}}%
-\EndIndex{Option}{version~=first}%
-\EndIndex{Option}{version~=last}%
+Please note\textnote{Attention!} that you can't change option \Option{version}
+anymore after loading the %
+\IfCommon{maincls}{class}%
+\IfCommon{scrlttr2}{class}%
+\IfCommon{typearea}{package \Package{typearea}}%
+\IfCommon{scrextend}{package \Package{scrextend}}%
+. Therefore, the usage of option \Option{version} within the argument of
+\Macro{KOMAoptions} or \Macro{KOMAoption} is not recommended and will cause an
+error.%
+\EndIndex{Option}{version~=\PName{value}}%
+\EndIndex{Option}{version~=\PValue{first}}%
+\EndIndex{Option}{version~=\PValue{last}}%
\EndIndex{Option}{version}%
%
-\EndIndex{}{Kompatibilität}
+\EndIndex{}{Compatibility}
-\fi % IgnoreThis
+\fi % *************************************************** Ende nur typearea *
%%% Local Variables:
%%% mode: latex
-%%% coding: iso-latin-1
+%%% coding: us-ascii
%%% TeX-master: "../guide"
%%% End: